Executions & Market API

GET /v1/executions — Execution lookup and history

Two modes: lookup (pass one of quote, tx, or client_ref) or history (pass none for paginated results).

Lookup parameters

string

Quote ID. 0x-prefixed bytes32 hex. Mutually exclusive with tx and client_ref.

string

Transaction hash. 0x + 64 hex characters. Mutually exclusive with quote and client_ref.

string

Partner client reference from /v1/firm-quote. Mutually exclusive with quote and tx.

History parameters

string

Optional pair filter (e.g. USDT-IDRX).

string

Optional: SETTLED or FAILED.

string

Inclusive lower UTC timestamp (ISO 8601).

string

Inclusive upper UTC timestamp. Must be ≥ from.

string

next_cursor from a previous response.

integer

Page size. Default 50, min 1, max 100.

Lookup response `200 OK`

Field	Type	Description
`quote_id`	string	Quote ID from the settled swap
`pair`	string	Pair in `BASE-QUOTE` format
`side`	string	`BUY`, `SELL`, or `from-to` fallback
`status`	string	`SETTLED`
`filled_rate`	string	All-in effective rate: `destination_amount / source_amount`
`source_amount`	string	Input amount (display units)
`destination_amount`	string	Net output after spread (display units)
`gross_destination_amount`	string	Gross output before spread
`spread_fee_amount`	string	Spread fee in output token
`input_fee_amount`	string	Total input-side fee (fixed + variable)
`total_fee_usd`	string	Total fee in USD
`tx_hash`	string	Settlement transaction hash
`block_number`	integer	Settlement block number
`settled_at`	string	UTC timestamp from settlement block
`execution_path`	string	Currently always `DIRECT`
`client_ref`	string or null	Your reference, if provided

History mode returns a paginated array of the same items with pagination.next_cursor, pagination.has_more, and pagination.per_page. Errors: 400 (invalid params), 401, 404 (lookup — may not be indexed yet)

GET /v1/corridors — Available corridors

Lists configured corridors with token addresses, fee tiers, limits, and risk state. This is the source for corridor_id and from_token/to_token values used in quote requests.

Response `200 OK` — `data.corridors[]`

Field	Type	Description
`corridor_id`	string	On-chain `bytes32` corridor ID. Pass this when quoting.
`pair`	string	Pair in `BASE-QUOTE` format (e.g. `USDT-IDRX`)
`tokens.base` / `tokens.quote`	object	`symbol`, `underlying_asset`, `asset` (ERC-20 address), `decimals`
`configured`	boolean	Always `true`
`accessible`	boolean	Whether your credential may quote this corridor. `false` → `403` on quote.
`state`	string	Risk state: `NORMAL`, `PROTECT`, `RESTRICT`, `HALT`, or `FREEZE`
`allowed_directions`	string[]	`["BUY", "SELL"]` in NORMAL/PROTECT; one or `[]` in RESTRICT; `[]` in HALT
`limits`	object	`min_amount_usd` and `max_amount_usd`
`fee_tiers`	array	Per-tier `tier`, `max_amount_usd`, `variable_fee_bps`
`fixed_fee_by_to_token`	object	Fixed fee schedule keyed by destination token, per tier
`spread_config`	object	`base_spread_bps` and `liquidity_bps`
`route_type`	string	Currently always `DIRECT`
`quote_expiry_seconds`	integer	Quote TTL in seconds (currently `60`)

Errors: 401, 503

GET /v1/rates — Current oracle rates

Current oracle mid-market rates for all configured corridors. Lighter than POST /v1/quote for rate display — no amount or direction required.

Response `200 OK` — `data.rates[]`

Field	Type	Description
`pair`	string	Pair in `BASE-QUOTE` format
`mid`	string	Mid-market rate (base token USD price / quote token USD price)
`oracle_age_ms`	integer	Milliseconds since the older of the two price fetches
`rate_source`	string	Currently always `DIRECT`
`updated_at`	string	UTC timestamp from the older price fetch

Errors: 401, 503 (oracle price unavailable)

GET /v1/reports/daily-summary — Daily reconciliation

Partner-scoped daily summary of settled swaps and expired quotes.

Query parameters

string

required

UTC report date in YYYY-MM-DD format.

Response `200 OK`

Field	Type	Description
`date`	string	Echoes request date
`timezone`	string	Always `UTC`
`summary.total_swaps`	integer	Settled swap count
`summary.total_volume_usd`	string	Sum of input value in USD
`summary.total_fees_usd`	string	Sum of total fees in USD
`summary.corridors.{pair}`	object	Per-pair: `swap_count`, `buy_volume_usd`, `sell_volume_usd`, `net_volume_usd`, `fees_usd`
`summary.expired_quotes`	integer	Firm quotes that expired without execution

Errors: 400 (invalid date), 401

Overview

Endpoints

Executions & Market API

GET /v1/executions — Execution lookup and history

Lookup parameters

History parameters

Lookup response `200 OK`

GET /v1/corridors — Available corridors

Response `200 OK` — `data.corridors[]`

GET /v1/rates — Current oracle rates

Response `200 OK` — `data.rates[]`

GET /v1/reports/daily-summary — Daily reconciliation

Query parameters

Response `200 OK`

​GET /v1/executions — Execution lookup and history

​Lookup parameters

​History parameters

​Lookup response 200 OK

​GET /v1/corridors — Available corridors

​Response 200 OK — data.corridors[]

​GET /v1/rates — Current oracle rates

​Response 200 OK — data.rates[]

​GET /v1/reports/daily-summary — Daily reconciliation

​Query parameters

​Response 200 OK

GET /v1/executions — Execution lookup and history

Lookup parameters

History parameters

Lookup response `200 OK`

GET /v1/corridors — Available corridors

Response `200 OK` — `data.corridors[]`

GET /v1/rates — Current oracle rates

Response `200 OK` — `data.rates[]`

GET /v1/reports/daily-summary — Daily reconciliation

Query parameters

Response `200 OK`