{"openapi":"3.1.0","info":{"title":"x402 Oracle","version":"0.1.0","description":"402 is the answer. The Oracle is how you ask.","contact":{"email":"kwizzlesurp10@gmail.com"},"x-guidance":"Free GET /api/health and /api/pricing. Paid consults: POST /api/consult/oracle_ask with JSON {question}. Unpaid probes return HTTP 402 and PAYMENT-REQUIRED (x402 v2, Base USDC). After payment, retry with PAYMENT-SIGNATURE. MCP streamable HTTP at /mcp. No private keys."},"servers":[{"url":"https://x402orcle.vercel.app","description":"Production Server (Base Mainnet)"}],"tags":[{"name":"health","description":"Liveness and seller posture checks"},{"name":"pricing","description":"Pricing menu and connection instructions"},{"name":"oracle","description":"Paid expert consultation tools"},{"name":"a2a","description":"Autonomous outcome-driven tasks"},{"name":"mcp","description":"Model Context Protocol streamable HTTP gateway"},{"name":"discovery","description":"Machine discovery manifests and agent cards"},{"name":"funding","description":"Machine cashier manifest and canonical payTo configuration"}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","name":"PAYMENT-SIGNATURE","in":"header","description":"x402 v2 payment signature containing EIP-712 payment authorization payload."}},"schemas":{"FundingResponse":{"type":"object","required":["schema_version","network","chainId","asset","assetSymbol","payTo","explorer","machineCashier","discovery","legal"],"properties":{"schema_version":{"type":"string"},"network":{"type":"string"},"chainId":{"type":"integer"},"asset":{"type":"string"},"assetSymbol":{"type":"string"},"payTo":{"type":"string"},"explorer":{"type":"string","format":"uri"},"machineCashier":{"type":"object","required":["protocol","challengeHeader","paymentHeader","catalog"],"properties":{"protocol":{"type":"string"},"challengeHeader":{"type":"string"},"paymentHeader":{"type":"string"},"catalog":{"type":"string","format":"uri"}}},"discovery":{"type":"object","required":["agentCard","agentsJson","x402","mcp","llmsTxt","llmsFullTxt","agentsTxt","openapi"],"properties":{"agentCard":{"type":"string","format":"uri"},"agentsJson":{"type":"string","format":"uri"},"x402":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"llmsTxt":{"type":"string","format":"uri"},"llmsFullTxt":{"type":"string","format":"uri"},"agentsTxt":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"swarm":{"type":"string","format":"uri"}}},"legal":{"type":"string"}}}}},"paths":{"/api/health":{"get":{"summary":"Free liveness + seller posture (payTo configured, no spend key, network, demo/live).","operationId":"oracle_health","tags":["x402","oracle","health"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"service":"x402 Oracle","wallet_configured":false,"pay_to_configured":true,"network":"eip155:8453"}}}}}}},"/api/pricing":{"get":{"summary":"Free menu of paid consults, A2A tasks, and connect how-to. No keys requested.","operationId":"oracle_pricing","tags":["x402","oracle","pricing"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"tools":[],"maxPriceUsd":25,"network":"eip155:8453"}}}}}}},"/api/consult/oracle_ask":{"post":{"summary":"Paid x402/MCP/A2A/Bazaar consult. JSON wisdom envelope: verdict, wisdom, developer build notes, risk, citations, receipt.","operationId":"oracle_ask","tags":["x402","mcp","a2a","bazaar","oracle"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"100000"},"security":[{"x402Payment":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"no_rank_without_settle","wisdom":"Cataloging is settlement-triggered.","risk":"burning USDC on frozen catalog copy","citations":["https://docs.cdp.coinbase.com/x402/seller/get-discovered"]}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"audience":{"type":"string"}},"required":["question"]},"example":{"question":"Why is my Bazaar listing unranked after 402s with no settlement?","audience":"agent"}}}}},"get":{"summary":"Crawler 402 for oracle_ask","operationId":"oracle_ask_crawler_402","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"100000"},"responses":{"200":{"description":"Paid GET not used; POST after payment"},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/consult/oracle_diagnose_402":{"post":{"summary":"Post-mortem a 402 handshake: PAYMENT-REQUIRED shape, bazaar extension, network, asset, resource.url.","operationId":"oracle_diagnose_402","tags":["x402","402","facilitator","oracle"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"500000"},"security":[{"x402Payment":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"missing_bazaar_extension","wisdom":"A live 402 must be standard base64 JSON with accepts[] (scheme exact, network eip155:8453, Base USDC) and extensions.bazaar.info.input.method."}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challenge_b64_or_json":{"type":"string"},"resource_url":{"type":"string"}},"required":["challenge_b64_or_json"]},"example":{"challenge_b64_or_json":"eyJ4NDAyVmVyc2lvbiI6Mn0=","resource_url":"https://example.com/paid"}}}}},"get":{"summary":"Crawler 402 for oracle_diagnose_402","operationId":"oracle_diagnose_402_crawler_402","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"500000"},"responses":{"200":{"description":"Paid GET not used; POST after payment"},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/consult/oracle_review_mcp":{"post":{"summary":"Review an MCP paid-tool server for createPaymentWrapper, free health tool, discovery extension, burner isolation.","operationId":"oracle_review_mcp","tags":["mcp","x402","paid-tools","oracle"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"3.000000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"3000000"},"security":[{"x402Payment":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"needs_free_health_tool","wisdom":"A Bazaar-ready paid MCP server must expose createPaymentWrapper (or equivalent), x402ResourceServer on eip155:8453, declareDiscoveryExtension with toolName, a free health tool, paid consults, and streamable-http at /mcp."}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mcp_url":{"type":"string"},"notes":{"type":"string"}},"required":["mcp_url"]},"example":{"mcp_url":"https://example.com/mcp","notes":"streamable-http, two paid tools"}}}}},"get":{"summary":"Crawler 402 for oracle_review_mcp","operationId":"oracle_review_mcp_crawler_402","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"3.000000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"3000000"},"responses":{"200":{"description":"Paid GET not used; POST after payment"},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/consult/oracle_bazaar_rewrite":{"post":{"summary":"Rewrite serviceName (≤32), description (≤500), tags (≤5) for buyer-query rank. Warns on first-index freeze.","operationId":"oracle_bazaar_rewrite","tags":["bazaar","cdp","ranking","oracle"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.500000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"1500000"},"security":[{"x402Payment":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"serviceName":"x402 MCP Oracle","description":"Paid MCP consults for x402, Bazaar ranking, A2A tasks, burner isolation.","tags":["x402","mcp","bazaar"]}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"current_description":{"type":"string"},"buyer_phrases":{"type":"array"}},"required":["current_description"]},"example":{"current_description":"API for data","buyer_phrases":["x402 mcp oracle","paid mcp bazaar"]}}}}},"get":{"summary":"Crawler 402 for oracle_bazaar_rewrite","operationId":"oracle_bazaar_rewrite_crawler_402","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.500000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"1500000"},"responses":{"200":{"description":"Paid GET not used; POST after payment"},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/consult/complete_oracle_task":{"post":{"summary":"Outcome A2A task: typed diffs, operator handoff notes, and revenue/risk for a concrete x402 shipping goal.","operationId":"complete_oracle_task","tags":["a2a","outcome","x402","oracle"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"10.000000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"10000000"},"security":[{"x402Payment":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"verdict":"ship_seed_settle","wisdom":"Outcome task: deploy HTTPS → GET 402 crawler on every paid POST → CDP validate → one seed settle from a local burner with USDC on Base → confirm discovery/search."}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"goal":{"type":"string"},"constraints":{"type":"string"}},"required":["goal"]},"example":{"goal":"List oracle_ask on CDP Bazaar after first mainnet settle","constraints":"seller-only host, no EVM_PRIVATE_KEY"}}}}},"get":{"summary":"Crawler 402 for complete_oracle_task","operationId":"complete_oracle_task_crawler_402","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"10.000000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x0d25a44f74868ece53b305c97139cf4b62963410","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomicAmount":"10000000"},"responses":{"200":{"description":"Paid GET not used; POST after payment"},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","format":"byte"}}}}}}},"/.well-known/funding.json":{"get":{"summary":"Canonical payTo and machine cashier manifest","operationId":"funding_manifest","tags":["funding"],"security":[],"responses":{"200":{"description":"Canonical payTo and Base USDC settlement configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingResponse"}}}}}}},"/health":{"get":{"summary":"Service liveness (same payload as /api/health)","operationId":"health_root","tags":["health"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/a2a":{"post":{"summary":"A2A JSON-RPC 0.3 (SendMessage, GetTask)","operationId":"a2a_jsonrpc","tags":["a2a"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC result"},"400":{"description":"Invalid JSON-RPC request"}}},"get":{"summary":"Method not allowed","operationId":"a2a_get_disallowed","tags":["a2a"],"security":[],"responses":{"405":{"description":"Use POST","headers":{"Allow":{"schema":{"type":"string"},"example":"POST, OPTIONS"}}}}}},"/mcp":{"get":{"summary":"MCP catalog (not SSE); JSON-RPC via POST","operationId":"mcp_catalog_get","tags":["mcp"],"security":[],"parameters":[{"name":"Accept","in":"header","schema":{"type":"string"},"description":"application/json returns catalog; text/event-stream returns 405"}],"responses":{"200":{"description":"MCP server catalog","headers":{"Vary":{"schema":{"type":"string"},"example":"Accept"}},"content":{"application/json":{"schema":{"type":"object"}}}},"405":{"description":"SSE not supported","headers":{"Allow":{"schema":{"type":"string"},"example":"POST, OPTIONS"}}}}},"post":{"summary":"MCP streamable HTTP JSON-RPC","operationId":"mcp_jsonrpc","tags":["mcp"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"id":{},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC response (402 payment challenges use HTTP 200 + isError for tools/call)"},"202":{"description":"notifications/initialized accepted"}}}},"/.well-known/x402":{"get":{"summary":"x402 v2 payment catalog","operationId":"well_known_x402","tags":["discovery"],"security":[],"responses":{"200":{"description":"x402 v2 payment catalog","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agent-card.json":{"get":{"summary":"A2A agent card","operationId":"well_known_agent_card","tags":["discovery"],"security":[],"responses":{"200":{"description":"A2A agent card","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"A2A agent card alias","operationId":"well_known_agent_json","tags":["discovery"],"security":[],"responses":{"200":{"description":"A2A agent card alias","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agents.json":{"get":{"summary":"Agents registry index","operationId":"well_known_agents_json","tags":["discovery"],"security":[],"responses":{"200":{"description":"Agents registry index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp.json":{"get":{"summary":"MCP server manifest","operationId":"well_known_mcp_json","tags":["discovery"],"security":[],"responses":{"200":{"description":"MCP server manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp":{"get":{"summary":"MCP server manifest alias","operationId":"well_known_mcp","tags":["discovery"],"security":[],"responses":{"200":{"description":"MCP server manifest alias","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"summary":"LLMs discovery text","operationId":"llms_txt","tags":["discovery"],"responses":{"200":{"description":"text/plain"}}}},"/agents.txt":{"get":{"summary":"Agents.txt crawlers manifest","operationId":"agents_txt","tags":["discovery"],"responses":{"200":{"description":"text/plain"}}}},"/jsonld":{"get":{"summary":"Schema.org JSON-LD graph","operationId":"jsonld","tags":["discovery"],"security":[],"responses":{"200":{"description":"Schema.org JSON-LD graph","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}