# Taifoon Vault Settlement

> Taifoon Vault Settlement is a paid API for AI agents from www.taifoon.io, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-16).

Retrieves a verified settlement record for a completed agent-marketplace fill, including reconciliation status and on-chain proof across 60+ networks.

## Facts

- Endpoint: POST https://www.taifoon.io/api/skills/vault-settlement?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taifoon-vault-settlement-0585dca1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CbcuRpBg3G04DJImejcw2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability taifoon-vault-settlement-0585dca1 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fill_id": {
   "type": "string",
   "description": "the venue fill id (GET https://clob.taifoon.dev/book/v1/fills)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taifoon-vault-settlement-0585dca1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.taifoon.io](https://www.zero.xyz/host/www.taifoon.io/llms.txt)