jeremylongshore/tons-of-skills-marketplace / plugins/crypto/crypto-derivatives-tracker/skills/tracking-crypto-derivatives
tracking-crypto-derivatives
VerifiedResearch 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".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 2.7 KB |
| PRD.md | markdown | 2.7 KB |
| SKILL.md | skill md | 6.9 KB |
| assets/demo-recording.json | config | 187.6 KB |
| references/errors.md | markdown | 2.5 KB |
| references/examples.md | markdown | 17.4 KB |
| references/implementation.md | markdown | 4.8 KB |
| scripts/basis_data.py | script | 4.5 KB |
| scripts/derivatives_tracker.py | script | 25.0 KB |
| scripts/http_client.py | script | 6.4 KB |
| scripts/liquidations.py | script | 4.0 KB |
| scripts/options_data.py | script | 9.2 KB |
| scripts/perps.py | script | 17.6 KB |
| scripts/record_demo.py | script | 3.3 KB |
| tests/fixtures/binance-bybit-recording.json | config | 12.8 KB |
| tests/test_derivatives_tracker.py | script | 10.0 KB |
PRD.md
View on GitHub# PRD: Crypto Derivatives Tracker
> Part of [Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)
## Summary
**One-liner**: Read-only research on crypto perpetuals, dated futures and options from live public exchange data.
**Domain**: Cryptocurrency market research
**Users**: Traders and analysts who want cross-venue derivatives data with sources, without API keys
## Problem Statement
Derivatives data is spread across many venues, each with its own units: funding paid hourly on some venues and every 8 hours on others, open interest counted in contracts, coins, USD, one side or both. Comparing venues by hand means reading each API's documentation and converting units. Free aggregators hide their sources; paid ones cost a subscription.
Version 1.x of this skill did not solve the problem: it generated its numbers at random. Version 2.0.0 replaces that with live public data.
## Users
- **Active trader**: checks funding and open interest across venues before acting on their own judgment.
- **Researcher or writer**: needs sourced figures and a reproducible method.
- **Developer**: wants JSON in one envelope to feed their own analysis.
## Requirements
### Must
1. Every figure comes from a public, keyless endpoint and carries its source URL and fetch time.
2. No mock, random or hard-coded market data by default. Recorded data only behind `--demo`, marked on every line.
3. A venue that fails is named with a plain reason (region block, rate limit, not listed, timeout); the remaining venues still report; no value is substituted.
4. Funding normalized to an 8-hour equivalent; open interest normalized to one side, in coins and USD.
5. No order, account, withdrawal or signing code. A test enforces it.
6. Every report ends with: "Research output only. Not financial advice. This tool places no trades."
7. Standard library only; Python 3.9+.
### Should
1. JSON output in one envelope (`skill`, `version`, `command`, `generated_at`, `mode`, `sources`, `failures`, `data`, `disclaimer`).
2. Offline tests that replay recorded real responses.
3. Output describes conditions and does not recommend trades.
### Will not
- Liquidation heatmaps (vendor model estimates, not reproducible from public data).
- Simulated options flow.
- Trading, alerts that tell the user to act, or account access.
## Success criteria
- Live run returns data from at least five venues for BTC from a US network (seven did on 2026-10-25: OKX, Deribit, Hyperliquid, Kraken, KuCoin, Gate, dYdX; Binance and Bybit refused).
- From a network Binance and Bybit serve, all nine venues return (verified 2026-10-25 from France).
- `python3 -m unittest discover -s tests` passes offline.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |