crypto-watch-skill OpenClaw Skill

Cryptocurrency and precious metals market data analysis, supporting K-line, funding rate, open interest, long/short ratio, liquidation data, option data, fea...

v1.0.1 Recently Updated Updated 1 wk ago

Installation

clawhub install crypto-watch-skill

Requires npm i -g clawhub

View on ClawHub Download .zip

153

Downloads

0

Stars

0

current installs

0 all-time

2

Versions

EU-Hosted Inference API

Power your OpenClaw skills with
the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

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]

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

python scripts/cli.py 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

python scripts/cli.py 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

python scripts/cli.py 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

python scripts/cli.py 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).

            python scripts/cli.py 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

python scripts/cli.py option-ratio <ccy> [--period PERIOD] [--limit LIMIT]

Parameter	Default	Description
`ccy`	(required)	Currency, e.g., "BTC", "ETH"
`--period`	8H	Granularity: 8H or 1D
`--limit`	100	Data count (max 100)

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

python scripts/cli.py 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.

            python scripts/cli.py 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.

python scripts/cli.py 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

            python scripts/cli.py 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

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

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

# Get BTC liquidation data
python scripts/cli.py liquidation BTC-USDT-SWAP --state filled --limit 100

# Get top trader position ratio
python scripts/cli.py top-trader-ratio BTC-USDT-SWAP --period 1H --limit 24

# Get option call/put ratio
python scripts/cli.py option-ratio BTC --period 8H --limit 10

# Get fear and greed index
python scripts/cli.py fear-greed --days 30

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

# Get support and resistance levels
python scripts/cli.py 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

Integration Flow

            ┌─────────────────────────────────────────────────────────────┐
│                     SKILL.md (You Are Here)                 │
├─────────────────────────────────────────────────────────────┤
│  1. scripts/cli.py     →  Fetch raw market data and caculate indicators│
│  2. references/INDICATORS.md →  Signal interpretation       │
│  3. references/STRATEGY.md  →  Trade decision policy        │
└─────────────────────────────────────────────────────────────┘
          

Workflow:

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

Statistics

Downloads 153

Stars 0

Current installs 0

All-time installs 0

Versions 2

Comments 0

Created Mar 18, 2026

Updated Mar 31, 2026

Author

burceasn

@burceasn

Latest Changes

v1.0.1 · Mar 31, 2026

- Renamed skill from "crypto" to "crypto-skill". - Migrated from shell script (`crypto.sh`) interface to Python CLI (`python scripts/cli.py`). - Added documentation and references for technical indicators and trading strategies (`INDICATORS.md`, `STRATEGY.md`). - Updated structure and instructions, clarifying boundaries and responsibilities for agents versus end-users. - Removed old shell script files and updated available commands and usage examples for Python-based usage.

Quick Install

clawhub install crypto-watch-skill

Related Skills

Other popular skills you might find useful.

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

76.2k 286 v0.1.0

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

33.1k 46 v1.0.1

Code

Iván

Coding workflow with planning, implementation, verification, and testing for clean software development.

19.2k 37 v1.0.4

Agent Browser - Stagehand

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

6.5k 4 v1.0.0

Browse all skills →

Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing

crypto-watch-skill OpenClaw Skill

Power your OpenClaw skills with the best open-source models.

Crypto Data Skill

Skill Scope & Boundaries

This Skill PROVIDES Following Data:

This Skill does NOT HANDLE

Trigger Conditions

Project Structure

Usage

Design Trading Strategy

Python CLI Interface

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

Integration Flow

Statistics

Author

Latest Changes

Related Skills

Agent Browser

Browser Automation

Code

Agent Browser - Stagehand

Chat with 100+ AI Models in one App.

Power your OpenClaw skills with
the best open-source models.