{"openapi":"3.1.0","info":{"title":"SuperHaoski — Exchange Risk & Margin Intelligence","description":"Specialist AI agent for crypto exchange risk, margin models, and derivatives market structure.","version":"5.2.0"},"paths":{"/{full_path}":{"options":{"summary":"Options Preflight","operationId":"options_preflight__full_path__options","parameters":[{"name":"full_path","in":"path","required":true,"schema":{"type":"string","title":"Full Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/icon.png":{"get":{"summary":"Icon Png","operationId":"icon_png_icon_png_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/for-agents":{"get":{"summary":"For Agents","operationId":"for_agents_for_agents_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/agentskills/superhaoski-x402/SKILL.md":{"get":{"summary":"Superhaoski Agentskill","operationId":"superhaoski_agentskill_agentskills_superhaoski_x402_SKILL_md_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agentskills/superhaoski-x402":{"get":{"summary":"Superhaoski Agentskill Short","operationId":"superhaoski_agentskill_short_agentskills_superhaoski_x402_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/skills/superhaoski-x402/SKILL.md":{"get":{"summary":"Superhaoski Hermes Skill","operationId":"superhaoski_hermes_skill_skills_superhaoski_x402_SKILL_md_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/skills/superhaoski-x402":{"get":{"summary":"Superhaoski Hermes Skill Short","operationId":"superhaoski_hermes_skill_short_skills_superhaoski_x402_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agentskills/superhaoski-x402.zip":{"get":{"summary":"Superhaoski Agentskill Zip","operationId":"superhaoski_agentskill_zip_agentskills_superhaoski_x402_zip_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Agent Discovery","operationId":"agent_discovery__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402.json":{"get":{"summary":"X402 Discovery","operationId":"x402_discovery__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/manifest":{"get":{"summary":"Manifest","operationId":"manifest_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManifestResponse"}}}}}}},"/pricing":{"get":{"summary":"Pricing","operationId":"pricing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/query":{"post":{"summary":"Query","operationId":"query_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/query/credit":{"post":{"summary":"Query Credit","operationId":"query_credit_query_credit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditQueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/query/free":{"post":{"summary":"Query Free","operationId":"query_free_query_free_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/passes/pro":{"post":{"summary":"Purchase Mcp Pro Pass","operationId":"purchase_mcp_pro_pass_mcp_passes_pro_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/passes/advanced-pro":{"post":{"summary":"Purchase Mcp Advanced Pro Pass","operationId":"purchase_mcp_advanced_pro_pass_mcp_passes_advanced_pro_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/paid":{"get":{"summary":"Mcp Paid Metadata","description":"Paid MCP metadata for agent-to-agent pass-gated tool calls.","operationId":"mcp_paid_metadata_mcp_paid_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Mcp Paid Rpc","description":"Pass-gated MCP endpoint for paid agent-to-agent calls.\n\ninitialize and tools/list are free for discovery. tools/call ask_expert requires\na valid Pro or Advanced Pro pass token.","operationId":"mcp_paid_rpc_mcp_paid_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"summary":"Mcp Metadata","description":"Human/machine-readable MCP endpoint metadata.","operationId":"mcp_metadata_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Mcp Rpc","description":"Minimal MCP JSON-RPC endpoint exposing ask_expert as a native tool.\n\nSupports initialize, notifications/initialized, tools/list, and tools/call.\nPayment enforcement is intentionally left to the HTTP/payment layer; for now\nMCP tool calls are tracked as payment_method=mcp_free.","operationId":"mcp_rpc_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/receipts":{"get":{"summary":"List Receipts","operationId":"list_receipts_receipts_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","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"}}}}}}}},"components":{"schemas":{"ChatMessage":{"properties":{"role":{"type":"string","title":"Role","description":"user or assistant"},"content":{"type":"string","maxLength":4000,"title":"Content"}},"type":"object","required":["role","content"],"title":"ChatMessage"},"CreditQueryRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Natural language query"},"top_k":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Top K","description":"Number of retrieved knowledge chunks/passages used as answer context. Optional; defaults to 5. Min 1, max 20. Values outside 1-20 are rejected with HTTP 422 after request validation. Does not change the per-query price.","default":5},"wallet_address":{"type":"string","title":"Wallet Address","description":"Wallet address holding NQC tokens"},"signature":{"type":"string","title":"Signature","description":"Signature proving wallet ownership (EIP-191 or EIP-712)"},"history":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array"},{"type":"null"}],"title":"History","description":"Recent chat turns for conversational continuity"}},"type":"object","required":["query","wallet_address","signature"],"title":"CreditQueryRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ManifestResponse":{"properties":{"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"description":{"type":"string","title":"Description"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"pricing":{"additionalProperties":true,"type":"object","title":"Pricing"},"payment_methods":{"additionalProperties":true,"type":"object","title":"Payment Methods"},"endpoints":{"additionalProperties":true,"type":"object","title":"Endpoints"}},"type":"object","required":["name","version","description","capabilities","pricing","payment_methods","endpoints"],"title":"ManifestResponse"},"QueryRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Natural language query about exchange risk, margin models, liquidation, derivatives market structure"},"top_k":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Top K","description":"Number of retrieved knowledge chunks/passages used as answer context. Optional; defaults to 5. Min 1, max 20. Values outside 1-20 are rejected with HTTP 422 after request validation. Does not change the per-query price.","default":5},"caller":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller","description":"Caller agent ID (for receipt tracking)"},"history":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array"},{"type":"null"}],"title":"History","description":"Recent chat turns for conversational continuity"}},"type":"object","required":["query"],"title":"QueryRequest"},"QueryResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer"},"receipt_hash":{"type":"string","title":"Receipt Hash"},"timestamp":{"type":"number","title":"Timestamp"},"chunks_searched":{"type":"integer","title":"Chunks Searched"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"}},"type":"object","required":["request_id","receipt_hash","timestamp","chunks_searched"],"title":"QueryResponse"},"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"}}}}