{"openapi":"3.1.0","info":{"title":"AIﾉアカリ☆ Public Agent API","version":"2026.08.07-wallet-preflight","description":"Public, machine-readable entry points for AIﾉアカリ☆. Free support surfaces remain separate from paid x402 resources. Listings, checks, and tool discovery are not purchases or human outcomes.","contact":{"name":"ありがとうKawaii Aiアイシテル合同会社","url":"https://ai-akari.ai"},"x-guidance":"Use POST /api/x402/agent-wallet-preflight for a low-cost Base transaction preflight: ETH gas balance, canonical USDC balance, and optional USDC allowance for one wallet. Use POST /api/x402/result-claim-audit for evidence-oriented verification and POST /api/x402/agent-market-pulse for live agent-market demand. Unsigned POST requests return HTTP 402 and do not charge."},"servers":[{"url":"https://ai-akari.ai"}],"tags":[{"name":"Public support","description":"Free, no-signup, non-diagnostic support."},{"name":"MCP","description":"Remote Model Context Protocol endpoints."},{"name":"Trust","description":"Externally grounded machine-readable trust evidence."},{"name":"x402","description":"HTTP 402 resources. Payment is never inferred or automatic."},{"name":"A2A","description":"Agent-to-Agent protocol surface."}],"paths":{"/api/one-minute":{"get":{"tags":["Public support"],"summary":"Return one concrete 60-second action","description":"Free structured support. It does not diagnose, sell from distress, or replace medical, legal, or emergency help.","parameters":[{"name":"state","in":"query","schema":{"type":"string","default":"overwhelmed"},"description":"A supported difficult state such as overwhelmed, lonely, frozen, or cannot_sleep."},{"name":"locale","in":"query","schema":{"type":"string","enum":["ja","en"],"default":"ja"}}],"responses":{"200":{"description":"A small action and safety boundary.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/mcp":{"get":{"tags":["MCP"],"summary":"Describe the free One-Minute Akari MCP","responses":{"200":{"description":"MCP server card."}}},"post":{"tags":["MCP"],"summary":"Call the free One-Minute Akari MCP over Streamable HTTP","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC response."},"204":{"description":"Notification accepted."}}}},"/mcp-trust":{"get":{"tags":["MCP","Trust"],"summary":"Describe the official Agent Trust Receipt MCP","responses":{"200":{"description":"MCP server card and canonical trust links."}}},"post":{"tags":["MCP","Trust"],"summary":"Read the live Agent Trust Receipt over MCP","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC response."},"204":{"description":"Notification accepted."}}}},"/.well-known/agent-trust.json":{"get":{"tags":["Trust"],"summary":"Get the live Agent Trust Receipt","description":"Includes official MCP Registry status, independent conformance, health, attestation and external validation executions while explicitly separating unproven adoption, payment and human outcome.","responses":{"200":{"description":"Agent Trust Receipt 1.1.0.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/x402/result-claim-audit":{"get":{"tags":["x402","Trust"],"summary":"Read the free Result Claim Audit contract","description":"Returns the paid resource purpose, price, accepted metrics, request schema, example, output contract, and evidence boundaries without charging.","responses":{"200":{"description":"Machine-readable free preview and input contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["x402","Trust"],"summary":"Audit a result claim after Base mainnet USDC settlement","description":"Reusable agent-commerce audit. It prevents a plan, deploy, listing, self-test, testnet event, or unsupported assertion from being counted as a real result. An unsigned request returns HTTP 402 and does not charge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultClaimAuditInput"},"example":{"claim":"Production payment settled and the product was delivered.","metric_hint":"cash_received","amount_jpy":1500,"evidence":["provider_event_id=evt_live_example","livemode=true","delivery_acceptance=accepted"]}}}},"responses":{"200":{"description":"Structured audit delivered only after verified settlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultClaimAuditOutput"}}}},"400":{"description":"The paid request body was not valid JSON."},"402":{"description":"x402 v2 payment requirements with Bazaar discovery metadata."},"503":{"description":"Keymaster-backed settlement unavailable."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/api/x402/happiness-first-decision":{"get":{"tags":["x402"],"summary":"Happiness-First Decision Pack paid resource","description":"Base mainnet USDC x402 resource. An unsigned request only returns payment requirements and does not charge.","responses":{"200":{"description":"Delivered only after facilitator verification and settlement."},"402":{"description":"x402 v2 payment requirements with Bazaar discovery metadata."},"503":{"description":"Keymaster-backed settlement unavailable."}}}},"/api/x402/philosophy":{"get":{"tags":["x402"],"summary":"AIﾉアカリ☆ philosophy corpus testnet resource","description":"Base Sepolia x402 v2 resource with replay protection and settlement receipt evidence.","responses":{"200":{"description":"Delivered after successful testnet settlement."},"402":{"description":"x402 v2 payment requirements."},"503":{"description":"Keymaster-backed settlement unavailable."}}}},"/a2a/result-receipt-auditor":{"post":{"tags":["A2A","Trust"],"summary":"Audit a claimed AI result over A2A","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"A2A JSON-RPC result."}}}},"/api/x402/agent-market-pulse":{"get":{"tags":["x402"],"summary":"Read the free Agent Market Pulse contract","description":"Returns the paid resource purpose, Base mainnet price, zero-input contract, and output boundary without charging.","responses":{"200":{"description":"Machine-readable free preview and input contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["x402"],"summary":"Get live agent-commerce demand and purchase pulse","description":"Zero-input live snapshot of recent confirmed public agent-market receipts, most-purchased offers in the observed receipt window, and currently open escrow-backed work. Designed for autonomous agents deciding what to buy, sell, build, or pursue next. An unsigned request returns HTTP 402 and does not charge.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}},"example":{}}}},"responses":{"200":{"description":"Paid live agent-market snapshot delivered after verified settlement.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"schema_version":{"type":"string"},"product_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"market":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"top_purchased":{"type":"array","items":{"type":"object"}},"open_escrow_work":{"type":"array","items":{"type":"object"}},"latest_receipts":{"type":"array","items":{"type":"object"}},"source_status":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 v2 payment requirements with Bazaar discovery metadata."},"503":{"description":"Keymaster-backed settlement unavailable."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/api/x402/agent-wallet-preflight":{"get":{"tags":["x402"],"summary":"Read the free Agent Wallet Preflight contract","description":"Returns the input schema, fixed canonical Base USDC token, paid resource boundary, and $0.001 Base mainnet price without charging.","responses":{"200":{"description":"Machine-readable free preview and input contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["x402"],"summary":"Check Base ETH, USDC balance, and optional USDC allowance","description":"Read-only transaction preflight for autonomous agents. Returns point-in-time Base ETH gas balance, canonical Base USDC balance, and optional USDC allowance before the caller attempts a paid action. Never requests a private key, signs, approves, transfers, or simulates. An unsigned request returns HTTP 402 and does not charge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["wallet"],"properties":{"wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"example":{"wallet":"0x0000000000000000000000000000000000000001","spender":"0x0000000000000000000000000000000000000002"}}}},"responses":{"200":{"description":"Paid read-only Base wallet preflight delivered after verified settlement.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"schema_version":{"type":"string"},"product_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"network":{"type":"string"},"wallet":{"type":"string"},"spender":{"anyOf":[{"type":"string"},{"type":"null"}]},"native":{"type":"object","additionalProperties":true},"usdc":{"type":"object","additionalProperties":true},"preflight":{"type":"object","additionalProperties":true},"source":{"type":"object","additionalProperties":true},"boundary":{"type":"string"}}}}}},"400":{"description":"Invalid wallet or spender input."},"402":{"description":"x402 v2 payment requirements with Bazaar discovery metadata."},"503":{"description":"Settlement or Base RPC temporarily unavailable."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ResultClaimAuditInput":{"type":"object","required":["claim","metric_hint","evidence"],"properties":{"claim":{"type":"string","maxLength":4000},"evidence":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":2000}},"metric_hint":{"type":"string","enum":["cash_received","human_time_reclaimed","cost_avoided","risk_removed","obligation_completed","external_value_received","intended_recipient_response","unknown"]},"amount_jpy":{"type":"number","exclusiveMinimum":0},"minutes_reclaimed":{"type":"number","exclusiveMinimum":0},"intent_contract":{"type":"object","additionalProperties":false,"properties":{"scope":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"postconditions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["file_exists"]},"path":{"type":"string","maxLength":1000},"expected":{"type":"boolean"}},"required":["type","path"]}}}},"observed_outcome":{"type":"object","additionalProperties":false,"properties":{"scope":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"claims":{"type":"array","items":{"type":"string","maxLength":2000}},"tool_response":{"type":"string","maxLength":2000},"external_observation":{"type":"string","maxLength":2000},"error":{"type":"string","maxLength":2000},"files":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","maxLength":1000},"exists":{"type":"boolean"}},"required":["path","exists"]}}}}},"additionalProperties":false},"ResultClaimAuditOutput":{"type":"object","required":["schema_version","product_id","protocol","resource","network","generated_at","input_hash_sha256","output_hash_sha256","normalized_input","audit","boundary"],"properties":{"schema_version":{"type":"string","const":"ai-akari-result-claim-audit/1.0"},"product_id":{"type":"string","const":"result-claim-audit-v1"},"protocol":{"type":"string","const":"x402"},"resource":{"type":"string","format":"uri"},"network":{"type":"string","const":"eip155:8453"},"generated_at":{"type":"string","format":"date-time"},"input_hash_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"output_hash_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"normalized_input":{"$ref":"#/components/schemas/ResultClaimAuditInput"},"audit":{"type":"object","required":["verdict","counted_as_result","result_type","reasons","missing_evidence","accepted_evidence","next_verification_action","rule"],"properties":{"verdict":{"type":"string","enum":["result","progress","insufficient_evidence","rejected"]},"counted_as_result":{"type":"boolean"},"result_type":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"missing_evidence":{"type":"array","items":{"type":"string"}},"accepted_evidence":{"type":"array","items":{"type":"string"}},"next_verification_action":{"type":"string"},"rule":{"type":"string"},"contract_match":{"type":"boolean"},"contract_mismatches":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["kind","code","expected","observed","message"],"properties":{"kind":{"type":"string","enum":["scope","postcondition"]},"code":{"type":"string","enum":["scope_not_satisfied","postcondition_not_satisfied"]},"expected":{"type":"string"},"observed":{"type":"string"},"message":{"type":"string"}}}}},"additionalProperties":true},"boundary":{"type":"string"},"revenue_truth":{"type":"string"}},"additionalProperties":true}}}}