{"openapi":"3.1.0","info":{"title":"AgentReeve BTC Intelligence","description":"BTC-only market intelligence for autonomous agents: freshness-qualified multi-venue prices, derivatives, network state and recorded history. Free preview at /api/v1/btc/preview; paid routes settle per request with x402 (USDC on Base). Observational data, not financial advice.","version":"0.13.0","contact":{"name":"AgentReeve","url":"https://agentreeve.com"},"x-guidance":"Bitcoin market data for agents, paid per request with x402 (USDC on Base). No account or API key. Call any paid route: the first reply is HTTP 402 with a Payment-Required challenge; pay and retry with the Payment-Signature header. Start free with GET /api/v1/btc/preview. POST routes take JSON bodies (see each requestBody); compute operations: GET /api/v1/btc/compute/help."},"paths":{"/api/health":{"get":{"tags":["free"],"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/ready":{"get":{"tags":["free"],"summary":"Ready","operationId":"ready_api_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/discovery":{"get":{"tags":["discovery"],"summary":"Discovery","operationId":"discovery_api_discovery_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/agentreeve.json":{"get":{"tags":["discovery"],"summary":"Agent Discovery","operationId":"agent_discovery__well_known_agentreeve_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/btc/preview":{"get":{"tags":["free"],"summary":"Free Preview","description":"Reduced-fidelity BTC summary, free, rate limited. Try before you pay.","operationId":"free_preview_api_v1_btc_preview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/btc/samples":{"get":{"tags":["free"],"summary":"Samples Index","description":"Free: one real (15-minute delayed, shortened) sample per paid product, so you can see what you buy.","operationId":"samples_index_api_v1_btc_samples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/btc/samples/{slug}":{"get":{"tags":["free"],"summary":"Sample","description":"Free: a real sample of one paid product (15-minute delayed, lists cut to 3 items).","operationId":"sample_api_v1_btc_samples__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z-]{2,30}$","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/api/v1/public/pulse":{"get":{"tags":["free"],"summary":"Public Pulse","description":"Live showroom view used by the landing page: venue offsets, freshness, recording volume,\nanonymous traffic. Cached for a few seconds; not a substitute for the paid routes.","operationId":"public_pulse_api_v1_public_pulse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/btc/market":{"get":{"tags":["paid"],"summary":"Market","operationId":"market_api_v1_btc_market_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/snapshot":{"get":{"tags":["paid"],"summary":"Snapshot","description":"Market + derivatives + network in one paid call.","operationId":"snapshot_api_v1_btc_snapshot_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/history":{"get":{"tags":["paid"],"summary":"History","operationId":"history_api_v1_btc_history_get","parameters":[{"name":"granularity","in":"query","required":false,"schema":{"type":"string","default":"minute","title":"Granularity"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":17520,"minimum":1,"default":24,"title":"Hours"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":2000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/derivatives":{"get":{"tags":["paid"],"summary":"Derivatives","operationId":"derivatives_api_v1_btc_derivatives_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/candles":{"get":{"tags":["paid"],"summary":"Candles","description":"OHLC candles: AgentReeve's composite USD index (default) or live exchange candles with volume.","operationId":"candles_api_v1_btc_candles_get","parameters":[{"name":"interval","in":"query","required":false,"schema":{"type":"string","pattern":"^(1m|5m|15m|1h|4h|1d)$","default":"1h","title":"Interval"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","pattern":"^(index|perp_index|binance|binance_futures|coinbase|okx|bybit)$","default":"index","title":"Source"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/positioning":{"get":{"tags":["paid"],"summary":"Positioning","description":"Long/short ratios (accounts, top traders, taker volume) across Binance, Bybit and OKX.","operationId":"positioning_api_v1_btc_positioning_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":720,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/volatility":{"get":{"tags":["paid"],"summary":"Volatility","description":"Implied (Deribit DVOL) vs realised volatility.","operationId":"volatility_api_v1_btc_volatility_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/whale-flow":{"get":{"tags":["paid"],"summary":"Whale Flow","description":"What Hyperliquid's largest accounts did with BTC: net bought/sold, opened, added, cut, closed, flipped.","operationId":"whale_flow_api_v1_btc_whale_flow_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/walls":{"get":{"tags":["paid"],"summary":"Walls","description":"Large resting orders across venues (5 bps slices to ±2 %), imbalance and depth history.","operationId":"walls_api_v1_btc_walls_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/similar-setups":{"get":{"tags":["paid"],"summary":"Similar Setups","description":"Past moments whose signals resembled now, and what BTC did next.","operationId":"similar_setups_api_v1_btc_similar_setups_get","parameters":[{"name":"k","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":5,"default":20,"title":"K"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":730,"minimum":7,"default":180,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/leadership":{"get":{"tags":["paid"],"summary":"Leadership","description":"Cross-venue dislocations and which venue moved first in large moves.","operationId":"leadership_api_v1_btc_leadership_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":72,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/liquidations":{"get":{"tags":["paid"],"summary":"Liquidations","description":"Liquidations across Binance, Bybit and OKX for the last N minutes.","operationId":"liquidations_api_v1_btc_liquidations_get","parameters":[{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","maximum":1440,"minimum":1,"default":60,"title":"Minutes"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/liquidity":{"get":{"tags":["paid"],"summary":"Liquidity","description":"Depth bands and slippage for a market order of size_btc on every venue.","operationId":"liquidity_api_v1_btc_liquidity_get","parameters":[{"name":"size_btc","in":"query","required":false,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"default":10.0,"title":"Size Btc"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/options":{"get":{"tags":["paid"],"summary":"Options","description":"Deribit skew, ATM IV term structure, put/call ratios and max pain.","operationId":"options_api_v1_btc_options_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/oi":{"get":{"tags":["paid"],"summary":"Open Interest","description":"Aggregated open interest, OI-weighted and annualised funding.","operationId":"open_interest_api_v1_btc_oi_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/basis":{"get":{"tags":["paid"],"summary":"Basis","description":"Dated-futures term structure, perpetual premium and Coinbase premium.","operationId":"basis_api_v1_btc_basis_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/signals":{"get":{"tags":["paid"],"summary":"Signals","description":"Unusual-condition flags with percentiles against recorded history.","operationId":"signals_api_v1_btc_signals_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/venues":{"get":{"tags":["paid"],"summary":"Venues","description":"Per-venue uptime, lag, gaps and deviation from consensus.","operationId":"venues_api_v1_btc_venues_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/fees":{"get":{"tags":["paid"],"summary":"Fees","description":"Fee forecast for the next 1, 3 and 6 blocks with projected blocks and history.","operationId":"fees_api_v1_btc_fees_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/metrics":{"get":{"tags":["paid"],"summary":"Metrics","description":"History of a derived metric as minute/hour/day buckets.","operationId":"metrics_api_v1_btc_metrics_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","maxLength":64,"title":"Name"}},{"name":"granularity","in":"query","required":false,"schema":{"type":"string","pattern":"^(minute|hour|day)$","default":"hour","title":"Granularity"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":17520,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/compute/help":{"get":{"tags":["free"],"summary":"Compute Help","description":"Free reference for the compute spec: inputs available now, operations, tiers and an example.","operationId":"compute_help_api_v1_btc_compute_help_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/btc/compute":{"post":{"tags":["paid"],"summary":"Compute Standard","description":"Custom calculation over recorded series (up to 10,000 data points).","operationId":"compute_standard_api_v1_btc_compute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spec"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/compute-large":{"post":{"tags":["paid"],"summary":"Compute Large","description":"Custom calculation over recorded series (up to 200,000 data points).","operationId":"compute_large_api_v1_btc_compute_large_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spec"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/brief":{"get":{"tags":["paid"],"summary":"Brief","description":"24-hour market briefing built from recorded data.","operationId":"brief_api_v1_btc_brief_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/watch":{"post":{"tags":["paid"],"summary":"Watch Create","description":"Create a condition watch with a signed HTTPS webhook (one payment, up to 72 h).","operationId":"watch_create_api_v1_btc_watch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchSpec"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/watch/{wid}":{"get":{"tags":["free"],"summary":"Watch Status","description":"Status of a watch you created (Authorization: Bearer <secret>).","operationId":"watch_status_api_v1_btc_watch__wid__get","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]},"delete":{"tags":["free"],"summary":"Watch Cancel","operationId":"watch_cancel_api_v1_btc_watch__wid__delete","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/api/v1/btc/news":{"get":{"tags":["paid"],"summary":"News Route","description":"Bitcoin headlines with sources, times, links and model-scored sentiment.","operationId":"news_route_api_v1_btc_news_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":72,"minimum":1,"default":24,"title":"Hours"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/ask":{"post":{"tags":["paid"],"summary":"Ask Route","description":"Plain-English question answered with a deterministic calculation over recorded data.","operationId":"ask_route_api_v1_btc_ask_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/network":{"get":{"tags":["paid"],"summary":"Network","operationId":"network_api_v1_btc_network_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}},"/api/v1/btc/whales":{"get":{"tags":["paid"],"summary":"Whales","operationId":"whales_api_v1_btc_whales_get","parameters":[{"name":"fields","in":"query","required":false,"schema":{"maxLength":400,"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge.","title":"Fields"},"description":"Optional. Comma-separated top-level sections to return (e.g. the names in the example). Omit for the full response. Unknown names return 422 with the available names, without charge."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required: an x402 challenge in the Payment-Required header. Pay in USDC on Base and retry with the Payment-Signature header."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","scheme":"exact","payTo":"0xDeA94ef76afa86bf1638B645F76108dF65890c0b"}}]}}}},"components":{"schemas":{"AskBody":{"properties":{"question":{"type":"string","maxLength":500,"minLength":8,"title":"Question"}},"type":"object","required":["question"],"title":"AskBody"},"Cond":{"properties":{"of":{"type":"string","title":"Of"},"gt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gt"},"lt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lt"},"gte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gte"},"lte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lte"}},"type":"object","required":["of"],"title":"Cond"},"ConfigBody":{"properties":{"values":{"additionalProperties":true,"type":"object","title":"Values"},"prices":{"additionalProperties":true,"type":"object","title":"Prices"},"active":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Active"},"confirm_password":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Confirm Password"}},"type":"object","title":"ConfigBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginBody":{"properties":{"password":{"type":"string","maxLength":256,"minLength":1,"title":"Password"}},"type":"object","required":["password"],"title":"LoginBody"},"Op":{"properties":{"op":{"type":"string","enum":["mean","median","stdev","min","max","first","last","sum","count","percentile","zscore","pct_change","change","corr","beta","lag_corr","realized_vol","max_drawdown","count_where","share_where","rolling_mean","rolling_std","spread","forward_return","series"],"title":"Op"},"of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Of"},"a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"A"},"b":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"B"},"p":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"P"},"window":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":2.0},{"type":"null"}],"title":"Window"},"lag":{"anyOf":[{"type":"integer","maximum":500.0,"minimum":-500.0},{"type":"null"}],"title":"Lag"},"horizon":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Horizon"},"when":{"anyOf":[{"$ref":"#/components/schemas/Cond"},{"type":"null"}]},"on":{"type":"string","enum":["entry","every"],"title":"On","default":"entry"},"gt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gt"},"lt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lt"},"gte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gte"},"lte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lte"}},"type":"object","required":["op"],"title":"Op"},"Spec":{"properties":{"inputs":{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1,"title":"Inputs"},"lookback":{"type":"string","pattern":"^\\d{1,4}[hd]$","title":"Lookback","default":"7d"},"granularity":{"type":"string","enum":["minute","hour","day"],"title":"Granularity","default":"hour"},"ops":{"items":{"$ref":"#/components/schemas/Op"},"type":"array","maxItems":16,"minItems":1,"title":"Ops"}},"type":"object","required":["inputs","ops"],"title":"Spec"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WatchCond":{"properties":{"metric":{"type":"string","title":"Metric"},"gt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gt"},"lt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lt"},"gte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gte"},"lte":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lte"}},"type":"object","required":["metric"],"title":"WatchCond"},"WatchSpec":{"properties":{"conditions":{"items":{"$ref":"#/components/schemas/WatchCond"},"type":"array","maxItems":5,"minItems":1,"title":"Conditions"},"callback_url":{"type":"string","maxLength":500,"title":"Callback Url"},"duration_hours":{"type":"integer","maximum":72.0,"minimum":1.0,"title":"Duration Hours","default":24},"cooldown_minutes":{"type":"integer","maximum":1440.0,"minimum":1.0,"title":"Cooldown Minutes","default":30},"max_deliveries":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Max Deliveries","default":10},"label":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Label"}},"type":"object","required":["conditions","callback_url"],"title":"WatchSpec"}}},"servers":[{"url":"https://agentreeve.com"}]}