Read-only crypto derivatives research from live public exchange data: funding, open interest, basis, liquidations, options

MIT License

Claude Code Adapters (declared)

Installation

Open Claude Code and run this command:

/plugin install crypto-derivatives-tracker@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

Read-only research on crypto perpetual swaps, dated futures and options, from live public exchange data. No API keys, no third-party packages, no trading.

Skills (1) plugin-local skills

tracking-crypto-derivatives View full skill →

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.

Bash(python3 ${CLAUDE_SKILL_DIR}/scripts/derivatives_tracker.py:*)

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.

Data	Venues
Funding, open interest	OKX, Deribit, Hyperliquid, Kraken Futures, KuCoin Futures, Gate, dYdX, Binance, Bybit
24h open interest change, account long share	OKX, Binance, Bybit
Dated-futures basis	Deribit, OKX
Filled liquidations	OKX
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.

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.

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

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


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

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


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

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…

How It Works

Ask Claude about funding rates, open interest, futures basis, liquidations or BTC/ETH options, or run the script directly:


python3 skills/tracking-crypto-derivatives/scripts/derivatives_tracker.py funding BTC ETH
python3 skills/tracking-crypto-derivatives/scripts/derivatives_tracker.py oi BTC --format json
python3 skills/tracking-crypto-derivatives/scripts/derivatives_tracker.py options BTC --large-trades 1000000
python3 skills/tracking-crypto-derivatives/scripts/derivatives_tracker.py dashboard BTC --demo

--demo replays a bundled recording of real BTC responses for offline use; every line it prints starts with [DEMO].

crypto-derivatives-tracker

Installation

What It Does

Skills (1) plugin-local skills

Tracking Crypto Derivatives

Overview

Prerequisites

Instructions

How It Works

Ready to use crypto-derivatives-tracker?

Related Plugins

crypto-derivatives-tracker

Installation

What It Does

Skills (1) plugin-local skills

Tracking Crypto Derivatives

Overview

Prerequisites

Instructions

How It Works

Ready to use crypto-derivatives-tracker?

Related Plugins

arbitrage-opportunity-finder

blockchain-explorer-cli

cross-chain-bridge-monitor

crypto-news-aggregator

crypto-portfolio-tracker

crypto-signal-generator