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 |
references/errors.md
View on GitHub# Errors and Fixes
The tracker never fills a gap with made-up numbers. When a request fails, the venue appears under **Unavailable** with one of the reasons below, and the remaining venues are still reported. The exit code is 2 only when no venue returned data.
| Reason shown | Meaning | What to do |
|--------------|---------|------------|
| `refused from this network (HTTP 451, region restriction)` | Binance blocks your country or network | Expected from the US. Other venues cover the market; add `--venues` to skip it. |
| `refused from this network (HTTP 403, likely a region restriction)` | Bybit (and some others) block your region or a VPN exit | As above. |
| `rate limited (HTTP 429); wait and retry` | Too many requests in a short time | Wait a minute. Avoid running the dashboard in a tight loop. |
| `not found (HTTP 404); the symbol may not be listed here` | The URL or market does not exist | Check the coin symbol (`BTC`, not `BTCUSDT`). |
| `{instrument} not listed` | The venue has no perpetual or future for that coin | Normal for smaller coins. |
| `no dated {COIN} futures listed` | Neither Deribit nor OKX lists dated futures for the coin | Basis is available for BTC and ETH. |
| `timed out after Ns` | The venue did not answer in time | Retry, or raise `--timeout`. |
| `network error: ...` | DNS, TLS or connection failure | Check your connection or proxy. |
| `exchange error (HTTP 5xx)` | The venue is having problems | Try again later. |
| `unexpected response shape (...)` | The venue changed its response format | Report it; the parser for that venue needs an update. Other venues are unaffected. |
| `less than 24 hours of history` | A venue returned too few hourly points | The 24h change shows `n/a`. |
| `OKX returned no filled liquidations in the last N hours` | Quiet market or wrong symbol | Widen `--hours`, or check the coin. |
| `expiry XXX not listed; listed expiries: ...` | `--expiry` code not live on Deribit | Pick one from the list. |
| `the bundled demo recording covers BTC only` | `--demo` with another coin | Run without `--demo` for live data. |
| `not in the recorded demo data` | A `--demo` run asked for something the recording does not contain (for example `--venues` with an option the recording skipped) | Run without `--demo`. |
## Checking a venue by hand
Every source URL is printed under **Sources** (console) or in `sources` (JSON). Open one with `curl` to see the raw response:
```bash
curl -s "https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP"
```
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 |