Sign in
latestOpenAPI 3.1.02026-08-108936.3 KB

b3e625f21841

FXP Rates

Create an FX rate

Creates a new exchange rate for a currency pair. If a live rate already exists for the same currency pair, it is automatically marked as superseded and kept as a historical record. Quotes already issued against the previous rate remain valid for 10 minutes, known as the NQVT window. Nexus may throttle this endpoint, and an idempotency key header is recommended so that retried submissions are not duplicated. Requires the scope rates.write. Used by: FX Providers (FXPs)

post/v1/rates

Headers

Idempotency-Keystring uuid

Recommended for POST requests. A UUID used to deduplicate retried submissions.

Request body

sourceCurrencystring required

ISO 4217 currency code of the source currency, three uppercase letters.

destinationCurrencystring required

ISO 4217 currency code of the destination currency, three uppercase letters.

ratenumber required

Exchange rate, where UnitCcyAmount multiplied by rate equals QtyCcyAmount. Must be greater than 0.

Response

The created rate record.

idstring required

Unique ID of the rate record.

sourceCurrencystring required

ISO 4217 currency code of the source currency, three uppercase letters.

destinationCurrencystring required

ISO 4217 currency code of the destination currency, three uppercase letters.

ratenumber required

Exchange rate, where UnitCcyAmount multiplied by rate equals QtyCcyAmount. Must be greater than 0.

createdDateTimestring date-time required

Timestamp at which the rate record was created.

isExpiredboolean required

Historical marker set to true when the rate is replaced or withdrawn. It does not mean the rate expired with time.

expiryDateTimestring date-time nullable

Timestamp at which the rate was replaced or withdrawn. A historical marker only.