Request a quote (RFQ)

Requests a firm, expiring quote for the client’s enrolled execution option. The quote can be accepted to book a trade. Balance is not checked at RFQ time — only at acceptance.

Idempotency: none — RFQs are side-effect-free; clients may fire multiple and accept only one.

Authentication

AuthorizationBearer
Token obtained via the login flow.

Request

This endpoint expects an object.
sellCurrencystringRequired

Currency the client gives up (ISO 4217).

buyCurrencystringRequired

Currency the client receives (ISO 4217).

sideenumRequired

sellamount is the sell leg. buyamount is the buy leg.

Allowed values:
amountstringRequired
Positive decimal string.

Response

A single firm quote active until expiresAt.

quoteIdstring
statusenum
Allowed values:
sellCurrencystring
buyCurrencystring
sellAmountstring

Both legs populated regardless of side.

buyAmountstring
ratestring

1 sellCurrency = <rate> buyCurrency

sideenum
Which leg was fixed at RFQ time.
Allowed values:
createdAtdatetime
expiresAtdatetime
Quote is acceptable strictly before this time.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error