Tracking Crypto Derivatives
Overview
Aggregate funding rates, open interest, liquidations, and options data across CEX and DEX derivatives exchanges to produce actionable trading insights.
Supported Markets: Perpetual Swaps (Binance, Bybit, OKX, Deribit, BitMEX), Quarterly Futures, Options (Deribit, OKX, Bybit), DEX Perpetuals (dYdX, GMX, Drift Protocol).
Prerequisites
- Python 3.8+ installed
- Network access to exchange APIs
- Optional: API keys for higher rate limits
- Understanding of derivatives concepts (funding, OI, basis)
Instructions
Check funding rates across exchanges to identify sentiment and arbitrage opportunities:
python derivatives_tracker.py funding BTC
python derivatives_tracker.py funding BTC ETH SOL
python derivatives_tracker.py funding BTC --history 7d
- Positive funding (>0.01%): Longs pay shorts, bullish sentiment
- Negative funding (<-0.01%): Shorts pay longs, bearish sentiment
- Extreme funding (>0.1%): Potential contrarian opportunity
Analyze open interest to gauge market positioning and trend strength:
python derivatives_tracker.py oi BTC
python derivatives_tracker.py oi BTC --changes
python derivatives_tracker.py oi BTC --divergence
- Rising OI + Rising Price = strong bullish trend
- Rising OI + Falling Price = strong bearish trend
- Falling OI + Rising Price = short covering rally
- Falling OI + Falling Price = long liquidations
Monitor liquidations to find support/resistance clusters:
python derivatives_tracker.py liquidations BTC
python derivatives_tracker.py liquidations BTC --recent
python derivatives_tracker.py liquidations BTC --min-size 100000 # 100000 = minimum USD liquidation size filter
Analyze options market for IV, put/call ratio, and max pain:
python derivatives_tracker.py options BTC
python derivatives_tracker.py options BTC --pcr
python derivatives_tracker.py options BTC --expiry 2025-01-31 # 2025 = target expiry year
Calculate basis for spot-futures arbitrage opportunities:
python derivatives_tracker.py basis BTC
python derivatives_tracker.py basis BTC --quarterly
python derivatives_tracker.py basis --all
Run full dashboard for comprehensive derivatives overview:
python derivatives_tracker.py dashboard BTC
python derivatives_tracker.py dashboard BTC ETH SOL
python derivatives_tracker.py dashboard BTC --output json
Output
The skill produces structured reports per market type:
- Funding Rate Report: Current, 24h avg, 7d avg rates per exchange with annualized yield and sentiment
- Open Interest Report: OI per exchange with 24h/7d changes, share %, and long/short ratio
- Liquidation Heatmap: Long/short liquidation clusters by price level with USD density
- Options Overview: Put/call ratio, IV rank, max pain, and large flow alerts
- Basis Report: Spot-perp and quarterly basis with annualized carry rates
See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed output format examples.
Error Handling
| Error |
Cause |
Fix |
ERR_RATE_LIMIT |
Too many API requests |
Reduce frequency or add API key |
ERR_EXCHANGE_DOWN |
Exchange API unavailable |
Try alternative exchange |
ERR_SYMBOL_INVALID |
Wrong symbol format |
Use BTC, ETH (not BTCUSDT) |
Examples
Morning derivatives check - Scan funding, OI, and liquidations for top assets:
python derivatives_tracker.py dashboard BTC ETH SOL
Funding rate arbitrage - Alert when funding exceeds threshold for cash-and-carry:
python derivatives_tracker.py funding BTC --alert-threshold 0.08
Pre-expiry options analysis - Check max pain and IV before Friday expiry:
python derivatives_tracker.py options BTC --expiry friday
Basis trading scan - Find all pairs with annualized yield above 5%:
python derivatives_tracker.py basis --all --min-yield 5 # 5 = minimum annualized yield %
Resources
- Coinglass: Aggregated derivatives data
- Exchange APIs: Binance, Bybit, OKX, Deribit
- The Graph: DEX perpetuals data
${CLAUDE_SKILL_DIR}/references/implementation.md - Detailed output formats, options/basis guides, key concepts
1---2name: tracking-crypto-derivatives3description: Track cryptocurrency futures, options, and perpetual swaps with funding rates, open interest, liquidations, and comprehensive derivatives market analysis. Use when monitoring derivatives markets, analyzing funding rates, tracking open interest, finding liquidation levels, or researching options flow. Trigger with phrases like "funding rate", "open interest", "perpetual swap", "futures basis", "liquidation levels", "options flow", "put call ratio", "derivatives analysis", or "BTC perps".4license: MIT5---6# Tracking Crypto Derivatives
7
8## Overview
9
10Aggregate funding rates, open interest, liquidations, and options data across CEX and DEX derivatives exchanges to produce actionable trading insights.
11
12**Supported Markets**: Perpetual Swaps (Binance, Bybit, OKX, Deribit, BitMEX), Quarterly Futures, Options (Deribit, OKX, Bybit), DEX Perpetuals (dYdX, GMX, Drift Protocol).
13
14## Prerequisites
15
16- Python 3.8+ installed
17- Network access to exchange APIs
18- Optional: API keys for higher rate limits
19- Understanding of derivatives concepts (funding, OI, basis)
20
21## Instructions
22
231. **Check funding rates** across exchanges to identify sentiment and arbitrage opportunities:
24
25 ```bash
26 python derivatives_tracker.py funding BTC
27 python derivatives_tracker.py funding BTC ETH SOL
28 python derivatives_tracker.py funding BTC --history 7d
29 ```
30
31 - Positive funding (>0.01%): Longs pay shorts, bullish sentiment
32 - Negative funding (<-0.01%): Shorts pay longs, bearish sentiment
33 - Extreme funding (>0.1%): Potential contrarian opportunity
34
352. **Analyze open interest** to gauge market positioning and trend strength:
36
37 ```bash
38 python derivatives_tracker.py oi BTC
39 python derivatives_tracker.py oi BTC --changes
40 python derivatives_tracker.py oi BTC --divergence
41 ```
42
43 - Rising OI + Rising Price = strong bullish trend
44 - Rising OI + Falling Price = strong bearish trend
45 - Falling OI + Rising Price = short covering rally
46 - Falling OI + Falling Price = long liquidations
47
483. **Monitor liquidations** to find support/resistance clusters:
49
50 ```bash
51 python derivatives_tracker.py liquidations BTC
52 python derivatives_tracker.py liquidations BTC --recent
53 python derivatives_tracker.py liquidations BTC --min-size 100000 # 100000 = minimum USD liquidation size filter
54 ```
55
564. **Analyze options market** for IV, put/call ratio, and max pain:
57
58 ```bash
59 python derivatives_tracker.py options BTC
60 python derivatives_tracker.py options BTC --pcr
61 python derivatives_tracker.py options BTC --expiry 2025-01-31 # 2025 = target expiry year
62 ```
63
645. **Calculate basis** for spot-futures arbitrage opportunities:
65
66 ```bash
67 python derivatives_tracker.py basis BTC
68 python derivatives_tracker.py basis BTC --quarterly
69 python derivatives_tracker.py basis --all
70 ```
71
726. **Run full dashboard** for comprehensive derivatives overview:
73
74 ```bash
75 python derivatives_tracker.py dashboard BTC
76 python derivatives_tracker.py dashboard BTC ETH SOL
77 python derivatives_tracker.py dashboard BTC --output json
78 ```
79
80## Output
81
82The skill produces structured reports per market type:
83
84- **Funding Rate Report**: Current, 24h avg, 7d avg rates per exchange with annualized yield and sentiment
85- **Open Interest Report**: OI per exchange with 24h/7d changes, share %, and long/short ratio
86- **Liquidation Heatmap**: Long/short liquidation clusters by price level with USD density
87- **Options Overview**: Put/call ratio, IV rank, max pain, and large flow alerts
88- **Basis Report**: Spot-perp and quarterly basis with annualized carry rates
89
90See `${CLAUDE_SKILL_DIR}/references/implementation.md` for detailed output format examples.
91
92## Error Handling
93
94| Error | Cause | Fix |
95|-------|-------|-----|
96| `ERR_RATE_LIMIT` | Too many API requests | Reduce frequency or add API key |
97| `ERR_EXCHANGE_DOWN` | Exchange API unavailable | Try alternative exchange |
98| `ERR_SYMBOL_INVALID` | Wrong symbol format | Use BTC, ETH (not BTCUSDT) |
99
100## Examples
101
102**Morning derivatives check** - Scan funding, OI, and liquidations for top assets:
103
104```bash
105python derivatives_tracker.py dashboard BTC ETH SOL
106```
107
108**Funding rate arbitrage** - Alert when funding exceeds threshold for cash-and-carry:
109
110```bash
111python derivatives_tracker.py funding BTC --alert-threshold 0.08
112```
113
114**Pre-expiry options analysis** - Check max pain and IV before Friday expiry:
115
116```bash
117python derivatives_tracker.py options BTC --expiry friday
118```
119
120**Basis trading scan** - Find all pairs with annualized yield above 5%:
121
122```bash
123python derivatives_tracker.py basis --all --min-yield 5 # 5 = minimum annualized yield %
124```
125
126## Resources
127
128- **Coinglass**: Aggregated derivatives data
129- **Exchange APIs**: Binance, Bybit, OKX, Deribit
130- **The Graph**: DEX perpetuals data
131- `${CLAUDE_SKILL_DIR}/references/implementation.md` - Detailed output formats, options/basis guides, key concepts
gabrielmoreira