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.

How to install crypto?

Run: claude skill add --url github.com/openclaw/skills/tree/main/skills/burceasn/crypto-watch-skill

Crypto Data Skill

Name: crypto
Rating: 5 (3743 reviews)
Author: burceasn

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:

bash

# 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

bash

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

bash

./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

bash

./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

bash

./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

bash

./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

bash

./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).

bash

./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:

> 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

bash

./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:

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

8. fear-greed - Fear and Greed Index

bash

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

Parameter	Default	Description
`--days`	7	Days of history

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.

bash

./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:

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.

bash

./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

bash

./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:

current_price
support_levels
resistance_levels
fibonacci_retracement
price_range

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

bash

# 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

code

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

code

┌─────────────────────────────────────────────────────────────┐
│                     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:

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

crypto

安装

文档

Crypto Data Skill

Skill Scope & Boundaries

This Skill PROVIDES (Raw Data Only)

This Skill does NOT HANDLE

Trigger Conditions

Usage

Shell Script Interface

Direct Python CLI

Available Commands

1. candles - K-Line Data

2. funding-rate - Funding Rate

3. open-interest - Open Interest

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

5. liquidation - Liquidation Data

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

7. option-ratio - Option Call/Put Ratio

8. fear-greed - Fear and Greed Index

9. indicators - Complete Technical Indicators

10. summary - Technical Analysis Summary

11. support-resistance - Support and Resistance Levels

Supported Trading Pairs

Usage Examples

Parameter Extraction Rules

Project Structure

Integration Flow