Skip to main content
POST
Execute a trade

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
quoteId
string
required

Quote ID

idempotencyKey
string<string>

Unique idempotency key for ensuring exactly-once execution of mutating requests.

Example:

"xeev1she5eegh9daiviethahchoo1muW"

xid
string

External identifier, unique across all resources created under this account.

xmetadata
any

Response

OK

success
boolean

Trade execution status

Example:

true

id
string<uuid>

Trade id

Example:

"a3310a45-44f3-4be0-a8ed-26f4a7d4c03e"

refId
string

Trade transaction reference

Example:

"EX9KNFLEP4"

baseCurrency
string

Base currency

Example:

"USD"

baseAmount
number

Amount of base currency

Example:

100

quoteCurrency
string

Quote currency

Example:

"HKD"

quoteAmount
number

Amount of quote currency

Example:

758.7169202399999

rate
number

Rate of conversion

Example:

7.5871692

executedAt
string<date-time>

Execute time of the trade

Example:

"2023-03-01T12:05:07.000Z"