Crypto Data Skill

---

name: crypto

description: Cryptocurrency and precious metals market data analysis, supporting K-line, funding rate, open interest, long/short ratio, liquidation data, option data, fear and greed index for digital assets including Bitcoin, Ethereum, BNB, ZEC, SOL, and Gold. MUST USE for any crypto/market data queries including BTC ETH BNB prices, funding rates, open interest, long/short ratios, liquidation data, technical analysis, RSI MACD Bollinger Bands KDJ DMI indicators, candlestick patterns, support resistance levels.

---

# 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)

This Skill does NOT HANDLE

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

---

Trigger Conditions

**MUST load this Skill when:**

---

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]

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Trading pair, e.g., "BTC-USDT" |

| `--bar` | 1H | Period: 1m, 5m, 15m, 30m, 1H, 4H, 1D, 1W |

| `--limit` | 100 | Data count (max 100) |

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

2. funding-rate - Funding Rate

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Perpetual contract, e.g., "BTC-USDT-SWAP" |

| `--limit` | 100 | Data count (max 100) |

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

3. open-interest - Open Interest

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Perpetual contract, e.g., "BTC-USDT-SWAP" |

| `--period` | 1H | Granularity: 5m, 1H, 1D |

| `--limit` | 100 | Data count (max 100) |

**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]

| Parameter | Default | Description |

|-----------|---------|-------------|

| `ccy` | (required) | Currency, e.g., "BTC", "ETH" |

| `--period` | 1H | Granularity: 5m, 1H, 1D |

| `--limit` | 100 | Data count (max 100) |

5. liquidation - Liquidation Data

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Perpetual contract, e.g., "BTC-USDT-SWAP" |

| `--state` | filled | Order state: "filled" or "unfilled" |

| `--limit` | 100 | Data count (max 100) |

**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]

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Perpetual contract, e.g., "BTC-USDT-SWAP" |

| `--period` | 5m | Granularity: 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D |

| `--limit` | 100 | Data count (max 100) |

**Returns**: JSON array with `datetime`, `longShortPosRatio`

**Interpretation**:

7. option-ratio - Option Call/Put Ratio

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `ccy` | (required) | Currency, e.g., "BTC", "ETH" |

| `--period` | 8H | Granularity: 8H or 1D |

**Returns**: JSON array with `datetime`, `oiRatio`, `volRatio`

**Interpretation**:

8. fear-greed - Fear and Greed Index

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `--days` | 7 | Days of history |

**Returns**: JSON array with `date`, `value`, `value_classification`

**Interpretation**:

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]

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Trading pair, e.g., "BTC-USDT" |

| `--bar` | 1D | K-line period |

| `--limit` | 100 | K-lines to fetch (max 100) |

| `--last-n` | 10 | Return only latest N rows (0 = all) |

**Returns**: JSON array with columns:

10. summary - Technical Analysis Summary

Get a quick summary of current price and key indicators.

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

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Trading pair |

| `--bar` | 1D | K-line period |

| `--limit` | 100 | K-lines for calculation |

**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]

| Parameter | Default | Description |

|-----------|---------|-------------|

| `inst_id` | (required) | Trading pair |

| `--bar` | 1D | K-line period |

| `--limit` | 100 | K-lines |

| `--window` | 5 | Window for finding extrema |

**Returns**: JSON object with:

---

Supported Trading Pairs

| Code | Spot | Perpetual Contract |

|------|------|-------------------|

| BTC | BTC-USDT | BTC-USDT-SWAP |

| ETH | ETH-USDT | ETH-USDT-SWAP |

| BNB | BNB-USDT | BNB-USDT-SWAP |

| ZEC | ZEC-USDT | ZEC-USDT-SWAP |

| SOL | SOL-USDT | SOL-USDT-SWAP |

| XAU | - | XAU-USDT-SWAP |

---

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

| User Says | Extract As |

|-----------|------------|

| "BTC price", "Bitcoin" | inst_id = "BTC-USDT" |

| "ETH technical analysis", "Ethereum" | inst_id = "ETH-USDT" |

| "1-hour timeframe", "hourly chart" | bar = "1H" |

| "4-hour", "4H" | bar = "4H" |

| "daily chart", "daily level" | bar = "1D" |

| "weekly chart" | bar = "1W" |

| "funding rate", "funding" | Use funding-rate with SWAP contract |

| "open interest", "OI" | Use open-interest with SWAP contract |

| "long/short ratio" | Use long-short-ratio with CCY |

| "elite positions", "whale positions" | Use top-trader-ratio with SWAP |

| "option ratio", "call/put" | Use option-ratio with CCY |

| "fear and greed", "sentiment index" | Use fear-greed |

---

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