Settlements & Verification

After executing a swap on-chain, use the API to verify settlement and reconcile your activity.

Verifying settlement

`GET /v1/executions` — Execution lookup

After submitting commitFirmQuote on-chain, call this endpoint to confirm settlement:

GET /v1/executions?quote=0x{quote_id}

You can look up by any one of: quote (quote ID), tx (transaction hash), or client_ref (your reference from the firm quote).

The execution may not be indexed immediately after the on-chain transaction confirms. If you receive 404, retry after a few seconds.

Lookup response

{
  "success": true,
  "data": {
    "quote_id": "0x3f9c2b7e...de21a",
    "pair": "USDT-IDRX",
    "side": "SELL",
    "status": "SETTLED",
    "filled_rate": "17652.86135",
    "source_amount": "1000",
    "destination_amount": "17652861.35",
    "gross_destination_amount": "17677610.01",
    "spread_fee_amount": "24748.66",
    "input_fixed_fee_amount": "0.564971",
    "input_variable_fee_amount": "0.70",
    "input_fee_amount": "1.264971",
    "total_fee_usd": "2.663022",
    "tx_hash": "0x9b1e4c7d...1a2b",
    "block_number": 228428441,
    "settled_at": "2026-09-16T09:00:12Z",
    "execution_path": "DIRECT",
    "client_ref": "TXN-20260916-001"
  },
  "meta": { ... }
}

Key fields

Field	Type	Description
`status`	string	`SETTLED` when confirmed on-chain
`filled_rate`	string	All-in effective rate: `destination_amount / source_amount`
`source_amount`	string	Input amount (display units)
`destination_amount`	string	Net output after all fees (display units)
`gross_destination_amount`	string	Gross output before spread deduction
`total_fee_usd`	string	Total fee (fixed + variable + spread) in USD
`tx_hash`	string	Settlement transaction hash, verifiable on Kaiascan (mainnet, Kairos testnet)
`block_number`	integer	Settlement block number
`settled_at`	string	UTC timestamp from the settlement block
`client_ref`	string	Your reference from the firm quote, if provided

Execution history

Call GET /v1/executions without a lookup parameter to get paginated history:

Parameter	Type	Description
`pair`	string	Optional pair filter (e.g. `USDT-IDRX`)
`status`	string	Optional: `SETTLED` or `FAILED`
`from`	string	Inclusive lower UTC bound (ISO 8601)
`to`	string	Inclusive upper UTC bound (must be ≥ `from`)
`cursor`	string	Cursor from a previous response
`per_page`	integer	Page size. Default `50`, max `100`

Results are scoped to your credential and ordered newest first.

Daily reconciliation

`GET /v1/reports/daily-summary`

Returns a partner-scoped daily summary of swaps and expired quotes.

GET /v1/reports/daily-summary?date=2026-09-16

{
  "success": true,
  "data": {
    "date": "2026-09-16",
    "timezone": "UTC",
    "summary": {
      "total_swaps": 17,
      "total_volume_usd": "25400.5",
      "total_fees_usd": "66.116655",
      "corridors": {
        "USDT-IDRX": {
          "swap_count": 12,
          "buy_volume_usd": "8200",
          "sell_volume_usd": "12400.5",
          "net_volume_usd": "-4200.5",
          "fees_usd": "54.912345"
        },
        "USDT-JPYC": {
          "swap_count": 5,
          "buy_volume_usd": "3100",
          "sell_volume_usd": "1700",
          "net_volume_usd": "1400",
          "fees_usd": "11.20431"
        }
      },
      "failed_executions": 0,
      "expired_quotes": 3
    }
  },
  "meta": { ... }
}

Field	Description
`total_swaps`	Count of settled swaps in the UTC day window
`total_volume_usd`	Sum of input value in USD
`total_fees_usd`	Sum of total fees in USD
`corridors.{pair}`	Per-pair breakdown: `swap_count`, `buy_volume_usd`, `sell_volume_usd`, `net_volume_usd`, `fees_usd`
`expired_quotes`	Count of firm quotes that expired without execution

Settlement finality

Once a commitFirmQuote transaction is confirmed on-chain, the swap is final. Kaia’s BFT consensus provides deterministic, immediate finality — there is no possibility of reversal, reorg, or partial settlement.

Get Started

Features

Architecture

Integration

Partners

Resources

Settlements & Verification

Verifying settlement

`GET /v1/executions` — Execution lookup

Lookup response

Key fields

Execution history

Daily reconciliation

`GET /v1/reports/daily-summary`

Settlement finality

​Verifying settlement

​GET /v1/executions — Execution lookup

​Lookup response

​Key fields

​Execution history

​Daily reconciliation

​GET /v1/reports/daily-summary

​Settlement finality

Verifying settlement

`GET /v1/executions` — Execution lookup

Lookup response

Key fields

Execution history

Daily reconciliation

`GET /v1/reports/daily-summary`

Settlement finality