{"openapi":"3.1.0","info":{"title":"Taifoon: paid routes on www.taifoon.io","version":"1.0.0","description":"The x402 routes served on this origin. Each answers an unpaid call with HTTP 402 and its terms. Every open route, on every Taifoon host, with inputs and terms: https://coord.taifoon.dev/.well-known/x402. The whole coordination API: https://coord.taifoon.dev/openapi.json.","x-guidance":"Call a route with no payment header to receive its x402 v2 challenge, pay the quoted amount on a network it lists (USDC on Base, Arbitrum One, Arc or Monad; USDG on Robinhood Chain) and retry with PAYMENT-SIGNATURE."},"servers":[{"url":"https://www.taifoon.io"}],"paths":{"/api/skills/proof-verify-v5":{"post":{"operationId":"proof_verify_v5","summary":"Verify a block under the SuperRoot","description":"Verify a block under the SuperRoot","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"chain_id":8453,"block_number":51741679}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"chainId":8453,"blockNumber":51741679,"blockHash":"0x0316464742b8edb13c6f267b79b01b71d68f306139d2a95cb6c76683e616a2fc","superrootHash":"0xec7ce0f9a6eba253561c7845e550e0756fc8f795f8ecdf34aa65621a743b10f1","proofBlobUrl":"https://api.taifoon.dev/api/v5/proof/blob/8453/51741679","finality":{"type":12,"finalizedBlockNumber":51741679,"finalizedBlockHash":"0x0316464742b8edb13c6f267b79b01b71d68f306139d2a95cb6c76683e616a2fc"},"blob":{"superroot":{},"chainHeaders":[],"superrootProof":{},"blockProof":{},"finality":{}},"receipt_id":"f0e1d2c3b4a5968778695a4b3c2d1e0f","class":"proof.verify.v5"}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/skills/settlement-proof":{"post":{"operationId":"settlement_proof","summary":"V5 settlement proof for one transaction or block","description":"V5 settlement proof for one transaction or block","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"chain_id":8453,"tx_hash":"0x8af83d2234c55d8210c6789a39fb4278014db6f540812efd633e8befc1369f74"}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"},"example":{"skill":"settlement-proof","receipt_id":"f0e1d2c3b4a5968778695a4b3c2d1e0f","receipt_subject":"chain_id=8453/tx_hash=0x8af83d2234c55d8210c6789a39fb4278014db6f540812efd633e8befc1369f74","paid_network":"eip155:8453","settlement":"0x…","unconfirmed":false,"proof_blob":{"superroot":{"superrootHash":"0x…","batchId":1790440016,"chainCount":61},"chainHeaders":[{"chainId":8453,"blockNumber":51741672,"blockHash":"0x…"}],"finality":{"finalityType":12}}}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.5"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/x402/settlement-proof":{"post":{"operationId":"settlement_proof_x402_namespace","summary":"V5 settlement proof for one transaction or block","description":"V5 settlement proof for one transaction or block","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"chain_id":8453,"tx_hash":"0x8af83d2234c55d8210c6789a39fb4278014db6f540812efd633e8befc1369f74"}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"},"example":{"skill":"settlement-proof","receipt_id":"f0e1d2c3b4a5968778695a4b3c2d1e0f","receipt_subject":"chain_id=8453/tx_hash=0x8af83d2234c55d8210c6789a39fb4278014db6f540812efd633e8befc1369f74","paid_network":"eip155:8453","settlement":"0x…","unconfirmed":false,"proof_blob":{"superroot":{"superrootHash":"0x…","batchId":1790440016,"chainCount":61},"chainHeaders":[{"chainId":8453,"blockNumber":51741672,"blockHash":"0x…"}],"finality":{"finalityType":12}}}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.5"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/skills/vault-settlement":{"post":{"operationId":"vault_settlement","summary":"The orderbook vault's settlement record for one spot fill, with the reconcile reading","description":"The orderbook vault's settlement record for one spot fill, with the reconcile reading","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"fill_id":"8b1367c0-5945-482a-a52a-2127accdb3b3"}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"},"example":{"skill":"vault-settlement","receipt_id":"f0e1d2c3b4a5968778695a4b3c2d1e0f","receipt_subject":"fill_id=8b1367c0-5945-482a-a52a-2127accdb3b3","paid_network":"eip155:8453","settlement":"0x…","unconfirmed":false,"record":{"fill_id":"8b1367c0-5945-482a-a52a-2127accdb3b3","market":"ETH-USDG","buyer":"trn-deployer-test","seller":"taifoon-mm-passthrough-eth","base":"ETH","base_units":"0.0001","quote":"USDG","quote_units":"0.253074","at":1791469003},"reconcile":{"ok":true,"at":"1791470000","assets":[{"asset":"USDG","ledger":"11.250000","custody":"11.25","diff":"0.000000","ok":true}]}}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.5"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/x402/acp-market-report":{"post":{"operationId":"acp_market_report","summary":"ACP market report","description":"ACP market report: live Virtuals ACP observatory analytics (jobs by state, 24 h events and volume, completion rate, top providers)","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/x402/entity-resolve":{"post":{"operationId":"entity_resolve","summary":"Resolve an address to a labelled entity","description":"Resolve an address to a labelled entity","tags":["x402"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}},"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}},"/api/skills/entity-resolve":{"get":{"operationId":"entity_resolve_skills_namespace","summary":"Resolve an address to a labelled entity","description":"Resolve an address to a labelled entity","tags":["x402"],"responses":{"200":{"description":"The paid answer.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: the x402 v2 challenge (PAYMENT-REQUIRED header and the same JSON body, with the bazaar extension). Pay it and send the same request again with PAYMENT-SIGNATURE."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3574999dd4c96eB73Bd6e11D4177010C83E14f5b"}}]},"security":[]}}}}