jeremylongshore/tons-of-skills-marketplace / plugins/crypto/crypto-derivatives-tracker/skills/tracking-crypto-derivatives
tracking-crypto-derivatives
VerifiedResearch crypto perpetual swaps, dated futures and options from live public exchange data: funding rates, open interest, basis, liquidations, put/call ratios and max pain. Read-only, no API keys. Use when checking funding across exchanges, comparing open interest, reading the futures term structure, reviewing recent liquidations, or summarizing the options market for BTC or ETH. Trigger with phrases like "funding rate", "open interest", "perpetual swap", "futures basis", "liquidations", "put call ratio", "max pain", "derivatives analysis", or "BTC perps".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 2.7 KB |
| PRD.md | markdown | 2.7 KB |
| SKILL.md | skill md | 6.9 KB |
| assets/demo-recording.json | config | 187.6 KB |
| references/errors.md | markdown | 2.5 KB |
| references/examples.md | markdown | 17.4 KB |
| references/implementation.md | markdown | 4.8 KB |
| scripts/basis_data.py | script | 4.5 KB |
| scripts/derivatives_tracker.py | script | 25.0 KB |
| scripts/http_client.py | script | 6.4 KB |
| scripts/liquidations.py | script | 4.0 KB |
| scripts/options_data.py | script | 9.2 KB |
| scripts/perps.py | script | 17.6 KB |
| scripts/record_demo.py | script | 3.3 KB |
| tests/fixtures/binance-bybit-recording.json | config | 12.8 KB |
| tests/test_derivatives_tracker.py | script | 10.0 KB |
references/examples.md
View on GitHub# Examples
Real output, captured live from a US network on 2026-10-25 16:14 UTC. Binance and Bybit refuse US connections, so they appear under **Unavailable**; from other regions they appear in the tables. Figures change every minute; these are a record of format, not current values.
## `derivatives_tracker.py funding BTC`
```text
========================================================================
FUNDING BTC
Live public data fetched 2026-10-25 16:14 UTC
========================================================================
BTC perpetual funding
Venue Instrument Rate Every 8h equiv Annual Next
------------------------------------------------------------------------------------
kraken PF_XBTUSD +0.0015% 1h +0.0119% +13.08% 0h 45m
kucoin XBTUSDTM +0.0100% 8h +0.0100% +10.95% 7h 45m
gate BTC_USDT +0.0068% 8h +0.0068% +7.45% 7h 45m
hyperliquid BTC +0.0008% 1h +0.0068% +7.43% 0h 45m
okx BTC-USDT-SWAP +0.0055% 8h +0.0055% +5.99% 7h 45m
deribit BTC-PERPETUAL +0.0035% 8h +0.0035% +3.85% continuous
dydx BTC-USD -0.0000% 1h -0.0004% -0.40% 0h 45m
------------------------------------------------------------------------------------
Mean 8h equivalent: +0.0063% Median: +0.0068%
Weighted by open interest: +0.0066%
Highest: kraken +0.0119% Lowest: dydx -0.0004% Spread: 0.0123%
Of 7 venues, funding is positive on 6, negative on 1.
Unavailable:
BTC binance: refused from this network (HTTP 451, region restriction)
BTC bybit: refused from this network (HTTP 403, likely a region restriction)
Positive funding: longs pay shorts. Annual figures are simple (rate x periods per year).
Sources:
https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP
https://www.deribit.com/api/v2/public/ticker?instrument_name=BTC-PERPETUAL
https://api.hyperliquid.xyz/info metaAndAssetCtxs
https://futures.kraken.com/derivatives/api/v3/tickers/PF_XBTUSD
https://api-futures.kucoin.com/api/v1/contracts/XBTUSDTM
https://api.gateio.ws/api/v4/futures/usdt/contracts/BTC_USDT
https://indexer.dydx.trade/v4/perpetualMarkets?ticker=BTC-USD
Research output only. Not financial advice. This tool places no trades.
```
## `derivatives_tracker.py oi BTC`
```text
========================================================================
OI BTC
Live public data fetched 2026-10-25 16:15 UTC
========================================================================
BTC perpetual open interest (one side)
Venue Coins USD Share 24h chg Accts long
----------------------------------------------------------------------
hyperliquid 42,229.99 $3.40B 34.2% n/a n/a
okx 30,080.47 $2.42B 24.3% -1.30% 67.2%
gate 27,817.61 $2.24B 22.5% n/a n/a
deribit 10,454.78 $841.90M 8.5% n/a n/a
kucoin 10,151.41 $818.14M 8.2% n/a n/a
kraken 2,610.71 $210.18M 2.1% n/a n/a
dydx 209.95 $16.91M 0.2% n/a n/a
----------------------------------------------------------------------
Total across 7 venues: $9.95B
24h change is measured in coins, so price moves do not count. n/a: the venue
publishes no hourly history (or account ratio) for this instrument.
Unavailable:
binance: refused from this network (HTTP 451, region restriction)
bybit: refused from this network (HTTP 403, likely a region restriction)
binance (24h history): refused from this network (HTTP 451, region restriction)
bybit (24h history): refused from this network (HTTP 403, likely a region restriction)
binance (account ratio): refused from this network (HTTP 451, region restriction)
bybit (account ratio): refused from this network (HTTP 403, likely a region restriction)
Sources:
https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP
https://www.deribit.com/api/v2/public/ticker?instrument_name=BTC-PERPETUAL
https://api.hyperliquid.xyz/info metaAndAssetCtxs
https://futures.kraken.com/derivatives/api/v3/tickers/PF_XBTUSD
https://api-futures.kucoin.com/api/v1/contracts/XBTUSDTM
https://api.gateio.ws/api/v4/futures/usdt/contracts/BTC_USDT
https://indexer.dydx.trade/v4/perpetualMarkets?ticker=BTC-USD
https://www.okx.com/api/v5/rubik/stat/contracts/open-interest-history?instId=BTC-USDT-SWAP&period=1H&limit=25
https://www.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio-contract?instId=BTC-USDT-SWAP&period=1H&limit=1
Research output only. Not financial advice. This tool places no trades.
```
## `derivatives_tracker.py basis ETH`
```text
========================================================================
BASIS ETH
Live public data fetched 2026-10-25 16:15 UTC
========================================================================
ETH dated-futures basis against each venue's index
Venue Instrument Days Futures Index Basis Annual
------------------------------------------------------------------------------
deribit ETH-26OCT26 0.7 2,343.21 2,343.68 -0.020% -11.15%
deribit ETH-27OCT26 1.7 2,343.51 2,343.68 -0.007% -1.60%
deribit ETH-28OCT26 2.7 2,343.87 2,343.68 +0.008% +1.11%
deribit ETH-29OCT26 3.7 2,344.11 2,343.68 +0.018% +1.83%
deribit ETH-30OCT26 4.7 2,344.26 2,343.68 +0.025% +1.94%
okx ETH-USD-261030 4.7 2,344.03 2,343.45 +0.025% +1.94%
deribit ETH-6NOV26 11.7 2,345.55 2,343.68 +0.080% +2.50%
deribit ETH-13NOV26 18.7 2,346.87 2,343.68 +0.136% +2.66%
deribit ETH-27NOV26 32.7 2,349.78 2,343.68 +0.260% +2.91%
okx ETH-USD-261127 32.7 2,350.74 2,343.45 +0.311% +3.48%
deribit ETH-25DEC26 60.7 2,358.42 2,343.68 +0.629% +3.78%
okx ETH-USD-261225 60.7 2,358.88 2,343.45 +0.658% +3.96%
deribit ETH-26MAR27 151.7 2,384.55 2,343.68 +1.744% +4.20%
okx ETH-USD-270326 151.7 2,385.34 2,343.45 +1.787% +4.30%
deribit ETH-25JUN27 242.7 2,414.94 2,343.68 +3.041% +4.57%
okx ETH-USD-270625 242.7 2,414.77 2,343.45 +3.044% +4.58%
deribit ETH-24SEP27 333.7 2,444.68 2,343.68 +4.309% +4.71%
okx ETH-USD-270924 333.7 2,442.85 2,343.45 +4.241% +4.64%
------------------------------------------------------------------------------
16 of 18 dated futures trade above their index.
Annual figures scale the basis by days to expiry (simple, not compounded).
Expiries less than 12 hours away are left out.
Sources:
https://www.deribit.com/api/v2/public/get_book_summary_by_currency?currency=ETH&kind=future
https://www.okx.com/api/v5/market/tickers?instType=FUTURES&uly=ETH-USD
Research output only. Not financial advice. This tool places no trades.
```
## `derivatives_tracker.py liquidations BTC`
```text
========================================================================
LIQUIDATIONS BTC
Live public data fetched 2026-10-25 16:15 UTC
========================================================================
BTC-USDT-SWAP filled liquidations on OKX
Window: 2026-10-24 16:16 to 2026-10-25 15:02 UTC
Longs liquidated: 246 orders $1.30M
Shorts liquidated: 435 orders $5.08M
Largest:
10-24 16:50 short 10.0000 @ 80,105.00 $801.05K
10-24 16:49 short 10.0000 @ 79,961.70 $799.62K
10-24 23:31 short 5.6254 @ 80,646.90 $453.67K
10-24 23:32 short 3.8403 @ 80,738.30 $310.06K
10-25 09:13 long 3.7401 @ 80,192.10 $299.93K
OKX only: it is the venue here with a public liquidation feed. Other venues'
liquidations are not included, so this is a partial view of the market.
Sources:
https://www.okx.com/api/v5/public/liquidation-orders?instType=SWAP&uly=BTC-USDT&state=filled&limit=100
Research output only. Not financial advice. This tool places no trades.
```
## `derivatives_tracker.py options BTC --expiries 4 --large-trades 2000000`
```text
========================================================================
OPTIONS BTC
Live public data fetched 2026-10-25 16:15 UTC
========================================================================
BTC options on Deribit (open interest and volume in BTC)
Expiry Underlying Call OI Put OI P/C OI P/C vol ATM IV Max pain vs und.
----------------------------------------------------------------------------------------
26OCT26 80,508 1,459.4 1,600.0 1.10 1.65 32.7% 81,000 +0.6%
27OCT26 80,521 706.2 638.5 0.90 2.14 33.7% 81,000 +0.6%
28OCT26 80,543 394.2 361.3 0.92 0.97 33.5% 80,500 -0.1%
29OCT26 80,545 105.2 111.6 1.06 1.06 33.9% 80,500 -0.1%
----------------------------------------------------------------------------------------
Put/call ratio by open interest, all live expiries: 0.60
DVOL (30-day implied volatility index): 38.4 365-day range 33.6-82.6 rank 10 percentile 29
Max pain: the settlement price at which option holders' total intrinsic value is smallest.
Largest option trades among Deribit's last 1000, notional >= $2.00M
10-25 14:23 BTC-27OCT26-79000-P taker buy 200.0 notional $16.05M premium $72.21K IV 38.59 block
10-25 14:22 BTC-26OCT26-79500-P taker buy 200.0 notional $16.04M premium $54.55K IV 39.45 block
10-25 14:04 BTC-26OCT26-83000-C taker buy 100.0 notional $8.02M premium $2.41K IV 42.25
10-25 10:10 BTC-6NOV26-70000-P taker sell 75.0 notional $6.02M premium $15.65K IV 51.54 block
10-25 13:59 BTC-26OCT26-77000-P taker buy 70.0 notional $5.62M premium $1.69K IV 50.57
10-25 11:56 BTC-27NOV26-67000-P taker sell 50.0 notional $4.03M premium $24.55K IV 48.54 block
10-25 10:03 BTC-30OCT26-80000-P taker buy 50.0 notional $4.01M premium $56.96K IV 34.64 block
10-25 10:03 BTC-27OCT26-80000-P taker sell 50.0 notional $4.01M premium $32.49K IV 33.19 block
10-25 10:10 BTC-6NOV26-77000-P taker buy 37.5 notional $3.01M premium $37.62K IV 41.02 block
10-25 15:09 BTC-27NOV26-64000-P taker sell 30.0 notional $2.42M premium $9.19K IV 51.61
Sources:
https://www.deribit.com/api/v2/public/get_book_summary_by_currency?currency=BTC&kind=option
https://www.deribit.com/api/v2/public/get_volatility_index_data (BTC DVOL, daily)
https://www.deribit.com/api/v2/public/get_last_trades_by_currency (BTC options, last 1000)
Research output only. Not financial advice. This tool places no trades.
```
## `derivatives_tracker.py dashboard BTC ETH SOL`
```text
========================================================================
DASHBOARD BTC ETH SOL
Live public data fetched 2026-10-25 16:15 UTC
========================================================================
--- BTC ---
Funding (8h equiv): mean +0.0062%, weighted by open interest +0.0065% across 7 venues
Of 7 venues, funding is positive on 6, negative on 1.
Open interest (one side): $9.95B across 7 venues
Basis: BTC-27NOV26 (deribit, 33 days) +5.27% annualized. Every dated future trades above its index (contango).
--- ETH ---
Funding (8h equiv): mean +0.0050%, weighted by open interest +0.0065% across 7 venues
Of 7 venues, funding is positive on 5, negative on 0, zero on 2.
Open interest (one side): $5.68B across 7 venues
Basis: ETH-27NOV26 (deribit, 33 days) +2.94% annualized. 16 of 18 dated futures trade above their index.
--- SOL ---
Funding (8h equiv): mean +0.0050%, weighted by open interest +0.0022% across 7 venues
Of 7 venues, funding is positive on 5, negative on 1, zero on 1.
Open interest (one side): $1.45B across 7 venues
Basis: no dated futures listed
Unavailable:
BTC binance: refused from this network (HTTP 451, region restriction)
BTC bybit: refused from this network (HTTP 403, likely a region restriction)
ETH binance: refused from this network (HTTP 451, region restriction)
ETH bybit: refused from this network (HTTP 403, likely a region restriction)
SOL binance: refused from this network (HTTP 451, region restriction)
SOL bybit: refused from this network (HTTP 403, likely a region restriction)
SOL deribit: no dated SOL futures listed
SOL okx: no dated SOL futures listed
Sources:
https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP
https://www.deribit.com/api/v2/public/ticker?instrument_name=BTC-PERPETUAL
https://api.hyperliquid.xyz/info metaAndAssetCtxs
https://futures.kraken.com/derivatives/api/v3/tickers/PF_XBTUSD
https://api-futures.kucoin.com/api/v1/contracts/XBTUSDTM
https://api.gateio.ws/api/v4/futures/usdt/contracts/BTC_USDT
https://indexer.dydx.trade/v4/perpetualMarkets?ticker=BTC-USD
https://www.deribit.com/api/v2/public/get_book_summary_by_currency?currency=BTC&kind=future
https://www.okx.com/api/v5/market/tickers?instType=FUTURES&uly=BTC-USD
https://www.okx.com/api/v5/public/funding-rate?instId=ETH-USDT-SWAP
https://www.deribit.com/api/v2/public/ticker?instrument_name=ETH-PERPETUAL
https://futures.kraken.com/derivatives/api/v3/tickers/PF_ETHUSD
https://api-futures.kucoin.com/api/v1/contracts/ETHUSDTM
https://api.gateio.ws/api/v4/futures/usdt/contracts/ETH_USDT
https://indexer.dydx.trade/v4/perpetualMarkets?ticker=ETH-USD
https://www.deribit.com/api/v2/public/get_book_summary_by_currency?currency=ETH&kind=future
https://www.okx.com/api/v5/market/tickers?instType=FUTURES&uly=ETH-USD
https://www.okx.com/api/v5/public/funding-rate?instId=SOL-USDT-SWAP
https://www.deribit.com/api/v2/public/ticker?instrument_name=SOL_USDC-PERPETUAL
https://futures.kraken.com/derivatives/api/v3/tickers/PF_SOLUSD
https://api-futures.kucoin.com/api/v1/contracts/SOLUSDTM
https://api.gateio.ws/api/v4/futures/usdt/contracts/SOL_USDT
https://indexer.dydx.trade/v4/perpetualMarkets?ticker=SOL-USD
Research output only. Not financial advice. This tool places no trades.
```
## JSON output
```bash
derivatives_tracker.py funding BTC --format json
```
```json
{
"skill": "tracking-crypto-derivatives",
"version": "2.0.0",
"command": "funding",
"symbols": [
"BTC"
],
"generated_at": "2026-10-25T16:15:21.383488Z",
"mode": "live",
"sources": [
"https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP",
"https://www.deribit.com/api/v2/public/ticker?instrument_name=BTC-PERPETUAL",
"..."
],
"failures": [
{
"venue": "BTC binance",
"reason": "refused from this network (HTTP 451, region restriction)"
},
{
"venue": "BTC bybit",
"reason": "refused from this network (HTTP 403, likely a region restriction)"
}
],
"data": [
{
"symbol": "BTC",
"venues": [
{
"venue": "okx",
"instrument": "BTC-USDT-SWAP",
"funding_rate": 5.48685337851e-05,
"interval_hours": 8.0,
"rate_8h": 5.48685337851e-05,
"annualized_pct": 6.00810444946845,
"next_funding": "2026-10-26 00:00:00+00:00",
"mark_price": 80579.9,
"index_price": null,
"open_interest_base": 30080.454900000084,
"open_interest_usd": 2423880047.7965164,
"source": "https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP"
},
{
"venue": "deribit",
"instrument": "BTC-PERPETUAL",
"funding_rate": 3.523e-05,
"interval_hours": 8.0,
"rate_8h": 3.523e-05,
"annualized_pct": 3.8576850000000005,
"next_funding": null,
"mark_price": 80533.91,
"index_price": 80508.03,
"open_interest_base": 10453.606809851899,
"open_interest_usd": 841869830.0,
"source": "https://www.deribit.com/api/v2/public/ticker?instrument_name=BTC-PERPETUAL"
},
"... one object per venue ..."
],
"summary": {
"venues": 7,
"mean_rate_8h": 6.241294768358534e-05,
"median_rate_8h": 6.4e-05,
"oi_weighted_rate_8h": 6.438732783227242e-05,
"highest": "kraken",
"lowest": "dydx",
"spread_8h": 0.00012311263333333064,
"notes": [
"Of 7 venues, funding is positive on 6, negative on 1."
]
}
}
],
"disclaimer": "Research output only. Not financial advice. This tool places no trades."
}
```
## Demo mode
```text
[DEMO] ========================================================================
[DEMO] FUNDING BTC
[DEMO] Recorded data from 2026-10-25 16:11 UTC, not live. Run without --demo for live data.
[DEMO] ========================================================================
[DEMO]
[DEMO] BTC perpetual funding
[DEMO] Venue Instrument Rate Every 8h equiv Annual Next
[DEMO] ------------------------------------------------------------------------------------
[DEMO] kraken PF_XBTUSD +0.0015% 1h +0.0119% +13.08% 0h 48m
[DEMO] kucoin XBTUSDTM +0.0100% 8h +0.0100% +10.95% 7h 48m
[DEMO] hyperliquid BTC +0.0009% 1h +0.0074% +8.09% 0h 48m
[DEMO] gate BTC_USDT +0.0071% 8h +0.0071% +7.77% 7h 48m
...
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |