{"openapi":"3.1.0","info":{"title":"HashA2A — Agent-to-Agent Intelligence Layer","description":"A decentralized data marketplace where AI agents buy verified multi-oracle intelligence via HBAR (HIP-991) or USDC (x402/AP2).\n\n## Capabilities\n- **OracleHub**: Multi-oracle prices (Pyth, CoinGecko, Chainlink)\n- **Arbitrage Engine**: Cross-oracle spread detection\n- **A2A Protocol**: Google A2A compliant, JSON-RPC 2.0, SSE streaming\n- **Deep Research**: Web search + AI analysis (OpenAI web_search)\n- **MCP Server**: 10 tools for Claude/Cursor/LangChain\n- **Auth**: Ephemeral JWT tokens + AP2 mandates\n\n## Payment\nUSDC prices are fixed. HBAR prices update in real-time from CoinGecko.\n\n## Agent Discovery\n`/.well-known/agent.json` · `/llms.txt` · `/mcp/`\n\n## Links\n[GitHub](https://github.com/ymiydev-prog/HashA2A) · [Dashboard](/dashboard) · [Oracle Dashboard](/dashboard/oracles) · [Task Dashboard](/dashboard/tasks) · [X](https://x.com/hasha2a)","contact":{"name":"HashA2A","url":"https://github.com/ymiydev-prog/HashA2A"},"license":{"name":"MIT","url":"https://github.com/ymiydev-prog/HashA2A/blob/main/LICENSE"},"version":"0.2.0"},"paths":{"/api/v1/requests":{"post":{"tags":["requests"],"summary":"Create Request","operationId":"create_request_api_v1_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/requests/{request_id}":{"get":{"tags":["requests"],"summary":"Get Request Result","operationId":"get_request_result_api_v1_requests__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/providers":{"get":{"tags":["providers"],"summary":"List Providers","operationId":"list_providers_api_v1_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProviderCapability"},"type":"array","title":"Response List Providers Api V1 Providers Get"}}}}}}},"/api/v1/providers/{provider_id}":{"get":{"tags":["providers"],"summary":"Get Provider","operationId":"get_provider_api_v1_providers__provider_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCapability"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/providers/{provider_id}/stake":{"post":{"tags":["providers"],"summary":"Stake Provider","operationId":"stake_provider_api_v1_providers__provider_id__stake_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/providers/{provider_id}/unstake":{"post":{"tags":["providers"],"summary":"Unstake Provider","operationId":"unstake_provider_api_v1_providers__provider_id__unstake_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/profile":{"get":{"tags":["agent"],"summary":"Get Agent Profile","operationId":"get_agent_profile_api_v1_agent_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfile"}}}}}}},"/api/v1/agent/health":{"get":{"tags":["agent"],"summary":"Get Health Check","operationId":"get_health_check_api_v1_agent_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentHealthCheck"}}}}}}},"/api/v1/agent/broadcast":{"post":{"tags":["agent"],"summary":"Broadcast Presence","operationId":"broadcast_presence_api_v1_agent_broadcast_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agent/register-hol":{"post":{"tags":["agent"],"summary":"Register In Hol","operationId":"register_in_hol_api_v1_agent_register_hol_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agent/topics":{"get":{"tags":["agent"],"summary":"Get Topics","operationId":"get_topics_api_v1_agent_topics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agent/discovery":{"get":{"tags":["agent"],"summary":"Discover Agents","description":"Discover agents in the Hedera ecosystem.\nReturns agents from the AgentDirectory (discovered via HOL Registry)\nplus the current agent itself.","operationId":"discover_agents_api_v1_agent_discovery_get","parameters":[{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter agents by tag","title":"Tag"},"description":"Filter agents by tag"},{"name":"chain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by supported chain","title":"Chain"},"description":"Filter by supported chain"},{"name":"min_trust","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"Minimum trust score","title":"Min Trust"},"description":"Minimum trust score"},{"name":"presence","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by presence: online, offline","title":"Presence"},"description":"Filter by presence: online, offline"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/handshake/{agent_id}":{"post":{"tags":["agent"],"summary":"Initiate Handshake","description":"Initiate a handshake with another agent.","operationId":"initiate_handshake_api_v1_agent_handshake__agent_id__post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/connections":{"get":{"tags":["agent"],"summary":"Get Connections","description":"List all agent connections and their states.","operationId":"get_connections_api_v1_agent_connections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agent/message/{agent_id}":{"post":{"tags":["agent"],"summary":"Send Message","description":"Send a direct message to another agent.","operationId":"send_message_api_v1_agent_message__agent_id__post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/messages":{"get":{"tags":["agent"],"summary":"Get Messages","description":"Get message log.","operationId":"get_messages_api_v1_agent_messages_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"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"}}}}}}},"/api/v1/agent/directory/stats":{"get":{"tags":["agent"],"summary":"Get Directory Stats","description":"Get agent directory statistics.","operationId":"get_directory_stats_api_v1_agent_directory_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/auctions/create":{"post":{"tags":["auctions"],"summary":"Create Auction","operationId":"create_auction_api_v1_auctions_create_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auctions/{request_id}":{"get":{"tags":["auctions"],"summary":"Get Auction","operationId":"get_auction_api_v1_auctions__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/staking/{provider_id}/slash":{"post":{"tags":["staking"],"summary":"Slash Provider","operationId":"slash_provider_api_v1_staking__provider_id__slash_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/staking/history":{"get":{"tags":["staking"],"summary":"Get Slash History","operationId":"get_slash_history_api_v1_staking_history_get","parameters":[{"name":"provider_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/staking/{provider_id}/risk":{"get":{"tags":["staking"],"summary":"Get Provider Risk","operationId":"get_provider_risk_api_v1_staking__provider_id__risk_get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ws/stats":{"get":{"tags":["websocket"],"summary":"Get Websocket Stats","operationId":"get_websocket_stats_ws_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/requests/aggregate":{"post":{"tags":["aggregate"],"summary":"Create Aggregate Request","operationId":"create_aggregate_request_requests_aggregate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/requests/aggregate/{request_id}":{"get":{"tags":["aggregate"],"summary":"Get Aggregate Result","operationId":"get_aggregate_result_requests_aggregate__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research":{"post":{"tags":["research"],"summary":"Create Research","operationId":"create_research_research_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/{request_id}":{"get":{"tags":["research"],"summary":"Get Research Result","operationId":"get_research_result_research__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks":{"post":{"tags":["tasks"],"summary":"Create Task","operationId":"create_task_api_v1_tasks_post","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"hasha2a","title":"Agent Id"}},{"name":"context_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["tasks"],"summary":"List Tasks","operationId":"list_tasks_api_v1_tasks_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"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"}}}}}}},"/api/v1/tasks/{task_id}":{"get":{"tags":["tasks"],"summary":"Get Task","operationId":"get_task_api_v1_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/parts":{"post":{"tags":["tasks"],"summary":"Add Part","operationId":"add_part_api_v1_tasks__task_id__parts_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePart"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/transition":{"post":{"tags":["tasks"],"summary":"Transition Task","operationId":"transition_task_api_v1_tasks__task_id__transition_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/complete":{"post":{"tags":["tasks"],"summary":"Complete Task","operationId":"complete_task_api_v1_tasks__task_id__complete_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/artifacts":{"post":{"tags":["tasks"],"summary":"Add Artifact","operationId":"add_artifact_api_v1_tasks__task_id__artifacts_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MessagePart"},"title":"Parts"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["tasks"],"summary":"List Artifacts","operationId":"list_artifacts_api_v1_tasks__task_id__artifacts_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/artifacts/upload":{"post":{"tags":["tasks"],"summary":"Upload Artifact","operationId":"upload_artifact_api_v1_tasks__task_id__artifacts_upload_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_artifact_api_v1_tasks__task_id__artifacts_upload_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/artifacts/{artifact_id}":{"get":{"tags":["tasks"],"summary":"Get Artifact","operationId":"get_artifact_api_v1_tasks_artifacts__artifact_id__get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/artifacts/{artifact_id}/download":{"get":{"tags":["tasks"],"summary":"Download Artifact","operationId":"download_artifact_api_v1_tasks_artifacts__artifact_id__download_get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/{task_id}/summary":{"get":{"tags":["tasks"],"summary":"Get Task Summary","operationId":"get_task_summary_api_v1_tasks__task_id__summary_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/context":{"post":{"tags":["tasks"],"summary":"Create Context","operationId":"create_context_api_v1_tasks_context_post","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"hasha2a","title":"Agent Id"}},{"name":"parent_context_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Context Id"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/context/{context_id}":{"get":{"tags":["tasks"],"summary":"Get Context","operationId":"get_context_api_v1_tasks_context__context_id__get","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/context/{context_id}/summary":{"get":{"tags":["tasks"],"summary":"Get Context Summary","operationId":"get_context_summary_api_v1_tasks_context__context_id__summary_get","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/context/{context_id}/fork":{"post":{"tags":["tasks"],"summary":"Fork Context","operationId":"fork_context_api_v1_tasks_context__context_id__fork_post","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tasks/context/{context_id}/history":{"get":{"tags":["tasks"],"summary":"Get Context History","operationId":"get_context_history_api_v1_tasks_context__context_id__history_get","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"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/tasks/contexts":{"get":{"tags":["tasks"],"summary":"List Contexts","operationId":"list_contexts_api_v1_tasks_contexts_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"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/auth/token":{"post":{"tags":["auth"],"summary":"Request Token","operationId":"request_token_api_v1_auth_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/verify":{"post":{"tags":["auth"],"summary":"Verify Auth Token","operationId":"verify_auth_token_api_v1_auth_verify_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","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/auth/mandates":{"get":{"tags":["auth"],"summary":"List Mandates","operationId":"list_mandates_api_v1_auth_mandates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["auth"],"summary":"Create Mandate","operationId":"create_mandate_api_v1_auth_mandates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MandateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/mandates/{mandate_id}":{"get":{"tags":["auth"],"summary":"Get Mandate","operationId":"get_mandate_api_v1_auth_mandates__mandate_id__get","parameters":[{"name":"mandate_id","in":"path","required":true,"schema":{"type":"string","title":"Mandate Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/mandates/{mandate_id}/authorize":{"post":{"tags":["auth"],"summary":"Authorize Mandate","operationId":"authorize_mandate_api_v1_auth_mandates__mandate_id__authorize_post","parameters":[{"name":"mandate_id","in":"path","required":true,"schema":{"type":"string","title":"Mandate Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/rpc":{"post":{"tags":["a2a"],"summary":"A2A Rpc","operationId":"a2a_rpc_api_v1_a2a_rpc_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/a2a/rpc/stream":{"post":{"tags":["a2a"],"summary":"A2A Rpc Stream","description":"SSE streaming endpoint for message/stream and tasks/subscribe.","operationId":"a2a_rpc_stream_api_v1_a2a_rpc_stream_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/feeds/prices":{"post":{"tags":["feeds"],"summary":"Get Prices","operationId":"get_prices_api_v1_feeds_prices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feeds/arbitrage":{"post":{"tags":["feeds"],"summary":"Scan Arbitrage","operationId":"scan_arbitrage_api_v1_feeds_arbitrage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArbitrageScanQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feeds/verify/{asset}":{"get":{"tags":["feeds"],"summary":"Verify Arbitrage","operationId":"verify_arbitrage_api_v1_feeds_verify__asset__get","parameters":[{"name":"asset","in":"path","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feeds/x402/verify":{"post":{"tags":["feeds"],"summary":"Verify X402 Payment","operationId":"verify_x402_payment_api_v1_feeds_x402_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feeds/x402/hedera/verify":{"post":{"tags":["feeds"],"summary":"Verify X402 Hedera Payment","operationId":"verify_x402_hedera_payment_api_v1_feeds_x402_hedera_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feeds/x402/manifest":{"get":{"tags":["feeds"],"summary":"X402 Manifest","operationId":"x402_manifest_api_v1_feeds_x402_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/feeds/pricing":{"get":{"tags":["feeds"],"summary":"Get Pricing","description":"Real-time pricing: USDC fixed, HBAR calculated from live HBAR/USD rate.","operationId":"get_pricing_api_v1_feeds_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AgentHealthCheck":{"properties":{"status":{"type":"string","title":"Status","default":"healthy"},"uptime_seconds":{"type":"number","title":"Uptime Seconds","default":0},"started_at":{"type":"string","title":"Started At"},"version":{"type":"string","title":"Version"},"providers_count":{"type":"integer","title":"Providers Count"},"total_requests_served":{"type":"integer","title":"Total Requests Served"},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms"},"last_request_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Request At"},"hedera_connected":{"type":"boolean","title":"Hedera Connected","default":false},"mirror_node_reachable":{"type":"boolean","title":"Mirror Node Reachable","default":false},"agents_discovered":{"type":"integer","title":"Agents Discovered","default":0},"online_agents":{"type":"integer","title":"Online Agents","default":0}},"type":"object","required":["started_at","version","providers_count","total_requests_served"],"title":"AgentHealthCheck"},"AgentProfile":{"properties":{"agent_name":{"type":"string","title":"Agent Name"},"agent_version":{"type":"string","title":"Agent Version"},"description":{"type":"string","title":"Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"hol_registry_topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hol Registry Topic"},"inbound_topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inbound Topic"},"outbound_topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outbound Topic"},"treasury_account":{"type":"string","title":"Treasury Account"},"supported_providers":{"items":{"$ref":"#/components/schemas/ProviderCapability"},"type":"array","title":"Supported Providers"},"uptime_pct":{"type":"number","title":"Uptime Pct","default":100.0},"total_requests_served":{"type":"integer","title":"Total Requests Served","default":0},"last_broadcast":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Broadcast"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms"},"active_connections":{"type":"integer","title":"Active Connections","default":0}},"type":"object","required":["agent_name","agent_version","description","tags","treasury_account","supported_providers"],"title":"AgentProfile"},"AggregateRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Query/topic to aggregate across providers"},"providers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Providers","description":"Provider IDs to query, or null for all"},"max_cost_hbar":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Max Cost Hbar"},"quality_threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Quality Threshold"}},"type":"object","required":["query"],"title":"AggregateRequest"},"ArbitrageScanQuery":{"properties":{"min_spread":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Min Spread","description":"Minimum spread percentage"}},"type":"object","title":"ArbitrageScanQuery"},"Body_upload_artifact_api_v1_tasks__task_id__artifacts_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_artifact_api_v1_tasks__task_id__artifacts_upload_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MandateRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent requesting spending authority"},"mandate_type":{"type":"string","pattern":"^(cart|intent|payment)$","title":"Mandate Type","default":"intent"},"max_spend_usdc":{"type":"number","minimum":0.01,"title":"Max Spend Usdc","description":"Maximum spend in USDC","default":10.0},"ttl":{"type":"integer","maximum":2592000.0,"minimum":300.0,"title":"Ttl","description":"Mandate validity in seconds","default":86400}},"type":"object","required":["agent_id"],"title":"MandateRequest"},"MessagePart":{"properties":{"type":{"$ref":"#/components/schemas/PartType"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"file_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Uri"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["type"],"title":"MessagePart"},"PartType":{"type":"string","enum":["text","data","file"],"title":"PartType"},"PriceQuery":{"properties":{"asset":{"type":"string","title":"Asset","description":"Asset symbol, e.g. BTC/USD, ETH/USD"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Oracle source: pyth, coingecko, defillama, or all"}},"type":"object","required":["asset"],"title":"PriceQuery"},"ProviderCapability":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"cost_hbar":{"type":"number","title":"Cost Hbar"},"parameters_schema":{"additionalProperties":true,"type":"object","title":"Parameters Schema"},"trust_score":{"type":"number","title":"Trust Score","default":50.0},"total_requests":{"type":"integer","title":"Total Requests","default":0},"success_rate":{"type":"number","title":"Success Rate","default":1.0},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms"},"staked_hbar":{"type":"number","title":"Staked Hbar","default":0.0}},"type":"object","required":["provider_id","name","description","cost_hbar","parameters_schema"],"title":"ProviderCapability"},"QueryRequest":{"properties":{"provider_id":{"type":"string","title":"Provider Id","description":"DataProvider ID, e.g. 'polymarket'"},"params":{"additionalProperties":true,"type":"object","title":"Params","description":"Provider-specific parameters"},"quality_threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Quality Threshold"},"max_cost_hbar":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Max Cost Hbar"}},"type":"object","required":["provider_id"],"title":"QueryRequest"},"ResearchRequest":{"properties":{"question":{"type":"string","title":"Question","description":"Research question to investigate"},"max_cost_hbar":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Max Cost Hbar"}},"type":"object","required":["question"],"title":"ResearchRequest"},"TokenRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","default":"hasha2a"},"ttl":{"type":"integer","maximum":3600.0,"minimum":60.0,"title":"Ttl","description":"Token validity in seconds","default":300},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes","description":"Requested scopes","default":["read"]}},"type":"object","title":"TokenRequest"},"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"}}}}