New to Claude Skills? Learn how to install them →

jeremylongshore on GitHub

Tracking Crypto Derivatives

Free

Monitor and analyze cryptocurrency derivatives markets effectively.

Get this skill

Free · Opens the source repo

What Tracking Crypto Derivatives does

Tracking Crypto Derivatives is a powerful skill designed for traders and analysts who need to monitor the dynamic landscape of cryptocurrency derivatives. This skill aggregates critical data points such as funding rates, open interest, liquidations, and options metrics across various centralized and decentralized exchanges. By providing insights into these metrics, users can make informed trading decisions based on market sentiment and trends.

The skill supports a wide range of markets, including perpetual swaps from exchanges like Binance and Bybit, quarterly futures, and options from platforms such as Deribit and OKX. Users can easily access this data through a series of Python scripts, allowing for real-time analysis and reporting. The skill is particularly useful for those looking to identify arbitrage opportunities, gauge market positioning, and analyze options flow, all of which are essential for effective trading strategies.

To get started, users need Python 3.8 or higher and access to exchange APIs. The skill is designed for those with a basic understanding of derivatives concepts, making it accessible for both novice and experienced traders. With commands to check funding rates, analyze open interest, monitor liquidations, and assess options markets, this skill provides a comprehensive toolkit for anyone serious about trading in the cryptocurrency derivatives space.

In addition to its analytical capabilities, the skill generates structured reports that summarize key metrics and insights, making it easier for users to digest and act on the information. Whether you're conducting a morning check of the derivatives landscape or preparing for significant market events, Tracking Crypto Derivatives equips you with the necessary tools to stay ahead in the fast-paced world of crypto trading.

When to use it

Use this skill when you need to monitor derivatives markets, analyze funding rates, or research options flow.

When not to use it

This skill may not be suitable for users unfamiliar with derivatives concepts or those looking for a simple trading tool without detailed analysis.

What you can build with it

Daily Market Overview

Run the dashboard command to get a comprehensive overview of funding rates, open interest, and liquidations for top cryptocurrencies.

Arbitrage Opportunities

Use the funding rate analysis to identify potential arbitrage opportunities based on market sentiment.

Options Expiry Analysis

Check the options market metrics before expiry to inform trading decisions and strategies.

How to install Tracking Crypto Derivatives

View source

1. Install with the skills CLI

npx skills add jeremylongshore/claude-code-plugins-plus-skills/tracking-crypto-derivatives --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by jeremylongshore

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

  1. 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
  2. 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
  3. 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
    
  4. 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
    
  5. 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
    
  6. 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

ErrorCauseFix
ERR_RATE_LIMITToo many API requestsReduce frequency or add API key
ERR_EXCHANGE_DOWNExchange API unavailableTry alternative exchange
ERR_SYMBOL_INVALIDWrong symbol formatUse 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

Frequently asked questions about Tracking Crypto Derivatives

Similar skills