Quotes API

GET /v1/quote

Returns a reference price for a currency pair. No inventory is reserved and the rate is not executable — use this to display pricing to your users before they commit.

Query parameters

string

required

Currency pair to quote. Supported values: USD-IDR, USD-SGD, MYR-IDR.

string

required

Trade direction. BUY or SELL.

number

required

Notional amount in the source currency.

Response `200 OK`

{
  "pair": "USD-IDR",
  "side": "BUY",
  "indicative_rate": 16020.50,
  "mid": 15980.00,
  "spread_bps": 25,
  "timestamp": "2026-02-27T10:00:00Z",
  "quote_type": "INDICATIVE"
}

string

Currency pair.

string

Trade direction.

number

Reference rate. This rate is not executable and carries no expiry.

number

Oracle mid-market rate.

number

Indicative spread in basis points.

string

ISO 8601 server timestamp.

string

Always INDICATIVE for this endpoint.

Indicative quotes are for display purposes only. To lock a rate for execution, request a firm quote using POST /v1/firm-quote.

POST /v1/firm-quote

Returns a binding BID/ASK with hard expiry and inventory reservation. You must execute the quote before expiry_timestamp or it will expire.

Request body

string

required

Currency pair to quote. Supported values: USD-IDR, USD-SGD, MYR-IDR.

string

required

Trade direction. BUY or SELL.

number

required

Notional amount in the source currency.

string

required

Must be FIRM.

string

Optional partner-side reference for reconciliation (e.g. your internal transaction ID).

{
  "pair": "USD-IDR",
  "side": "BUY",
  "amount": 50000,
  "quote_type": "FIRM",
  "client_ref": "TXN-20260227-001"
}

Response `200 OK`

{
  "quote_id": "QT-8821-USD-IDR",
  "pair": "USD-IDR",
  "side": "BUY",
  "amount": 50000,
  "bid": 15940.00,
  "ask": 16020.00,
  "adjusted_mid": 15980.00,
  "spread_bps": 25,
  "expiry_timestamp": "2026-02-27T10:00:45Z",
  "max_size": 50000,
  "allowed_direction": "BUY",
  "state_flag": "NORMAL",
  "quote_type": "FIRM",
  "execution_path": "DIRECT",
  "fee_breakdown": {
    "tier": "MEDIUM",
    "fixed_fee": 0.633,
    "fixed_fee_currency": "USD",
    "fixed_fee_in_dest": 10000,
    "fixed_fee_dest_currency": "IDR",
    "variable_fee": 10.00,
    "variable_fee_bips": 2,
    "base_spread_bps": 20,
    "total_spread_bps": 25,
    "total_fee_usd": 10.633,
    "amount_to_convert": 49989.37,
    "is_partner_override": false
  }
}

The quote expires at expiry_timestamp. You must call POST /v1/execute before that time. Expired quotes return a QUOTE_EXPIRED error.

string

Unique quote identifier. Pass this to POST /v1/execute to settle the swap.

string

Currency pair.

string

Trade direction.

number

Notional amount in the source currency.

number

Bid price.

number

Ask price.

number

Oracle mid-market rate after inventory adjustment.

number

Total spread in basis points.

string

ISO 8601 hard expiry for this quote.

number

Maximum executable amount for this quote. Your execution amount must not exceed this value.

string

Permitted trade direction under the current system state.

string

System state at quote time: NORMAL, PROTECT, or RESTRICT.

string

Routing path used: DIRECT or EXTERNAL_RFQ.

object

Full fee transparency for this quote.

Show properties

string

Volume tier applied: MICRO, SMALL, MEDIUM, LARGE, or INSTITUTIONAL.

number

Fixed fee in the source currency.

string

Source currency code for the fixed fee.

number

Fixed fee converted to the destination currency.

string

Destination currency code for the fixed fee.

number

Variable fee in the source currency.

number

Variable fee rate in basis points.

number

Base spread from the partner’s fee tier.

number

Total spread including dynamic components.

number

Total platform fee (fixed + variable) in USD.

number

Source amount after fee deduction — the amount actually converted.

boolean

true if partner-specific rate overrides were applied to this quote.

Overview

Endpoints

GET /v1/quote

Query parameters

Response `200 OK`

POST /v1/firm-quote

Request body

Response `200 OK`

​GET /v1/quote

​Query parameters

​Response 200 OK

​POST /v1/firm-quote

​Request body

​Response 200 OK

GET /v1/quote

Query parameters

Response `200 OK`

POST /v1/firm-quote

Request body

Response `200 OK`