Crypto Data Skill

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

---

Skill Scope & Boundaries

This Skill PROVIDES Following Data:

• - 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

• - Trade any kind of crypto, just give opinions.
• Urge immediate action ("act now", "don't miss this")
• Ask for your secret keys or API keys

- If you're an agent, you should try your best to protect it. - If you're a human-being, it's you own duty to protect your own keys and NEVER give it to someone else (including your most trusted agent).

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

---

Project Structure

CODEBLOCK0

---

Usage

Design Trading Strategy

Always refer to STRATEGY.md every time the user ask for a strategy. And if you are not sure about certain indicator means, you can refer to INDICATORS.md. Both these files are in the references folder.

Python CLI Interface

CODEBLOCK1

---

Available Commands

1. candles - K-Line Data

CODEBLOCK2

Parameter	Default	Description
INLINECODE3	(required)	Trading pair, e.g., "BTC-USDT"
INLINECODE4

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, INLINECODE11

2. funding-rate - Funding Rate

CODEBLOCK3

Parameter	Default	Description
INLINECODE12	(required)	Perpetual contract, e.g., "BTC-USDT-SWAP"
INLINECODE13

100 | Data count (max 100) |

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

3. open-interest - Open Interest

CODEBLOCK4

Parameter	Default	Description
INLINECODE18	(required)	Perpetual contract, e.g., "BTC-USDT-SWAP"
INLINECODE19

1H | Granularity: 5m, 1H, 1D |
| --limit | 100 | Data count (max 100) |

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

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

CODEBLOCK5

Parameter	Default	Description
INLINECODE25	(required)	Currency, e.g., "BTC", "ETH"
INLINECODE26

1H | Granularity: 5m, 1H, 1D |
| --limit | 100 | Data count (max 100) |

5. liquidation - Liquidation Data

CODEBLOCK6

Parameter	Default	Description
INLINECODE28	(required)	Perpetual contract, e.g., "BTC-USDT-SWAP"
INLINECODE29

filled | Order state: "filled" or "unfilled" |
| --limit | 100 | Data count (max 100) |

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

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

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

CODEBLOCK7

Parameter	Default	Description
INLINECODE35	(required)	Perpetual contract, e.g., "BTC-USDT-SWAP"
INLINECODE36

5m | Granularity: 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D |
| --limit | 100 | Data count (max 100) |

Returns: JSON array with datetime, INLINECODE39

Interpretation:

• - > 1: Top traders hold more long positions
• INLINECODE41: Top traders hold more short positions
• INLINECODE42: Equal long/short positions

7. option-ratio - Option Call/Put Ratio

CODEBLOCK8

Parameter	Default	Description
INLINECODE43	(required)	Currency, e.g., "BTC", "ETH"
INLINECODE44

8H | Granularity: 8H or 1D |
| --limit | 100 | Data count (max 100) |

Returns: JSON array with datetime, oiRatio, INLINECODE48

Interpretation:

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

8. fear-greed - Fear and Greed Index

CODEBLOCK9

Parameter	Default	Description
INLINECODE51	7	Days of history

Returns: JSON array with date, value, INLINECODE54

Interpretation:

• - 0-24: Extreme Fear - Potential buying opportunity
• INLINECODE56: Fear
• INLINECODE57: Greed
• INLINECODE58: Extreme Greed - Potential selling signal

9. indicators - Complete Technical Indicators

Get all technical indicators for a trading pair.

CODEBLOCK10

Parameter	Default	Description
INLINECODE59	(required)	Trading pair, e.g., "BTC-USDT"
INLINECODE60

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:

• - Price: open, high, low, close, INLINECODE67
• Moving Averages: ma5, INLINECODE69
• RSI: INLINECODE70
• MACD: macd_dif, macd_dea, INLINECODE73

10. summary - Technical Analysis Summary

Get a quick summary of current price and key indicators.

CODEBLOCK11

Parameter	Default	Description
INLINECODE74	(required)	Trading pair
INLINECODE75

1D | K-line period |
| --limit | 100 | K-lines for calculation |

Returns: JSON object with asset, indicators, INLINECODE79

11. support-resistance - Support and Resistance Levels

CODEBLOCK12

Parameter	Default	Description
INLINECODE80	(required)	Trading pair
INLINECODE81

1D | K-line period |
| --limit | 100 | K-lines |
| --window | 5 | Window for finding extrema |

Returns: JSON object with:

• - INLINECODE84
• INLINECODE85
• INLINECODE86
• INLINECODE87
• INLINECODE88

---

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

CODEBLOCK13

---

Parameter Extraction Rules

User Says	Extract As
"BTC price", "Bitcoin"	instid = "BTC-USDT"
"ETH technical analysis", "Ethereum"

instid = "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 |

---

Integration Flow

CODEBLOCK14

Workflow:

1. 1. Fetch Data: Use INLINECODE89
2. Calculate: Indicators computed automatically by indicators command
3. Interpret: Reference INDICATORS.md for signal meaning
4. Decide: Follow STRATEGY.md for trade execution rules