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

crypto-skill/
├── 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
    └── STRATEGY.md             # Trading strategy guidelines

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

# Get K-line data
python scripts/cli.py candles BTC-USDT --bar 1H --limit 100

# Get funding rate
python scripts/cli.py funding-rate BTC-USDT-SWAP --limit 50

# Get technical indicators
python scripts/cli.py indicators ETH-USDT --bar 4H --last-n 5

# Get Fear and Greed Index
python scripts/cli.py fear-greed --days 30

Available Commands

1. candles - K-Line Data

python scripts/cli.py candles <inst_id> [--bar BAR] [--limit LIMIT]

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

2. funding-rate - Funding Rate

python scripts/cli.py funding-rate <inst_id> [--limit LIMIT]