Skip to main content
POST
Create Quick Trade

Authorizations

X-API-KEY
string
header
required

Body

application/json

Quick trade request

amount
string
required

Source amount to sell/swap.

Example:

"100"

currency
string
required

Source currency symbol.

Example:

"USDC"

to_currency
string
required

Destination currency symbol.

Example:

"ETH"

account_id
integer

Settlement account ID override for the source balance.

Example:

42

account_reference
string

Virtual account reference override (defaults to the org primary VA).

chain_id
integer

Source chain ID.

Example:

8453

dry_run
boolean

When true, return a quote estimate only and do not accept/execute.

Example:

false

reference
string

Optional client reference stored on the order.

settlement_account_id
integer

Settlement account ID. Mutually exclusive with settlement_address.

Example:

42

settlement_address
string

External settlement wallet address. Mutually exclusive with settlement_account_id.

to_chain_id
integer

Destination chain ID.

Example:

1

Response

OK

data
object

Response payload when the request succeeded.

error
boolean

True when the request failed.

message
string

Human-readable status or error message.