{"openapi":"3.1.0","info":{"title":"AgentHC Intelligence API","description":"# Market Intelligence for AI Agents\n\nStructured JSON market intelligence for AI agent consumption. Equities, bonds, macro, crypto, regime detection, and more.\n\n## Quick Start\n1. `GET /api/v1/pulse` — free cross-market snapshot (no auth)\n2. `POST /api/v1/agents/register` — get your API key (free, instant)\n3. `GET /api/v1/intelligence/market_intelligence` — 1 free query/day\n4. `POST /api/v1/agents/topup` — fund balance via Lightning\n\n## Pay-Per-Use Pricing\n- **1 free query/day** to any module — full data, no payment\n- **50 sats/query** (~$0.05) for standard modules\n- **250 sats/query** (~$0.25) for proprietary analysis modules\n- Top up balance via Lightning. No subscriptions, no commitments.\n\n## Payment\nBitcoin Lightning Network. Instant settlement, no KYC.\n\n## Disclaimer\nAll data and analysis is for **educational and informational purposes only**. Not financial advice. AgentHC is not a registered investment advisor.","version":"2.0.0"},"paths":{"/":{"get":{"tags":["Discovery"],"summary":"Root","description":"Service root — returns discovery links for AI agents.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pulse":{"get":{"tags":["Discovery"],"summary":"Market Pulse","description":"Cross-market intelligence snapshot — free, no auth required.\n\nReturns a curated view of what's happening across equities, bonds, crypto,\nvolatility, and FX with **cross-market connections** — not just prices.\n\nIncludes:\n- Current market regime with rationale\n- Signal snapshot across 5 asset classes with cross-market context\n- Breaking correlation alerts (the unique edge)\n- Composite market score (-100 to +100)\n- Premium intelligence teasers (what institutional modules are seeing)\n\nRate limited to 10 requests/minute per IP. Rebuilt every ~2 minutes in the\nbackground; `_meta.cache` reports the copy's age and source.","operationId":"market_pulse_api_v1_pulse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["Discovery"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/mcp":{"get":{"tags":["Discovery"],"summary":"Health Mcp","description":"Alias of ``/mcp/health`` under the ``/health/*`` namespace.\n\nSame free, no-auth MCP uptime signal — registered here so monitors that\nexpect health checks under ``/health/`` (UptimeRobot conventions, the\nother ``/health/*`` endpoints) find it without hitting the paywalled\n``/mcp`` proxy.","operationId":"health_mcp_health_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/dashboard":{"get":{"tags":["Discovery"],"summary":"Health Dashboard","description":"Comprehensive health dashboard: module health, circuit breakers,\ndata freshness, service registry, and system resources.","operationId":"health_dashboard_health_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/charts/substack/{filename}":{"get":{"tags":["Discovery"],"summary":"Serve Substack Chart","description":"Serve a generated Substack TA chart image.\n\nThese are self-generated candlestick charts embedded in the\nSunday Substack email newsletter. Public access, no API key required.","operationId":"serve_substack_chart_charts_substack__filename__get","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent.json":{"get":{"tags":["Discovery"],"summary":"Well Known Agent","description":"Machine-readable service manifest for AI agent discovery.\n\nThis is the standard endpoint that agent frameworks crawl to discover\navailable services, capabilities, pricing, and integration methods.","operationId":"well_known_agent__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-card.json":{"get":{"tags":["Discovery"],"summary":"Well Known Agent Card","description":"A2A Protocol Agent Card for agent-to-agent discovery.\n\nStandard endpoint per Google A2A protocol (v0.2.5). Other AI agents\nfetch this to discover AgentHC's skills, capabilities, authentication\nrequirements, and service endpoint.","operationId":"well_known_agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"tags":["Discovery"],"summary":"Well Known Mcp Server Card","description":"MCP Server Card for MCP client/registry discovery (SEP-1649).\n\nAllows MCP clients (Smithery, Claude Desktop, etc.) to discover server\ncapabilities, tools, and transport configuration before connecting.","operationId":"well_known_mcp_server_card__well_known_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/health":{"get":{"tags":["Discovery"],"summary":"Mcp Health","description":"MCP uptime / health signal — free, no auth, no paywall.\n\nMarketplace health-checkers (YellowMCP-HealthChecker et al.) and MCP\nregistries poll ``/mcp`` to monitor uptime, but that path is behind the\nL402 paywall and returns 402, so a checker can't tell \"server down\" from\n\"payment required\". This endpoint reports MCP server liveness without\npayment: it probes the upstream MCP process on 127.0.0.1:8421 and reports\nup/down plus gateway uptime. Always returns HTTP 200 with a structured\nbody (``status`` is ``\"up\"`` or ``\"down\"``) so pollers parse a signal\nrather than an error.","operationId":"mcp_health_mcp_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/catalog":{"get":{"tags":["Discovery"],"summary":"Service Catalog","description":"Full service catalog. Requires registration (free, instant).","operationId":"service_catalog_api_v1_catalog_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/preview":{"get":{"tags":["Discovery"],"summary":"Service Catalog Preview","description":"Free preview of the service catalog — no auth, no registration.\n\nPer audit-2026-05-09 #23: AI agents arriving via the marketplace\nwere hitting ``/api/v1/catalog`` first and getting 402 Payment\nRequired without seeing the discovery flow. This endpoint exposes a\ntruncated view (5 modules per tier + pricing summary + how-to-\nregister) so the calling LLM can decide whether full access is\nworth registering for.\n\nIP rate-limited (same budget as ``/api/v1/pulse``) to prevent\nscrape abuse. The full catalog still requires registration.","operationId":"service_catalog_preview_api_v1_catalog_preview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pricing":{"get":{"tags":["Discovery"],"summary":"Pricing","description":"Pay-per-use pricing. Every query costs sats, deducted from balance.","operationId":"pricing_api_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/modules":{"get":{"tags":["Discovery"],"summary":"List Modules","description":"List all available modules with per-query pricing.","operationId":"list_modules_api_v1_modules_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agents/register":{"post":{"tags":["Agents"],"summary":"Register Agent","description":"Register a new AI agent. Returns agent_id, API key, and referral code.\n\nInclude a `referral_code` in the body to credit the referring agent.\nBoth agents benefit: the referrer earns 10% of your per-request sats.","operationId":"register_agent_api_v1_agents_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agents/me":{"get":{"tags":["Agents"],"summary":"Agent Profile","description":"Get your agent profile, balance, and usage stats.","operationId":"agent_profile_api_v1_agents_me_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agents/rotate-key":{"post":{"tags":["Agents"],"summary":"Rotate Key","description":"Generate a new API key. Old key is immediately invalidated.","operationId":"rotate_key_api_v1_agents_rotate_key_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agents/upgrade":{"post":{"tags":["Agents"],"summary":"Upgrade Agent","description":"Upgrade agent tier via Lightning payment proof.","operationId":"upgrade_agent_api_v1_agents_upgrade_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agents/topup":{"post":{"tags":["Payments"],"summary":"Topup Balance","description":"Top up your sats balance via Lightning payment proof.\n\nPay-per-use model: fund your balance, then every query deducts sats.\nStandard modules cost 50 sats/query, protected modules cost 250 sats/query.","operationId":"topup_balance_api_v1_agents_topup_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agents/balance":{"get":{"tags":["Agents"],"summary":"Agent Balance","description":"Get your current sats balance and usage summary.","operationId":"agent_balance_api_v1_agents_balance_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/batch":{"post":{"tags":["Intelligence"],"summary":"Batch Intelligence","description":"Query multiple modules in one request. Requires PREMIUM+ tier.","operationId":"batch_intelligence_api_v1_intelligence_batch_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/unified":{"get":{"tags":["Intelligence"],"summary":"Unified Intelligence","description":"Get unified intelligence context — the full AgentHC view.\n\nRequires INSTITUTIONAL tier.  Aggregates data from all (or\ntopic-relevant) intelligence modules via MODULE_EXTRACTORS so it\nworks on any API worker (no unified_mind plugin registry needed).","operationId":"unified_intelligence_api_v1_intelligence_unified_get","parameters":[{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"}},{"name":"depth","in":"query","required":false,"schema":{"type":"string","pattern":"^(quick|standard|deep)$","default":"standard","title":"Depth"}},{"name":"include_prompt","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Prompt"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/content/generate":{"post":{"tags":["Content"],"summary":"Generate Content","description":"Generate a typed long-form market intelligence piece.\n\nBody: ``{\"topic\": \"...\", \"content_type\": \"<see GET /api/v1/content/types>\",\n\"ticker\": \"SPY\"}``. Each content type is synthesised from a fixed set of\nintelligence modules (pre-computed cache) into a Markdown piece with the\ntype's section structure; the response carries the text plus title,\nsummary, key_points, sources_used/sources_missing, key_data and\ndata_as_of. Requires PREMIUM+ tier (INSTITUTIONAL for briefing/regime/\nrisk/alpha/cross-market types). Waits up to ~55s for the queued job;\nif it is still running you get HTTP 202 with a request_id to poll at\nGET /api/v1/claude/result/{request_id}. /content/generate/async returns\nthe handle immediately.","operationId":"generate_content_api_v1_content_generate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/content/types":{"get":{"tags":["Content"],"summary":"Content Types","description":"Catalog of content types accepted by POST /api/v1/content/generate:\ntitle, description, required tier, section structure, target length and\nthe intelligence modules each type is synthesised from.","operationId":"content_types_api_v1_content_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/webhooks/events":{"get":{"tags":["Webhooks"],"summary":"List Webhook Events","description":"List all available webhook event types.","operationId":"list_webhook_events_api_v1_webhooks_events_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/subscribe":{"post":{"tags":["Webhooks"],"summary":"Subscribe Webhook","description":"Subscribe to a webhook event type.","operationId":"subscribe_webhook_api_v1_webhooks_subscribe_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/unsubscribe":{"delete":{"tags":["Webhooks"],"summary":"Unsubscribe Webhook","operationId":"unsubscribe_webhook_api_v1_webhooks_unsubscribe_delete","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/deliveries":{"get":{"tags":["Webhooks"],"summary":"Webhook Deliveries","operationId":"webhook_deliveries_api_v1_webhooks_deliveries_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events/stream":{"get":{"tags":["Webhooks"],"summary":"Event Stream","description":"Open a Server-Sent Events (SSE) stream for real-time market events.\n\nThis is the push alternative to polling `/api/v1/intelligence/`. Connect once,\nreceive events as they happen — regime changes, VIX spikes, correlation breaks,\nflash crash alerts, and more.\n\n**For AI agents**: SSE is simpler than WebSocket. Just `GET` and read the stream.\nAuto-reconnect is built into the SSE spec via `Last-Event-ID`.\n\n**Event types** are the same as webhooks (see `/api/v1/webhooks/events`).\nYour tier determines which events you can receive.\n\n**Example** (curl):\n```\ncurl -N -H \"X-API-Key: your_key\" \\\n  \"https://api.traderhc.com/api/v1/events/stream?types=market.regime_change,market.vix_spike\"\n```\n\n**Example** (Python):\n```python\nimport requests\nresp = requests.get(\n    \"https://api.traderhc.com/api/v1/events/stream\",\n    headers={\"X-API-Key\": \"your_key\"},\n    stream=True,\n)\nfor line in resp.iter_lines():\n    if line and line.startswith(b\"data:\"):\n        event = json.loads(line[5:])\n        print(event)\n```\n\n**Reconnection**: If disconnected, include `Last-Event-ID` header with the last\nreceived event ID to replay missed events.","operationId":"event_stream_api_v1_events_stream_get","parameters":[{"name":"types","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated event types to subscribe to (e.g. market.regime_change,market.vix_spike). Omit for all events your tier allows.","title":"Types"},"description":"Comma-separated event types to subscribe to (e.g. market.regime_change,market.vix_spike). Omit for all events your tier allows."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events/status":{"get":{"tags":["Webhooks"],"summary":"Event Stream Status","description":"Get SSE stream status — available events, active connections, and usage.\n\nNo auth required for basic info. Authenticated agents see their connection count.","operationId":"event_stream_status_api_v1_events_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events/scanner":{"get":{"tags":["Webhooks"],"summary":"Event Scanner Status","description":"Get event scanner status — how the system detects and fires events.\n\nShows scan count, events emitted, current detected state (regime, VIX,\ntail risk, etc.), and cooldown timers.","operationId":"event_scanner_status_api_v1_events_scanner_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/payments/create-invoice":{"post":{"tags":["Payments"],"summary":"Create Invoice","description":"Create a Lightning invoice for tier upgrade or credit purchase.","operationId":"create_invoice_api_v1_payments_create_invoice_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/payments/verify/{payment_hash}":{"get":{"tags":["Payments"],"summary":"Verify Payment","description":"Check if a Lightning payment has been settled.","operationId":"verify_payment_api_v1_payments_verify__payment_hash__get","parameters":[{"name":"payment_hash","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9-]{8,128}$","title":"Payment Hash"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions":{"get":{"tags":["Predictions"],"summary":"List Predictions","description":"View AgentHC's verifiable prediction track record.","operationId":"list_predictions_api_v1_predictions_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(open|resolved|all)$"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/accuracy":{"get":{"tags":["Predictions"],"summary":"Prediction Accuracy","description":"View AgentHC's prediction accuracy stats.","operationId":"prediction_accuracy_api_v1_predictions_accuracy_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sla":{"get":{"tags":["Discovery"],"summary":"Sla Status","description":"Machine-readable SLA: uptime, latency, data freshness, error rates.\n\nNo auth required. Designed for AI agents to programmatically evaluate\nAgentHC's reliability before deciding to spend sats.","operationId":"sla_status_api_v1_sla_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/intelligence/track_record":{"get":{"tags":["Predictions"],"summary":"Track Record","description":"Machine-readable prediction track record.\n\nQueryable accuracy stats so AI agents can programmatically evaluate\nsignal quality before paying. Supports filtering by category,\nconfidence level, and timeframe.","operationId":"track_record_api_v1_intelligence_track_record_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"min_confidence","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Confidence"}},{"name":"days_back","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Days Back"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"^(open|resolved|all)$","default":"all","title":"Status"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trading/day-trade-ideas/track-record":{"get":{"tags":["Intelligence"],"summary":"Get Day Trade Ideas Track Record","description":"FREE aggregate track record of AgentHC's published paper-trade journal.\n\nMachine-readable marketing for the Agentic Day Trade Ideas feed:\nwhole-journal aggregates only (no per-trade events — those are the paid\nfeed). All figures are HYPOTHETICAL paper-trading statistics.","operationId":"get_day_trade_ideas_track_record_api_v1_trading_day_trade_ideas_track_record_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/trading/day-trade-ideas/accept-terms":{"post":{"tags":["Intelligence"],"summary":"Accept Day Trade Ideas Terms","description":"Record this agent's acceptance of the Agentic Day Trade Ideas terms.\n\nThe feed endpoint returns 403 until the CURRENT terms version has been\naccepted. Acceptance is an affirmative agreement that the feed is\neducational journal commentary, not investment advice, and that all\ntrading decisions and liability rest with the subscriber.","operationId":"accept_day_trade_ideas_terms_api_v1_trading_day_trade_ideas_accept_terms_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trading/day-trade-ideas":{"get":{"tags":["Intelligence"],"summary":"Get Day Trade Ideas","description":"Agentic Day Trade Ideas — AgentHC's published paper-trade journal events.\n\nDeclarative, past-tense statements of fact (\"ENTERED\" / \"EXITED\") about\nAgentHC's own hypothetical paper-trading journal, identical for all\nsubscribers. No option prices, no Greeks, no sizing — exits carry\nAgentHC's own paper P&L %% statistic only. Educational commentary, NOT\ninvestment advice or trade recommendations.\n\nAccess (sats-based, operator 2026-07-07):\n  - Lightning day-pass: pay the 402 invoice (USD-pegged, floats with\n    Bitcoin's price) -> L402 macaroon grants 24h access. Paying the\n    invoice constitutes acceptance of the terms in `disclosure`.\n  - OR a registered API key at PREMIUM tier + accepted terms via\n    POST /api/v1/trading/day-trade-ideas/accept-terms.","operationId":"get_day_trade_ideas_api_v1_trading_day_trade_ideas_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"track","in":"query","required":false,"schema":{"type":"string","pattern":"^(main|other|all)$","default":"main","title":"Track"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trading/signals":{"get":{"tags":["Intelligence"],"summary":"Get Trading Signals","description":"Get AgentHC's current trading signals based on heavy-cycle analysis.\n\nRequires INSTITUTIONAL tier. Returns signals from the alpha signal engine\ncombining all intelligence modules into actionable trade ideas.\n\nSignals include: direction, confidence, edge estimate, and risk parameters.\nThese are ANALYSIS signals, NOT financial advice or recommendations.","operationId":"get_trading_signals_api_v1_trading_signals_get","parameters":[{"name":"strategy","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(all|fed_macro|crypto|convergence|composite)$"},{"type":"null"}],"title":"Strategy"}},{"name":"min_edge","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":0.5,"minimum":0.01},{"type":"null"}],"title":"Min Edge"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trading/regime":{"get":{"tags":["Intelligence"],"summary":"Get Market Regime","description":"Get current market regime assessment for trading context.\n\nReturns regime classification, transition probabilities, and\nrecommended asset class tilts. INSTITUTIONAL tier only.","operationId":"get_market_regime_api_v1_trading_regime_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/ask":{"post":{"tags":["Intelligence"],"summary":"Ask Intelligence","description":"Ask any market question in natural language — Intelligence-as-a-Service.\n\nReturns synthesized intelligence with conviction score, regime context,\nand supporting data from all available intelligence modules.\n\nThree depth levels control analysis breadth and cost:\n- **quick** (200 sats): Fast directional read (2-4 sentences, ~25s cap)\n- **standard** (500 sats): Balanced analysis with supporting data (~40s cap)\n- **deep** (1000 sats): Comprehensive multi-module synthesis (~55s cap)\n\nThis is the WAITING path: the job runs on the shared synthesis queue and\nthe reply is the finished synthesis when it completes inside the depth's\nwait window; otherwise you get HTTP 202 with a request_id to poll at\nGET /api/v1/claude/result/{request_id} (the job keeps running). For\nlatency-tolerant callers use POST /api/v1/intelligence/ask/async directly.\n\nRequest body: `{\"question\": \"Should I be risk-on or risk-off?\", \"depth\": \"standard\"}`","operationId":"ask_intelligence_api_v1_intelligence_ask_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/parallels":{"get":{"tags":["Intelligence"],"summary":"Get Historical Parallels","description":"Find historical market episodes matching current conditions.\n\nSearches 30 curated episodes spanning 1929-2024 for analogous conditions.\nReturns ranked parallels with similarity scores, what happened next,\ninvestment implications, and Bitcoin impact assessment.\n\nLeave `conditions` empty to auto-detect from live market data.","operationId":"get_historical_parallels_api_v1_intelligence_parallels_get","parameters":[{"name":"conditions","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated condition tags (e.g., 'credit_widening,vix_spike'). Leave empty for auto-detection.","title":"Conditions"},"description":"Comma-separated condition tags (e.g., 'credit_widening,vix_spike'). Leave empty for auto-detection."},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":15,"minimum":1,"description":"Number of top parallels to return","default":5,"title":"Top N"},"description":"Number of top parallels to return"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/consensus":{"get":{"tags":["Intelligence"],"summary":"Get Agent Consensus","description":"Aggregated AI agent attention signal.\n\nTracks what intelligence modules agents query most, what topics trend,\nand derives a market sentiment signal from collective agent behavior.\n\nReturns: trending topics, attention shifts, query patterns, and\na consensus signal (risk_on, risk_off, bullish, bearish, neutral, uncertain).","operationId":"get_agent_consensus_api_v1_intelligence_consensus_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"Lookback window in hours (1-168)","default":24,"title":"Hours"},"description":"Lookback window in hours (1-168)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/{module_name}":{"get":{"tags":["Intelligence"],"summary":"Get Intelligence","description":"Query a specific intelligence module.\n\nFormat modes for AI agents:\n- **full** (default): Complete structured JSON with all metadata and data_sources attribution.\n- **compact**: Flat key-value pairs, minimal nesting. ~60% fewer tokens for context-window efficiency.\n- **prompt**: Pre-formatted text for direct LLM system prompt injection.\n- **agent**: Agent-optimized envelope with actionable signals (direction, confidence, urgency),\n  delta tracking (what changed since last query), temporal context, and suggested follow-up actions.\n\nPayment options:\n- **API key**: Register at POST /api/v1/agents/register, include X-API-Key header.\n- **L402 Lightning**: No registration needed. Pay per-request with Lightning Network.\n  Use `lnget` CLI for automatic 402 handling, or pay manually and include\n  `Authorization: L402 <macaroon>:<preimage>` header.\n\nAgent-native features in every response:\n- **related_modules**: Suggested modules with reasons (autonomous cross-market upsell)\n- **full_data**: Every query returns full data — no field degradation\n\nAccess model: All modules accessible at every tier. Free tier = 1 query/day.\nPay to query more. The data sells itself.","operationId":"get_intelligence_api_v1_intelligence__module_name__get","parameters":[{"name":"module_name","in":"path","required":true,"schema":{"type":"string","title":"Module Name"}},{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Ticker"}},{"name":"include_prompt","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Prompt"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(full|compact|prompt|agent)$","default":"full","title":"Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alerts/subscribe":{"post":{"summary":"Subscribe Alert Endpoint","description":"Create a conditional alert subscription.\n\nBody: {\n    \"conditions\": [{\"field\": \"vix\", \"operator\": \">\", \"value\": 30}],\n    \"callback_url\": \"https://...\",  // optional\n    \"name\": \"VIX Spike Alert\",\n    \"logic\": \"AND\",  // AND or OR\n    \"cooldown\": 3600,  // seconds between triggers\n    \"max_triggers\": 100,\n    \"expires_in_seconds\": 0  // 0 = never expires\n}","operationId":"subscribe_alert_endpoint_api_v1_alerts_subscribe_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alerts":{"get":{"summary":"List Alerts Endpoint","description":"List all alert subscriptions for the authenticated agent.","operationId":"list_alerts_endpoint_api_v1_alerts_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alerts/{alert_id}":{"delete":{"summary":"Delete Alert Endpoint","description":"Remove an alert subscription.","operationId":"delete_alert_endpoint_api_v1_alerts__alert_id__delete","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alerts/fields":{"get":{"summary":"Alert Fields Endpoint","description":"List all available fields for alert conditions.","operationId":"alert_fields_endpoint_api_v1_alerts_fields_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alert-packages":{"get":{"tags":["Alert Packages"],"summary":"List Alert Packages","description":"List all available named alert packages with pricing.","operationId":"list_alert_packages_api_v1_alert_packages_get","parameters":[{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by tier: premium or institutional","title":"Tier"},"description":"Filter by tier: premium or institutional"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alert-packages/{package_id}/subscribe":{"post":{"tags":["Alert Packages"],"summary":"Subscribe To Package","description":"Subscribe to a named alert package.\n\nBody: {\n    \"delivery_channels\": [\"webhook\", \"discord\"],\n    \"callback_url\": \"https://...\",\n    \"discord_webhook_url\": \"https://...\",\n    \"min_urgency\": \"low\"\n}","operationId":"subscribe_to_package_api_v1_alert_packages__package_id__subscribe_post","parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alert-packages/{package_id}/unsubscribe":{"delete":{"tags":["Alert Packages"],"summary":"Unsubscribe From Package","description":"Unsubscribe from a named alert package.","operationId":"unsubscribe_from_package_api_v1_alert_packages__package_id__unsubscribe_delete","parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alert-packages/my":{"get":{"tags":["Alert Packages"],"summary":"List My Packages","description":"List all packages the authenticated agent is subscribed to.","operationId":"list_my_packages_api_v1_alert_packages_my_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/alert-packages/{package_id}/history":{"get":{"tags":["Alert Packages"],"summary":"Get Package Alert History","description":"Get recent alerts from a package.","operationId":"get_package_alert_history_api_v1_alert_packages__package_id__history_get","parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/referrals/code":{"get":{"tags":["Referrals"],"summary":"Get Referral Code","description":"Get your referral code and share instructions.","operationId":"get_referral_code_api_v1_referrals_code_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/referrals/stats":{"get":{"tags":["Referrals"],"summary":"Get Referral Stats","description":"Get your referral stats: agents referred, sats earned, credits available.","operationId":"get_referral_stats_api_v1_referrals_stats_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/referrals/credits":{"get":{"tags":["Referrals"],"summary":"Get Referral Credits","description":"Get your available referral credit balance.","operationId":"get_referral_credits_api_v1_referrals_credits_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/commitments/plans":{"get":{"tags":["Subscriptions"],"summary":"List Commitment Plans","description":"List available volume commitment plans with discounts.\n\nCommit to daily query volumes for 20-40% off. Predictable costs\nfor loop-based agents running on fixed intervals.","operationId":"list_commitment_plans_api_v1_commitments_plans_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/commitments/activate":{"post":{"tags":["Subscriptions"],"summary":"Activate Commitment","description":"Activate a volume commitment plan.","operationId":"activate_commitment_api_v1_commitments_activate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/commitments/status":{"get":{"tags":["Subscriptions"],"summary":"Commitment Status","description":"Get your current volume commitment status.","operationId":"commitment_status_api_v1_commitments_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/subscriptions/plans":{"get":{"tags":["Subscriptions"],"summary":"List Subscription Plans","description":"List available subscription plans with burst credits.\n\nMonthly subscribers get base allocation + burst credits for\nhigh-volatility market events (flash crashes, VIX spikes).","operationId":"list_subscription_plans_api_v1_subscriptions_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/subscriptions/subscribe":{"post":{"tags":["Subscriptions"],"summary":"Subscribe","description":"Activate a subscription with burst credits.","operationId":"subscribe_api_v1_subscriptions_subscribe_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/subscriptions/status":{"get":{"tags":["Subscriptions"],"summary":"Subscription Status","description":"Get your subscription status including burst credit availability.","operationId":"subscription_status_api_v1_subscriptions_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sampling/status":{"get":{"tags":["Intelligence"],"summary":"Sampling Status","description":"Get your module sampling status — what you've tried today.","operationId":"sampling_status_api_v1_sampling_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrations/openai/tools":{"get":{"tags":["Integrations"],"summary":"Openai Tools","description":"Get ready-to-paste OpenAI function-calling tools JSON.\n\nDrop this directly into openai.chat.completions.create(tools=...).\nFilter by tier to only get tools your agent can access.","operationId":"openai_tools_api_v1_integrations_openai_tools_get","parameters":[{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(free|premium|institutional)$"},{"type":"null"}],"title":"Tier"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrations/openai/config":{"get":{"tags":["Integrations"],"summary":"Openai Config","description":"Get complete OpenAI integration config with tools, system prompt, and example code.","operationId":"openai_config_api_v1_integrations_openai_config_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrations/langchain/config":{"get":{"tags":["Integrations"],"summary":"Langchain Config","description":"Get LangChain toolkit configuration and ready-to-use code.","operationId":"langchain_config_api_v1_integrations_langchain_config_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/integrations/crewai/config":{"get":{"tags":["Integrations"],"summary":"Crewai Config","description":"Get CrewAI agent templates and tool configuration.","operationId":"crewai_config_api_v1_integrations_crewai_config_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/templates":{"get":{"tags":["Integrations"],"summary":"List Templates","description":"List pre-built agent templates that consume AgentHC's API.\n\nEach template is a complete working agent configuration with code,\nmodule dependencies, estimated usage, and implementation instructions.","operationId":"list_templates_api_v1_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/templates/{template_name}":{"get":{"tags":["Integrations"],"summary":"Get Template","description":"Get a specific agent template with full implementation code.","operationId":"get_template_api_v1_templates__template_name__get","parameters":[{"name":"template_name","in":"path","required":true,"schema":{"type":"string","title":"Template Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/usage":{"get":{"tags":["Usage"],"summary":"Get Usage","operationId":"get_usage_api_v1_usage_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/token/stats":{"get":{"tags":["Token"],"summary":"Token Stats","description":"Public $INTELL token statistics — price, holders, volume, burns.\n\nNo authentication required. Data sourced from Jupiter, DexScreener, and Helius.","operationId":"token_stats_api_v1_token_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/token/burns":{"get":{"tags":["Token"],"summary":"Token Burns","description":"Public burn history for $INTELL — transparency endpoint.\n\nNo authentication required. Shows all buyback and burn transactions.","operationId":"token_burns_api_v1_token_burns_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/detailed":{"get":{"tags":["Discovery"],"summary":"Health Detailed","description":"Detailed health check for external monitoring services.\n\nNo auth required — designed for UptimeRobot, Pingdom, etc.\nReturns system status, memory, disk without sensitive business data.","operationId":"health_detailed_health_detailed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/content/generate/async":{"post":{"tags":["Content"],"summary":"Generate Content Async","description":"Queue content generation for async processing. Returns request_id.\n\nReturns immediately with a request_id. Poll the result URL for completion.\n\nRequires PREMIUM+ tier.","operationId":"generate_content_async_api_v1_content_generate_async_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/intelligence/ask/async":{"post":{"tags":["Intelligence"],"summary":"Ask Intelligence Async","description":"Queue an intelligence question for async processing. Returns request_id.\n\nSame as /api/v1/intelligence/ask but non-blocking. Poll for result.\n\nRequires INSTITUTIONAL tier.","operationId":"ask_intelligence_async_api_v1_intelligence_ask_async_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/claude/result/{request_id}":{"get":{"tags":["Intelligence"],"summary":"Get Claude Result","description":"Poll for an async Claude request result.\n\nReturns status: queued, processing, completed, or failed.\nWhen completed, the result field contains the full response.\n\nThe /api/v1/grok/result/{request_id} path is preserved as a hidden alias\nfor backward compatibility with existing clients; new integrations should\nuse /api/v1/claude/result/{request_id}.","operationId":"get_claude_result_api_v1_claude_result__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/dashboard":{"get":{"tags":["Discovery"],"summary":"Public Dashboard","description":"Comprehensive system health dashboard.\n\nAggregates system metrics, service uptime, intelligence module health,\nAPI request stats, agent summary, recent alert counts, and current\nmarket regime into a single response. Individual section failures are\nisolated and will not break the overall endpoint.","operationId":"public_dashboard_api_v1_dashboard_get","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"},"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":"Discovery","description":"Service discovery, pricing, and module catalog"},{"name":"Agents","description":"Agent registration, authentication, and key management"},{"name":"Intelligence","description":"Query market intelligence modules"},{"name":"Content","description":"AI-generated market commentary"},{"name":"Webhooks","description":"Real-time market event subscriptions"},{"name":"Payments","description":"Bitcoin Lightning payment management"},{"name":"Predictions","description":"Verifiable prediction track record"},{"name":"Referrals","description":"Agent-to-agent referral system"},{"name":"Subscriptions","description":"Volume commitments and subscriptions"},{"name":"Integrations","description":"Framework integration toolkits"},{"name":"Usage","description":"Usage stats and rate limit info"}]}