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 |
ARD.md
View on GitHub# ARD: Crypto Derivatives Tracker
> Part of [Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)
## Architecture
```text
derivatives_tracker.py command line, console tables, JSON envelope
├── perps.py nine venue adapters → PerpSnapshot (funding, interval, one-sided OI)
│ 24h OI history and account ratios (OKX, Binance, Bybit)
├── basis_data.py dated futures vs index (Deribit, OKX)
├── liquidations.py OKX filled liquidation orders, paged over the window
├── options_data.py Deribit summaries → put/call, max pain, ATM IV; DVOL; large trades
└── http_client.py urllib requests, failure reasons, record/replay, one clock per run
```
## Decisions
| Decision | Choice | Why |
|----------|--------|-----|
| Data source | Exchange public REST endpoints, no keys | Buyers and free users can run it with nothing to configure; every figure is traceable to a URL |
| Default venues | Nine, including Binance and Bybit | They refuse US networks but serve most of the world; reporting the refusal is more honest than hiding them |
| HTTP | Standard library `urllib` + thread pool | No install step; parallel venue calls keep a run to a few seconds |
| Demo and tests | Replay recorded real responses through the same parsers | Offline runs exercise real parsing; random data would test nothing |
| Units | 8-hour funding equivalent; one-sided open interest | Venues differ (hourly vs 8-hourly; Bybit and Gate publish both-sides and one-side figures) |
| Failure handling | Per-venue `FetchError` with a plain reason; continue | One venue's outage or region block should not hide the others |
| Removed | Liquidation heatmap, simulated options flow, BitMEX | Not reproducible from public data; BitMEX refuses US and EU networks |
## Data flow
1. The command builds one `Http` client (live, recording, or replay).
2. Venue adapters run in parallel; each returns a normalized record or a failure.
3. Summaries are computed only from returned records.
4. Output: console table with sources and disclaimer, or one JSON envelope.
## Security
- Read-only: GET requests, plus Hyperliquid's public `info` POST.
- No credentials are read or accepted.
- `tests/test_derivatives_tracker.py::TestReadOnly` fails if any script references order, account, withdrawal, private or signing endpoints.
## Testing
`python3 -m unittest discover -s tests -v` replays `assets/demo-recording.json` (real BTC responses from a US network) and `tests/fixtures/binance-bybit-recording.json` (real responses recorded from a network those venues serve), plus hand-built payloads for unit conversions and max pain.
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 |