{"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.3.1"},"paths":{"/api/health":{"get":{"tags":["free"],"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/ready":{"get":{"tags":["free"],"summary":"Ready","operationId":"ready_api_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/discovery":{"get":{"tags":["discovery"],"summary":"Discovery","operationId":"discovery_api_discovery_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.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":{}}}}}}},"/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":{}}}}}}},"/api/v1/btc/market":{"get":{"tags":["paid"],"summary":"Market","operationId":"market_api_v1_btc_market_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/btc/snapshot":{"get":{"tags":["paid"],"summary":"Snapshot","description":"Market + derivatives + network in one paid call.","operationId":"snapshot_api_v1_btc_snapshot_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/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"}}}}}}},"/api/v1/btc/derivatives":{"get":{"tags":["paid"],"summary":"Derivatives","operationId":"derivatives_api_v1_btc_derivatives_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/btc/network":{"get":{"tags":["paid"],"summary":"Network","operationId":"network_api_v1_btc_network_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/btc/whales":{"get":{"tags":["paid"],"summary":"Whales","operationId":"whales_api_v1_btc_whales_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/login":{"post":{"tags":["admin"],"summary":"Login","operationId":"login_api_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/logout":{"post":{"tags":["admin"],"summary":"Logout","operationId":"logout_api_admin_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/me":{"get":{"tags":["admin"],"summary":"Me","operationId":"me_api_admin_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/overview":{"get":{"tags":["admin"],"summary":"Overview","operationId":"overview_api_admin_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/analytics":{"get":{"tags":["admin"],"summary":"Analytics","operationId":"analytics_api_admin_analytics_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"}}}}}}},"/api/admin/requests":{"get":{"tags":["admin"],"summary":"Requests","operationId":"requests_api_admin_requests_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status"}},{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/earnings":{"get":{"tags":["admin"],"summary":"Earnings","operationId":"earnings_api_admin_earnings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/errors":{"get":{"tags":["admin"],"summary":"Errors","operationId":"errors_api_admin_errors_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/sources":{"get":{"tags":["admin"],"summary":"Sources","operationId":"sources_api_admin_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/latest":{"get":{"tags":["admin"],"summary":"Latest","operationId":"latest_api_admin_latest_get","parameters":[{"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"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/history":{"get":{"tags":["admin"],"summary":"Admin History","operationId":"admin_history_api_admin_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":1000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/indicators":{"get":{"tags":["admin"],"summary":"Indicators","operationId":"indicators_api_admin_indicators_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/storage":{"get":{"tags":["admin"],"summary":"Storage","operationId":"storage_api_admin_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/catalog":{"get":{"tags":["admin"],"summary":"Admin Catalog","operationId":"admin_catalog_api_admin_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/activity":{"get":{"tags":["admin"],"summary":"Activity","operationId":"activity_api_admin_activity_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/revoke-sessions":{"post":{"tags":["admin"],"summary":"Revoke Sessions","operationId":"revoke_sessions_api_admin_revoke_sessions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"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"},"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"}}},"tags":[{"name":"free","description":"No payment required"},{"name":"paid","description":"x402 per-request payment (HTTP 402 challenge)"},{"name":"discovery","description":"Machine-readable catalog and agent cards"},{"name":"admin","description":"Operator console (session cookie)"}]}