| name | btc-risk-radar |
| description | Professional BTC risk radar using public options, perp, and spot data. Use when the user wants a clear Bitcoin risk snapshot with volatility/skew context, panic or black-swan validation, timestamped evidence, confidence scoring, and explicit caveats for traders or advanced observers. |
BTC Risk Radar
Generate a verifiable BTC risk snapshot from public data, then produce a concise analyst conclusion.
This skill is a read-only heuristic risk-state framework, not a full institutional analytics stack. Several fields are deliberate proxies / approximations and must be presented as such.
Workflow
- Run
scripts/btc_risk_radar.py to collect current public data and compute metrics.
- Read JSON output first; treat it as the source of truth.
- Explain conclusions with explicit confidence, caveats, and data gaps.
- Avoid deterministic predictions; present risk state (GREEN/AMBER/RED) and trigger reasons.
- If venue coverage is partial, keep going and surface degraded confidence rather than pretending coverage is complete.
Quick Audit Path
For a fast review:
- Run
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --sources
- Run
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --json
- Confirm the script only performs read-only public HTTP requests and returns a market snapshot with caveats.
- Verify that proxy metrics and partial-data conditions are explicitly disclosed in output.
Commands
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --json
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --sources
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --version
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --prompt "用户问题"
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --lang en
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --lang zh
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --horizon-hours 72
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --event-mode high-alert
python3 skills/btc-risk-radar/scripts/btc_risk_radar.py --audience beginner --lang zh
Safety / Scope Boundary
- Read-only skill: query public market APIs only.
- Use no authentication, cookies, API keys, private accounts, or wallet access.
- Execute no trades, place no orders, and mutate no exchange state.
- Write no files and send no external messages as part of normal use.
- Produce analysis only; not investment advice.
Output Policy
- Default language behavior:
auto.
- If
--lang auto and the prompt contains Chinese, switch final narrative to Chinese.
- If
--lang auto and no Chinese is detected, use English.
--json output is language-neutral.- Always include:
as_of_utc- key metrics (ATM IV, RR25, RR15, put-volume proxy, funding, basis)
availabilitydata_gapsdegraded_mode- 72h validation matrix (
validation_72h)
- confidence (
confidence.score, confidence.level)
- action trigger set (
action_triggers)
- data-source note and caveats
- Audience modes:
pro (default): concise trading/risk languagebeginner: plain-language educational explanation with metric interpretation
- Event modes:
normal (default)high-alert (more sensitive thresholds for macro/event windows)
Interpretation Guardrails
put_buy_share_proxy is a proxy from put/call volume split, not true aggressor signed-flow.- RR and ATM IV are computed from front-expiry delta-nearest options; this is robust but may differ from proprietary dashboards.
- Funding regime is an aggregated public snapshot, not a full term-structure model.
- RED means elevated downside risk pricing, not guaranteed crash.
- Partial venue failure should lower confidence, not silently disappear from the narrative.
Data Sources (public)
- Deribit Public API
/public/get_instruments/public/get_order_book/public/get_book_summary_by_currency/public/get_index_price/public/get_book_summary_by_instrument
- Coinbase Public API
- Binance Public API (optional)
- OKX Public API
/api/v5/market/ticker/api/v5/public/funding-rate
- Bybit Public API
