Crypto Data Skill

Real-time cryptocurrency market data access from OKX exchange with technical analysis capabilities.

Skill Scope & Boundaries

This Skill PROVIDES (Raw Data Only)

• K-line / Candlestick data
• Funding rate history
• Open interest snapshots
• Long/Short ratio data (account ratio)
• Top trader position ratio (position ratio of top 5% traders)
• Option call/put OI and volume ratio
• Fear and Greed Index
• Liquidation records

This Skill does NOT HANDLE

• Signal interpretation → Refer to indicators.md in references folder.
• Trade decisions → Handled by Agent policy (AGENTS.md)
• Risk management → Handled by Agent policy (AGENTS.md)

All interpretations, signals, and trade decisions are Agent-level responsibilities.

Trigger Conditions

MUST load this Skill when:

• Querying any crypto price (BTC, ETH, BNB, ZEC, SOL, XAU)
• Technical analysis requests
• Funding rate / Open interest / Long-short ratio queries
• Market sentiment analysis

Usage

Shell Script Interface

Use crypto.sh to fetch data:

# Get K-line data
./crypto.sh candles BTC-USDT --bar 1H --limit 100

# Get funding rate
./crypto.sh funding-rate BTC-USDT-SWAP --limit 50

# Get technical indicators
./crypto.sh indicators ETH-USDT --bar 4H --last-n 5

# Get Fear and Greed Index
./crypto.sh fear-greed --days 30

Direct Python CLI

python scripts/cli.py candles BTC-USDT --bar 1H --limit 100
python scripts/cli.py indicators ETH-USDT --bar 4H --last-n 10

Available Commands

1. candles - K-Line Data

./crypto.sh candles <inst_id> [--bar BAR] [--limit LIMIT]

Returns: JSON array with datetime, open, high, low, close, vol

2. funding-rate - Funding Rate

./crypto.sh funding-rate <inst_id> [--limit LIMIT]

Returns: JSON array with datetime, fundingRate, realizedRate, type

3. open-interest - Open Interest

./crypto.sh open-interest <inst_id> [--period PERIOD] [--limit LIMIT]

Returns: JSON array with datetime, oiCcy, oiUsd, type

4. long-short-ratio - Long/Short Ratio

./crypto.sh long-short-ratio <ccy> [--period PERIOD] [--limit LIMIT]

5. liquidation - Liquidation Data

./crypto.sh liquidation <inst_id> [--state STATE] [--limit LIMIT]

Returns: datetime, side (sell=long liquidated, buy=short liquidated), bkPx, sz

6. top-trader-ratio - Top Trader Position Ratio

Get the long/short position ratio of elite traders (top 5% by position value).

./crypto.sh top-trader-ratio <inst_id> [--period PERIOD] [--limit LIMIT]

Returns: JSON array with datetime, longShortPosRatio

Interpretation:

• > 1: Top traders hold more long positions
• < 1: Top traders hold more short positions
• = 1: Equal long/short positions

7. option-ratio - Option Call/Put Ratio

./crypto.sh option-ratio <ccy> [--period PERIOD]

Returns: JSON array with datetime, oiRatio, volRatio

Interpretation:

• oiRatio > 1: More call options held (bullish sentiment)
• oiRatio < 1: More put options held (bearish sentiment)

8. fear-greed - Fear and Greed Index

./crypto.sh fear-greed [--days DAYS]

Returns: JSON array with date, value, value_classification

Interpretation:

• 0-24: Extreme Fear - Potential buying opportunity
• 25-49: Fear
• 50-74: Greed
• 75-100: Extreme Greed - Potential selling signal

9. indicators - Complete Technical Indicators

Get all technical indicators for a trading pair.

./crypto.sh indicators <inst_id> [--bar BAR] [--limit LIMIT] [--last-n N]

Returns: JSON array with columns:

• Price: open, high, low, close, volume
• Moving Averages: ma5, ma10
• RSI: rsi14
• MACD: macd_dif, macd_dea, macd_hist

10. summary - Technical Analysis Summary

Get a quick summary of current price and key indicators.

./crypto.sh summary <inst_id> [--bar BAR] [--limit LIMIT]

Returns: JSON object with asset, indicators, data_summary

11. support-resistance - Support and Resistance Levels

./crypto.sh support-resistance <inst_id> [--bar BAR] [--limit LIMIT] [--window N]

Returns: JSON object with:

• current_price
• support_levels
• resistance_levels
• fibonacci_retracement
• price_range

Supported Trading Pairs

Usage Examples

# Get BTC 1-hour K-lines
./crypto.sh candles BTC-USDT --bar 1H --limit 100

# Get ETH funding rate
./crypto.sh funding-rate ETH-USDT-SWAP --limit 50

# Get BTC liquidation data
./crypto.sh liquidation BTC-USDT-SWAP --state filled --limit 100

# Get top trader position ratio
./crypto.sh top-trader-ratio BTC-USDT-SWAP --period 1H --limit 24

# Get option call/put ratio
./crypto.sh option-ratio BTC --period 8H

# Get fear and greed index
./crypto.sh fear-greed --days 30

# Get technical indicators
./crypto.sh indicators BTC-USDT --bar 4H --last-n 5

# Get support and resistance levels
./crypto.sh support-resistance ETH-USDT --bar 1D

Parameter Extraction Rules

Project Structure

crypto-skill/
├── crypto.sh                   # Shell entry point
├── SKILL.md                    # This file
├── requirements.txt            # Python dependencies
│
├── scripts/
│   ├── cli.py                  # CLI implementation
│   ├── crypto_data.py          # OKX API wrapper
│   └── technical_analysis.py   # TA indicator engine
│
└── references/
    └── indicators.md           # Technical indicator guide

Integration Flow

┌─────────────────────────────────────────────────────────────┐
│                     SKILL.md (You Are Here)                 │
├─────────────────────────────────────────────────────────────┤
│  1. crypto.sh / cli.py    →  Fetch raw market data          │
│  2. technical_analysis.py  →  Calculate indicators          │
│  3. references/indicators.md →  Signal interpretation       │
│  4. AGENTS.md              →  Trade decision policy         │
└─────────────────────────────────────────────────────────────┘

Workflow:

1. Fetch Data: Use ./crypto.sh <command> or python scripts/cli.py
2. Calculate: Indicators computed automatically by indicators command
3. Interpret: Reference indicators.md for signal meaning
4. Decide: Follow AGENTS.md for trade execution rules