@intentsolutionsio/crypto-derivatives-tracker 1.0.0 → 1.0.3

package/README.md

@@ -20,6 +20,7 @@ Track cryptocurrency futures, options, and perpetual swaps with funding rates, o
 ## Usage
 
 The derivatives agent automatically activates when you discuss:
+
 - Futures, options, or perpetual swaps
 - Funding rates and open interest
 - Derivatives trading strategies
@@ -45,6 +46,7 @@ Compare funding rates across Binance, Bybit, and OKX
 ## Supported Markets
 
 ### Centralized Exchanges
+
 - **Binance Futures** - Largest volume, USDT and coin-margined
 - **Bybit** - Popular perpetuals, good liquidity
 - **OKX** - Comprehensive derivatives suite
@@ -53,6 +55,7 @@ Compare funding rates across Binance, Bybit, and OKX
 - **BitMEX** - Crypto perpetuals pioneer
 
 ### Decentralized Protocols
+
 - **dYdX** - Perpetuals on Ethereum/StarkEx
 - **GMX** - Perpetuals on Arbitrum/Avalanche
 - **Synthetix** - Synthetic assets and perps
@@ -83,22 +86,26 @@ Create a `.derivatives-config.json` file:
 ## Key Metrics Explained
 
 ### Funding Rates
+
 - **Positive funding**: Longs pay shorts (bullish sentiment)
 - **Negative funding**: Shorts pay longs (bearish sentiment)
 - **Extreme rates** (>0.1% 8-hour): Contrarian opportunity
 
 ### Open Interest (OI)
+
 - **Rising OI + Rising Price**: Strong bullish trend
 - **Rising OI + Falling Price**: Strong bearish trend
 - **Falling OI + Rising Price**: Short covering
 - **Falling OI + Falling Price**: Long liquidations
 
 ### Futures Basis
+
 - **Contango** (positive): Futures > spot (normal)
 - **Backwardation** (negative): Futures < spot (high demand)
 - **Cash-and-carry**: Buy spot + sell futures
 
 ### Options Greeks
+
 - **Delta**: Price sensitivity
 - **Gamma**: Rate of delta change
 - **Vega**: Volatility sensitivity
@@ -107,18 +114,23 @@ Create a `.derivatives-config.json` file:
 ## Trading Strategies
 
 ### 1. Funding Rate Arbitrage
+
 Long spot + Short perpetual when funding > 0.1%
 
 ### 2. Basis Trading
+
 Buy spot + Sell quarterly futures when basis > 5% annualized
 
 ### 3. Liquidation Hunting
+
 Target clusters of liquidations for potential cascades
 
 ### 4. Options Volatility Trading
+
 Buy straddles when IV low, sell spreads when IV high
 
 ### 5. Options Flow Following
+
 Track smart money positioning via unusual options activity
 
 ## Data Sources
@@ -132,6 +144,7 @@ Track smart money positioning via unusual options activity
 ## Risk Management
 
 ️ **Critical Considerations**:
+
 - Derivatives use leverage - high risk of liquidation
 - Funding costs accumulate in perpetuals
 - Options can expire worthless (theta decay)
@@ -139,6 +152,7 @@ Track smart money positioning via unusual options activity
 - Volatile markets can gap through stop losses
 
 ### Best Practices
+
 1. Use appropriate position sizing
 2. Monitor liquidation prices continuously
 3. Account for funding costs
@@ -150,6 +164,7 @@ Track smart money positioning via unusual options activity
 ️ **Crypto derivatives are extremely risky instruments.**
 
 Users should:
+
 - Fully understand leverage and liquidation mechanics
 - Only trade with funds they can afford to lose
 - Use proper position sizing and risk management
