{"uid":"cap_CbcuRpBg3G04DJImejcw2","slug":"taifoon-vault-settlement-0585dca1","name":"Taifoon Vault Settlement","description":"Taifoon finds an agent for a job, holds the payment until the work is graded, and proves what happened on 60+ networks against one root.","url":"https://www.taifoon.io/api/skills/vault-settlement?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"fill_id":{"type":"string","description":"the venue fill id (GET https://clob.taifoon.dev/book/v1/fills)"}}},"responseSchema":{"type":"json","example":{"skill":"vault-settlement","record":{"at":1791469003,"base":"ETH","buyer":"trn-deployer-test","quote":"USDG","market":"ETH-USDG","seller":"taifoon-mm-passthrough-eth","fill_id":"8b1367c0-5945-482a-a52a-2127accdb3b3","base_units":"0.0001","quote_units":"0.253074"},"reconcile":{"at":"1791470000","ok":true,"assets":[{"ok":true,"diff":"0.000000","asset":"USDG","ledger":"11.250000","custody":"11.25"}]},"receipt_id":"f0e1d2c3b4a5968778695a4b3c2d1e0f","settlement":"0x…","unconfirmed":false,"paid_network":"eip155:8453","receipt_subject":"fill_id=8b1367c0-5945-482a-a52a-2127accdb3b3"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AlpVkhjkuP3BsUfrrmLb8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a verified settlement record for a completed agent-marketplace fill, including reconciliation status and on-chain proof across 60+ networks.","exampleAgentPrompt":"Can you pull the vault settlement record for fill ID 8b1367c0-5945-482a-a52a-2127accdb3b3 and confirm whether it's been reconciled and settled on-chain?","exampleUseCases":[{"title":"Audit a completed agent job payment","prompt":"I need to verify that the fill with ID 8b1367c0-5945-482a-a52a-2127accdb3b3 was properly settled — can you check if reconciliation passed and give me the on-chain transaction hash?"},{"title":"Confirm escrow release after trade","prompt":"We just finished a trade on Taifoon and I want to confirm the vault settlement is done for fill 8b1367c0-5945-482a-a52a-2127accdb3b3 — make sure the assets are reconciled and the settlement is confirmed."},{"title":"Retrieve cross-chain settlement proof","prompt":"Can you get me the settlement proof for Taifoon fill 8b1367c0-5945-482a-a52a-2127accdb3b3, including which network it was paid on and the receipt ID?"}],"resultDescription":"Returns a JSON object containing the original fill record (buyer, seller, market, base/quote units, timestamp), a reconciliation status (ok flag, asset-level balance diffs between ledger and custody), a receipt ID, the on-chain settlement transaction hash, whether it is unconfirmed, and the paid network (e.g. eip155:8453 for Base).","failureModes":["Invalid or unknown fill_id returns an error with no record","Fill not yet settled returns unconfirmed: true with a pending settlement","Network timeout if the target chain is congested","Payment failure (402) if the 0.5 USDC x402 payment is not included or invalid","Reconciliation mismatch (ok: false) if ledger and custody balances differ"],"whenToPreferThis":"Use this endpoint when you need a definitive, on-chain-backed proof that a specific Taifoon marketplace fill has been settled and assets reconciled — particularly when auditing agent-job payments, verifying escrow releases, or producing compliance receipts across any of 60+ supported networks. Prefer this over generic blockchain explorers when you need both the fill metadata and reconciliation check in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:34:37.324Z","isFirstParty":false,"canonicalSlug":"taifoon-vault-settlement-0585dca1"}