Public developer API

POST /v1/fx/quote

Locks a conversion rate for a short time. Convert with the returned id before expires_at.

Access

A project-specific API key (Authorization: Bearer dapi_live_...) and its Business ID (X-Business-Id). Rate limited per business (120 calls a minute by default).

Wallet conversions: between any two different wallet currencies (USD, XAF, GHS, ZAR, NGN, RWF, UGX, KES). Stablecoin conversions: USDT or USDC to USD or XAF, 1.45% fee, minimum 10.

Body

Field	Type	Required	Description
`from`	string	yes	Any wallet currency, or `USDT` / `USDC`.
`to`	string	yes	Any wallet currency other than `from` (`USD` or `XAF` when `from` is `USDT` / `USDC`).
`amount`	number	yes	Amount of the `from` currency.

Example request

curl --request POST \
  --url 'https://production.dutchapi.co/v1/fx/quote' \
  --header 'X-Business-Id: YOUR_BUSINESS_ID' \
  --header 'Authorization: Bearer bsk_live_YOUR_BUSINESS_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{"from":"USD","to":"XAF","amount":100}'

Response 201

{
  "id": "fxq_5a1c",
  "from": "USD",
  "to": "XAF",
  "rate": 590.4,
  "send_amount": 100,
  "receive_amount": 59040,
  "fee": 0,
  "expires_at": "2026-10-13T09:33:00.000Z"
}

Errors

Status	error	Meaning
400	`valid_currency_pair_required`	Use two different wallet currencies, or USDT/USDC to USD/XAF.
400	`valid_amount_required`	amount must be a positive number.
400	`crypto_swap_amount_out_of_range`	Stablecoin conversions start at 10.
502	`quote_unavailable`	The partner returned no rate.