v1

latestOpenAPI 3.0.32026-07-23215362.6 KB

Trading

Request Quote (RFQ)

Request a quote for a currency conversion. Specify deliver quantity or receive quantity, but not both.

post/v1/quotes

Headers

X-Request-Idstring

A client-supplied unique identifier for this request, used for safely retrying and deduplicating operations. When the same X-Request-Id is sent with multiple identical requests within a defined time window, the server treats them as the same logical operation and will not perform the side effect more than once. Instead, it will return the original result associated with that identifier, if available. The client should generate a collision-resistant value (for example, a UUID) and reuse it only when retrying the same operation.

Request body

Response

Successful response

quoteIdstring uuid

requestedAtstring date-time

Date-time in ISO 8601 format

expiresAtstring date-time

Date-time in ISO 8601 format

accountIdstring uuid

pairstring

side'BUY' | 'SELL'

deliverQuantitystring number

deliverCurrencystring

receiveQuantitystring number

receiveCurrencystring

pricestring number

baseQuantitystring number

quoteQuantitystring number

feeCurrencystring

clientFeeRatestring integer nullable

The client fee rate in bps.

clientFeeAmountstring number nullable

Fixed fiat fee amount in tenant native currency. If both clientFeeRate and clientFeeAmount are provided, clientFeeRate takes precedence.

clientFeeQuantitystring float

providerFeeRatestring integer

The provider fee rate in bps.

providerFeeQuantitystring number

quoteStatus'AWAITING_RESPONSE' | 'CANCELED' | 'EXPIRED' | 'ACCEPTED'

clientReferencestring nullable

tradeTaxRatestring number

clientTaxQuantitystring number

providerTaxQuantitystring number