Currency Exchange

Currency exchange converts one currency in your account into another — crypto to crypto, crypto to fiat, or fiat to fiat. Quote the rate first, then place the order.

Endpoint overview

HTTP Request	Description
`POST` `/public/exchanges/calculate`	Calculate what an exchange would give you, before committing.
`POST` `/public/exchanges`	Place the exchange order.
`GET` `/public/exchanges`	List your exchanges, with pagination and filtering.
`GET` `/public/exchanges/{id}`	Retrieve a single exchange.
`GET` `/public/exchanges/pairs/ids`	Check whether a currency pair can be exchanged.

Exports are available at GET /public/exchanges/csv and GET /public/exchanges/pdf.

⚠️
The singular /public/exchange paths are deprecated. Use /public/exchanges as documented above.

Typical flow

Confirm the pair is supported with GET /public/exchanges/pairs/ids.
Quote it with POST /public/exchanges/calculate. The quote includes the rate and the margin applied.
Place the order with POST /public/exchanges.
Follow it with GET /public/exchanges/{id}, or list recent exchanges with GET /public/exchanges.

Rates move, so quote immediately before placing the order rather than reusing an older calculation.

Scopes

Scope	Grants
`exchange:read`	List exchanges, retrieve one, and check pairs.
`exchange:create`	Calculate and place exchange orders.

See Scopes and Generating API keys.