Sign in
FX

Get an indicative FX rate for a pair

Returns an indicative (cached, ~30s-fresh) mid-market reference rate with the calling organization’s spread applied. Use this for browse/UX surfaces. This endpoint takes no amount — per-corridor amount limits apply only when committing to a firm price via POST /v1/fx/quotes.

get/v1/fx/rates

Query parameters

sourceCurrencystring required
Example:USDT
sourceNetworkstring
Example:BASE

Network for crypto source (e.g. BASE, ETHEREUM). Required when source is a crypto asset; must be omitted when source is fiat.

sourceRailstring
Example:SEPA

Rail for fiat source (SEPA, SEPA_INSTANT, FASTER_PAYMENTS). Required when source is fiat; must be omitted when source is crypto. For EUR onramp prefer SEPA; SEPA_INSTANT remains accepted. Slow EUR rails are not available today.

destinationCurrencystring required
Example:USDC
destinationNetworkstring
Example:BASE

Network for crypto destination. Required when destination is a crypto asset; must be omitted when destination is fiat.

destinationRailstring
Example:SEPA

Rail for fiat destination (SEPA, SWIFT, ACH). Required when destination is fiat; must be omitted when destination is crypto.

onBehalfOfstring
Example:cus_abc123

Customer the rate is browsed for. Required when either leg is fiat (GBP/EUR) — fiat pairs quote against per-customer Codex credentials. Optional on stablecoin pairs: pass the customer that will later request the firm quote when they have customer-specific pricing (e.g. market-rate pin) so the indicative rate matches it.

Headers

X-API-Keystring

API key

Response

Indicative rate.

ratestring required

Indicative all-in customer rate for destinationCurrency / sourceCurrency, post-spread. Not a firm quote — request POST /v1/fx/quotes to commit a price.

asOfstring required

When the underlying reference rate was sourced (ISO 8601). Rates are cached briefly to stay inside vendor budgets; this is the cache anchor, not a per-request timestamp.

pairKeystring required

Canonical SOURCE:DEST pair key (uppercase).

source'reference' required

Always reference for this endpoint. Discriminator left open for future indicative-rate sources without changing the response shape.

Example response

{
  "rate": "0.99975",
  "asOf": "2026-05-26T19:42:00.000Z",
  "pairKey": "USDT:USDC",
  "source": "reference"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.