Tracking Crypto Derivatives

Overview

Pull funding rates, open interest, dated-futures basis, liquidations and options data from public, keyless exchange endpoints, normalize them to common units, and report each figure with its source. When a venue fails, it is named with the reason; no value is ever invented.

Binance and Bybit refuse connections from US networks (HTTP 451/403). The tracker reports that and carries on with the other venues.

Prerequisites

• Python 3.9 or newer. Standard library only: no packages to install, no API keys.
• Network access to the exchanges' public endpoints.

Instructions

All commands run python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py. Every command accepts --format json, --demo (replays bundled recorded BTC data, marked on every line) and --timeout SECONDS.

1. Funding rates per venue, scaled to an 8-hour equivalent and a simple annual rate:

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py funding BTC ETH
   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py funding SOL --venues okx,hyperliquid,kraken

Positive funding means longs pay shorts. Hourly venues (Hyperliquid, Kraken, dYdX) are multiplied by 8 so they compare with 8-hourly venues.

1. Open interest per venue, counted on one side, with 24-hour change in coins where the venue publishes hourly history:

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py oi BTC

1. Basis for every dated future against the same venue's index:

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py basis BTC

1. Liquidations filled on OKX over a look-back window (default 24 hours):

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py liquidations BTC --hours 12

1. Options on Deribit: per-expiry put/call ratios, max pain and ATM IV, DVOL rank, and optionally large recent trades:

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py options BTC
   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py options ETH --expiry 27NOV26 --large-trades 1000000  # 1000000 = minimum trade notional in USD

1. Dashboard with funding, open interest and a reference basis for several coins:

   python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py dashboard BTC ETH SOL

1. List venues and what each provides: derivatives_tracker.py venues.

When summarizing results for the user, describe the data (for example "funding is positive on 6 of 7 venues") and keep the source and fetch time. Do not turn the figures into buy, sell or hold advice.

Output

Console tables by default, ending with the sources used and the line "Research output only. Not financial advice. This tool places no trades." With --format json, every command returns one envelope:

{"skill": "tracking-crypto-derivatives", "version": "2.0.0", "command": "funding",
 "symbols": ["BTC"], "generated_at": "2026-10-25T16:11:51Z", "mode": "live",
 "sources": ["https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP", "..."],
 "failures": [{"venue": "binance", "reason": "refused from this network (HTTP 451, region restriction)"}],
 "data": [...], "disclaimer": "Research output only. Not financial advice. This tool places no trades."}

See references/implementation.md for units, formulas and per-venue field mapping, and references/examples.md for real output.

Error Handling

More in references/errors.md.

Examples

Cross-venue funding check (an excerpt of captured live output; full runs with their capture time are in references/examples.md, and live figures change every minute):

python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py funding BTC

kraken       PF_XBTUSD              +0.0015%     1h   +0.0119%   +13.08%      0h 49m
kucoin       XBTUSDTM               +0.0100%     8h   +0.0100%   +10.95%      7h 49m
okx          BTC-USDT-SWAP          +0.0054%     8h   +0.0054%    +5.97%      7h 49m
deribit      BTC-PERPETUAL          +0.0035%     8h   +0.0035%    +3.84%  continuous
dydx         BTC-USD                -0.0001%     1h   -0.0006%    -0.60%      0h 49m
Of 7 venues, funding is positive on 6, negative on 1.

Term structure as JSON for further analysis:

python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py basis ETH --format json

Try it offline:

python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py dashboard BTC --demo

Resources

• references/implementation.md: endpoints, units, formulas, what is not covered
• references/examples.md: real output for every command
• references/errors.md: error messages and fixes
• Tests: python3 -m unittest discover -s tests -v (offline, replays recorded responses)
• Refresh the demo recording: python3 scripts/record_demo.py