@@ -166,7 +181,7 @@ MIT License - See LICENSE file for details
 ## Support
 
 - GitHub Issues: [Report bugs](https://github.com/jeremylongshore/claude-code-plugins/issues)
-- Documentation: [Full docs](https://docs.claude-code-plugins.com)
+- Documentation: Full docs
 
 ---
 

package/agents/derivatives-agent.md

@@ -11,6 +11,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 ## Your Capabilities
 
 ### Perpetual Swaps Analysis
+
 - **Funding rates** across all major exchanges (Binance, Bybit, OKX, Deribit, FTX)
 - **Predicted funding** for next payment period
 - **Funding arbitrage** opportunities between exchanges
@@ -19,6 +20,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Long/short ratio** by exchange and timeframe
 
 ### Futures Market Analysis
+
 - **Open interest** tracking across all expiries
 - **Futures basis** (premium/discount to spot)
 - **Roll yields** and calendar spread opportunities
@@ -27,6 +29,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Contango/backwardation** analysis
 
 ### Options Market Intelligence
+
 - **Implied volatility (IV)** across strikes and expiries
 - **Options flow**: Large trades and unusual activity
 - **Put/call ratio** and skew analysis
@@ -36,6 +39,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Open interest by strike** for support/resistance
 
 ### Derivatives Market Metrics
+
 - **Total open interest** across all derivatives
 - **Volume analysis** by product type
 - **Exchange market share** for derivatives
@@ -44,6 +48,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Basis trading opportunities**
 
 ### Trading Signal Generation
+
 - **Funding rate extremes**: Contrarian signals
 - **Open interest divergence**: Trend strength indicators
 - **Options positioning**: Smart money tracking
@@ -54,6 +59,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 ## When to Activate
 
 Activate this agent when users need to:
+
 - Analyze derivatives market positioning
 - Track funding rates for perpetual swaps
 - Monitor open interest and liquidations
@@ -67,6 +73,7 @@ Activate this agent when users need to:
 ## Approach
 
 ### Analysis Methodology
+
 1. **Data Collection**: Aggregate data from multiple exchanges and data providers
 2. **Market Structure**: Analyze current positioning (long/short, OI, funding)
 3. **Historical Context**: Compare to historical levels and patterns
@@ -76,7 +83,9 @@ Activate this agent when users need to:
 7. **Signal Generation**: Produce actionable insights with risk parameters
 
 ### Output Format
+
 Present analysis in structured format:
+
 ```
  CRYPTO DERIVATIVES MARKET ANALYSIS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -230,6 +239,7 @@ Strategy Recommendations:
 ## Supported Exchanges
 
 ### Centralized Exchanges
+
 - **Binance Futures**: Largest volume, USDT and coin-margined
 - **Bybit**: Popular for perpetuals, good liquidity
 - **OKX**: Comprehensive derivatives suite
@@ -240,6 +250,7 @@ Strategy Recommendations:
 - **Gate.io**: Wide range of altcoin derivatives
 
 ### Decentralized Protocols
+
 - **dYdX**: Perpetuals on Ethereum/StarkEx
 - **GMX**: Perpetuals on Arbitrum/Avalanche
 - **Synthetix**: Synthetic assets and perps
@@ -250,24 +261,28 @@ Strategy Recommendations:
 ## Key Derivatives Concepts
 
 ### Funding Rates
+
 - **Positive funding**: Longs pay shorts (bullish sentiment)
 - **Negative funding**: Shorts pay longs (bearish sentiment)
 - **Extreme rates**: Contrarian opportunity (often >0.1% 8-hour)
 - **Funding arbitrage**: Long spot + short perp when funding is high
 
 ### Open Interest
+
 - **Rising OI + rising price**: Strong bullish trend
 - **Rising OI + falling price**: Strong bearish trend
 - **Falling OI + rising price**: Short covering
 - **Falling OI + falling price**: Long liquidations
 
 ### Futures Basis
+
 - **Contango (positive basis)**: Futures > spot (normal market)
 - **Backwardation (negative basis)**: Futures < spot (high demand for spot)
 - **Cash-and-carry**: Buy spot + sell futures (earn basis)
 - **Reverse cash-and-carry**: Sell spot + buy futures
 
 ### Options Greeks
+
 - **Delta**: Price sensitivity to underlying
 - **Gamma**: Rate of delta change
 - **Vega**: Sensitivity to volatility changes
@@ -275,6 +290,7 @@ Strategy Recommendations:
 - **Rho**: Interest rate sensitivity (less relevant in crypto)
 
 ### Implied Volatility
+
 - **High IV**: Options expensive, expect big moves
 - **Low IV**: Options cheap, complacency
 - **IV Rank**: Percentile of IV over past year
@@ -283,6 +299,7 @@ Strategy Recommendations:
 ## Trading Strategies
 
 ### 1. Funding Rate Arbitrage
+
 ```
 When: Funding > 0.1% (8-hour) or < -0.05%
 Strategy:
@@ -292,6 +309,7 @@ Risk: Basis risk, exchange risk
 ```
 
 ### 2. Basis Trading (Cash-and-Carry)
+
 ```
 When: Quarterly basis > 5% annualized
 Strategy: Buy spot + Sell quarterly futures
@@ -300,6 +318,7 @@ Risk: Margin requirements, early liquidation
 ```
 
 ### 3. Liquidation Hunting
+
 ```
 When: Large liquidation clusters identified
 Strategy: Enter positions targeting liquidation cascades
@@ -307,6 +326,7 @@ Risk: False breakouts, slippage
 ```
 
 ### 4. Options Volatility Trading
+
 ```
 When: IV rank < 20 (cheap vol) or > 80 (expensive vol)
 Strategy:
@@ -316,6 +336,7 @@ Risk: Gamma risk, large moves
 ```
 
 ### 5. Put/Call Dispersion
+
 ```
 When: Unusual options flow detected
 Strategy: Follow smart money positioning
@@ -325,18 +346,21 @@ Risk: Misinterpretation, manipulation
 ## Risk Management
 
 ### Position Sizing
+
 - Derivatives are leveraged - use smaller positions
 - Account for funding costs in perps
 - Consider theta decay in options
 - Monitor liquidation prices continuously
 
 ### Exchange Risk
+
 - Counterparty risk on CEXes
 - Smart contract risk on DEXes
 - Spread positions across exchanges
 - Keep most funds in cold storage
 
 ### Market Risk
+
 - Volatile funding can erode profits
 - Basis can widen before converging
 - Liquidation cascades can gap prices
@@ -345,12 +369,14 @@ Risk: Misinterpretation, manipulation
 ## Data Sources
 
 ### Exchange APIs
+
 - Binance API: Futures, perpetuals, funding
 - Deribit API: Options data, IV surface
 - Bybit API: Perpetuals, funding, liquidations
 - OKX API: Comprehensive derivatives data
 
 ### Aggregators
+
 - **Coinglass**: OI, funding, liquidations across exchanges
 - **Glassnode**: On-chain + derivatives metrics
 - **Skew**: Derivatives dashboards (deprecated, use alternatives)
@@ -358,6 +384,7 @@ Risk: Misinterpretation, manipulation
 - **Amberdata**: Institutional derivatives data
 
 ### On-Chain Data (for DEXes)
+
 - **The Graph**: dYdX, GMX subgraphs
 - **Dune Analytics**: Perpetual Protocol, Synthetix
 - **DefiLlama**: TVL and volume for DeFi perps
@@ -365,6 +392,7 @@ Risk: Misinterpretation, manipulation
 ## Example Queries
 
 You can answer questions like:
+
 - "What's the current funding rate for BTC perpetuals?"
 - "Show me open interest across all BTC futures"
 - "Analyze options flow for ETH expiring Friday"
@@ -397,6 +425,7 @@ You can answer questions like:
 ## Risk Disclaimer
 
 Crypto derivatives are **extremely risky** instruments. Users should:
+
 - Fully understand leverage and liquidation mechanics
 - Only trade with funds they can afford to lose completely
 - Use appropriate position sizing and risk management

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/crypto-derivatives-tracker",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Track crypto futures, options, perpetual swaps with funding rates, open interest, and derivatives market analysis",
   "keywords": [
     "crypto",

package/skills/skill-adapter/references/README.md

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for crypto-derivatives-tracker skill
-

package/skills/skill-adapter/references/examples.md

@@ -7,11 +7,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 1: Simple Activation
 
 **User Request:**
+
 ```
 [Describe trigger phrase here]
 ```
 
 **Skill Response:**
+
 1. Analyzes the request
 2. Performs the required action
 3. Returns results
@@ -19,11 +21,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 2: Complex Workflow
 
 **User Request:**
+
 ```
 [Describe complex scenario]
 ```
 
 **Workflow:**
+
 1. Step 1: Initial analysis
 2. Step 2: Data processing
 3. Step 3: Result generation
@@ -34,6 +38,7 @@ This document provides practical examples of how to use this skill effectively.
 ### Pattern 1: Chaining Operations
 
 Combine this skill with other tools:
+
 ```
 Step 1: Use this skill for [purpose]
 Step 2: Chain with [other tool]
@@ -43,6 +48,7 @@ Step 3: Finalize with [action]
 ### Pattern 2: Error Handling
 
 If issues occur:
+
 - Check trigger phrase matches
 - Verify context is available
 - Review allowed-tools permissions

package/skills/tracking-crypto-derivatives/ARD.md

@@ -47,27 +47,34 @@ This skill aggregates derivatives data from multiple exchanges, normalizes forma
 ## Workflow
 
 ### Step 1: Exchange Client Initialization
+
 Configure API connections for each supported exchange with rate limiting.
 
 ### Step 2: Data Fetching
+
 Parallel fetch from all exchanges for:
+
 - Funding rates (perpetuals)
 - Open interest (futures + perps)
 - Recent liquidations
 - Options data (Deribit primarily)
 
 ### Step 3: Data Normalization
+
 Standardize formats across exchanges:
+
 - Convert funding to 8-hour basis
 - Normalize OI to USD equivalent
 - Unify liquidation formats
 
 ### Step 4: Analysis & Aggregation
+
 - Calculate weighted averages
 - Detect divergences
 - Generate signals
 
 ### Step 5: Output
+
 Present in requested format (console/JSON).
 
 ---
@@ -97,13 +104,17 @@ Exchange APIs          Normalization           Analysis              Output
 ## Progressive Disclosure Strategy
 
 ### Level 1: Quick Summary
+
 Single-line current funding rate or OI.
+
 ```
 BTC Funding: +0.015% (Binance) | OI: $18.5B (+2.3% 24h)
 ```
 
 ### Level 2: Standard Report
+
 Tabular view across exchanges with key metrics.
+
 ```
 BTC FUNDING RATES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -115,6 +126,7 @@ Bybit       +0.0180%   +0.0140%   +19.71%
 ```
 
 ### Level 3: Deep Analysis
+
 Full derivatives dashboard with all metrics, signals, and risk assessment.
 
 ---
@@ -204,6 +216,7 @@ RATE_LIMITS = {
 ## Data Models
 
 ### FundingRate
+
 ```python
 @dataclass
 class FundingRate:
@@ -216,6 +229,7 @@ class FundingRate:
 ```
 
 ### OpenInterest
+
 ```python
 @dataclass
 class OpenInterest:
@@ -229,6 +243,7 @@ class OpenInterest:
 ```
 
 ### Liquidation
+
 ```python
 @dataclass
 class Liquidation:
@@ -242,6 +257,7 @@ class Liquidation:
 ```
 
 ### OptionsSnapshot
+
 ```python
 @dataclass
 class OptionsSnapshot:
@@ -327,17 +343,20 @@ async def fetch_all_funding(symbols: List[str]) -> Dict[str, FundingRate]:
 ## Testing Strategy
 
 ### Unit Tests
+
 - Funding rate calculations
 - OI normalization
 - Liquidation aggregation
 - Basis calculations
 
 ### Integration Tests
+
 - Exchange API connectivity
 - Rate limit handling
 - Error recovery
 
 ### Mock Data
+
 - Simulated exchange responses
 - Historical liquidation data
 - Options chain snapshots
@@ -347,11 +366,13 @@ async def fetch_all_funding(symbols: List[str]) -> Dict[str, FundingRate]:
 ## Security & Compliance
 
 ### API Key Handling
+
 - Keys stored in environment variables or config
 - Read-only permissions only (no trading)
 - No key logging in outputs
 
 ### Data Privacy
+
 - No personal data collected
 - No trading history stored
 - Analysis only, no execution
@@ -371,6 +392,7 @@ alerts:
 ```
 
 ### Alert Outputs
+
 - Console warnings with emoji indicators
 - JSON alerts for webhook integration
 - Summary at end of report

package/skills/tracking-crypto-derivatives/PRD.md

@@ -25,18 +25,21 @@ Manual monitoring is impractical given the 24/7 nature of crypto markets and the
 ## Target Users
 
 ### Persona 1: Derivatives Day Trader
+
 - **Background**: Full-time crypto trader focusing on perpetual swaps
 - **Goals**: Profit from funding rate extremes, OI divergences, and liquidation cascades
 - **Pain Points**: Data fragmented across exchanges, misses funding changes
 - **Success Criteria**: Consistent funding capture, early entry before liquidation cascades
 
 ### Persona 2: Basis Arbitrageur
+
 - **Background**: Market-neutral trader running cash-and-carry strategies
 - **Goals**: Lock in risk-free returns via spot-futures basis trades
 - **Pain Points**: Manual basis calculations, timing entry/exit around funding
 - **Success Criteria**: Captures basis premium with minimal directional risk
 
 ### Persona 3: Options Flow Analyst
+
 - **Background**: Institutional researcher tracking smart money via options
 - **Goals**: Identify unusual options activity and positioning before moves
 - **Pain Points**: Options data scattered, hard to interpret Greeks at scale
@@ -47,66 +50,78 @@ Manual monitoring is impractical given the 24/7 nature of crypto markets and the
 ## User Stories
 
 ### US-1: Funding Rate Monitoring (Critical)
+
 **As a** derivatives trader
 **I want to** see funding rates across all major exchanges in one view
 **So that** I can identify arbitrage opportunities and sentiment extremes
 
 **Acceptance Criteria**:
+
 - Display funding rates for BTC, ETH, SOL across Binance, Bybit, OKX, Deribit
 - Show current, 24h average, and 7d average rates
 - Calculate annualized funding yield
 - Alert when funding exceeds configurable threshold (default: 0.1%)
 
 ### US-2: Open Interest Analysis (Critical)
+
 **As a** derivatives trader
 **I want to** track open interest changes by exchange and contract type
 **So that** I can gauge market positioning and trend strength
 
 **Acceptance Criteria**:
+
 - Show total OI in USD and BTC/ETH equivalent
 - Display 24h, 7d, 30d OI changes
 - Compare OI across exchanges (market share)
 - Analyze OI vs price divergences
 
 ### US-3: Liquidation Monitoring (Critical)
+
 **As a** derivatives trader
 **I want to** see liquidation levels and recent liquidation events
 **So that** I can avoid cascade zones and position for liquidation-driven moves
 
 **Acceptance Criteria**:
+
 - Display liquidation heatmap with price levels
 - Show recent large liquidations (>$100K)
 - Calculate long/short liquidation zones
 - Estimate cascade risk at key levels
 
 ### US-4: Basis Tracking (High)
+
 **As a** basis arbitrageur
 **I want to** see spot-futures basis across all expiries
 **So that** I can identify cash-and-carry opportunities
 
 **Acceptance Criteria**:
+
 - Calculate perpetual-spot basis (real-time)
 - Calculate quarterly-spot basis with annualized yield
 - Compare basis across exchanges
 - Signal when basis exceeds profitability threshold
 
 ### US-5: Options Flow Analysis (High)
+
 **As an** options analyst
 **I want to** track unusual options activity and positioning
 **So that** I can identify smart money moves
 
 **Acceptance Criteria**:
+
 - Show large options trades (premium > $100K)
 - Display put/call ratio by volume and OI
 - Calculate max pain for upcoming expiries
 - Analyze implied volatility levels and skew
 
 ### US-6: Multi-Asset Dashboard (Medium)
+
 **As a** portfolio manager
 **I want to** see derivatives metrics for multiple assets
 **So that** I can monitor my entire derivatives exposure
 
 **Acceptance Criteria**:
+
 - Support BTC, ETH, SOL, and major altcoins
 - Display comparative funding rates
 - Show aggregate OI across assets
@@ -117,35 +132,41 @@ Manual monitoring is impractical given the 24/7 nature of crypto markets and the
 ## Functional Requirements
 
 ### REQ-1: Multi-Exchange Data Aggregation
+
 - Fetch funding rates from Binance, Bybit, OKX, Deribit, BitMEX
 - Aggregate open interest across exchanges
 - Support both USDT-margined and coin-margined contracts
 
 ### REQ-2: Funding Rate Analysis
+
 - Current funding rate with countdown to next payment
 - Historical funding (24h, 7d, 30d averages)
 - Funding arbitrage opportunities between exchanges
 - Annualized funding yield calculation
 
 ### REQ-3: Open Interest Analytics
+
 - Total OI by asset and exchange
 - OI change tracking (1h, 24h, 7d)
 - Long/short ratio by exchange
 - OI vs price divergence detection
 
 ### REQ-4: Liquidation Intelligence
+
 - Real-time liquidation tracking
 - Liquidation heatmap generation
 - Cascade risk estimation
 - Historical liquidation analysis
 
 ### REQ-5: Options Market Data
+
 - Implied volatility by strike and expiry
 - Put/call ratio tracking
 - Max pain calculation
 - Options flow for large trades
 
 ### REQ-6: Basis Calculations
+
 - Perpetual basis (funding-implied)
 - Quarterly futures basis
 - Annualized yield calculation
@@ -187,16 +208,19 @@ Manual monitoring is impractical given the 24/7 nature of crypto markets and the
 ## Risk Considerations
 
 ### Market Risks
+
 - Funding rates can flip rapidly during volatility
 - Liquidation cascades can gap through levels
 - Options pricing models have limitations
 
 ### Data Risks
+
 - Exchange API outages or rate limits
 - Delayed or stale data during high volatility
 - Inconsistent data formats between exchanges
 
 ### User Risks
+
 - Over-reliance on signals without risk management
 - Misinterpretation of complex derivatives metrics
 - Leverage amplifies both gains and losses
@@ -206,6 +230,7 @@ Manual monitoring is impractical given the 24/7 nature of crypto markets and the
 ## Examples
 
 ### Example 1: Funding Rate Alert
+
 ```
 User: "What's the funding rate for BTC?"
 
@@ -225,6 +250,7 @@ Arbitrage: None (rates aligned)
 ```
 
 ### Example 2: Liquidation Analysis
+
 ```
 User: "Where are the BTC liquidation levels?"