FX Quote

Lock a firm rate. Use purpose: swap for internal transfers between your books, then pass the returned id as quote_id to POST /swaps. Omit purpose (or leave empty) for a payout quote.

POST /fx/quotes

cURL

swap

curl --request POST \
  --url https://20b9-41-90-209-232.ngrok-free.app/v1/fx/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "USD",
  "to": "NGN"
}
'

200

{
  "object": "fx_quote",
  "id": "e6bd10ee-6e53-4aaa-9cd0-a2bb980cf73e",
  "from": "USD",
  "to": "NGN",
  "amount_from": 10000,
  "amount_to": 1550000,
  "scale_from": 2,
  "scale_to": 2,
  "rate": "155.00",
  "expires_at": "2026-10-27T13:02:00Z",
  "valid_for_seconds": 90
}

Authorizations

Authorization · string · header · required

Secret API key from Settings → Developers → API keys. Example: Authorization: Bearer sk_test_…

Body

application/json

from · string · required

Source book currency (ISO 4217 or stablecoin code).

Example:

"USD"

to · string · required

Destination book currency.

Example:

"NGN"

amount_from · integer

Source amount in Ledger minor units (cents/kobo). Set exactly one of amount_from or amount_to.

Example:

10000

amount_to · integer

Destination amount in Ledger minor units. Set exactly one of amount_from or amount_to.

purpose · enum<string>

Omit for a payout quote. Set to swap when the quote will be passed to POST /swaps.

Available options: swap

Response

200

application/json

Firm quote

object · enum<string>

Object type discriminator.

Available options: fx_quote

id · string<uuid>

Firm quote id — pass as quote_id to payouts or swaps.

from · string

Source currency.

to · string

Destination currency.

amount_from · integer

Debit amount in Ledger minor units.

amount_to · integer

Credit amount in Ledger minor units at the locked rate.

scale_from · integer

Decimal places for from (usually 2).

scale_to · integer

Decimal places for to.

rate · string

Locked mid-market-style rate as a decimal string (to per 1 from).

expires_at · string<date-time>

When this quote can no longer be used.

valid_for_seconds · integer

Seconds remaining at creation time.