Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/crypto/crypto-derivatives-tracker/skills/tracking-crypto-derivatives

tracking-crypto-derivatives

Verified

Research 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".

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.

DataVenues
Funding, open interestOKX, Deribit, Hyperliquid, Kraken Futures, KuCoin Futures, Gate, dYdX, Binance, Bybit
24h open interest change, account long shareOKX, Binance, Bybit
Dated-futures basisDeribit, OKX
Filled liquidationsOKX
Options (put/call, max pain, ATM IV, DVOL, large trades)Deribit (BTC, ETH)

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.

  2. 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
    
  3. Basis for every dated future against the same venue's index:

    python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py basis BTC
    
  4. Liquidations filled on OKX over a look-back window (default 24 hours):

    python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py liquidations BTC --hours 12
    
  5. 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
    
  6. Dashboard with funding, open interest and a reference basis for several coins:

    python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py dashboard BTC ETH SOL
    
  7. 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

MessageCauseWhat to do
refused from this network (HTTP 451/403 ...)The venue blocks your region (Binance, Bybit from the US)Nothing; the other venues still report. Use --venues to skip it.
rate limited (HTTP 429)Too many requestsWait a minute and retry
... not listedThe venue has no market for that coinExpected for smaller coins
timed out after NsSlow network or venueRetry, or raise --timeout
the bundled demo recording covers BTC only--demo with another coinRun without --demo
Exit code 2No venue returned dataCheck the "Unavailable" list

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

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: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall