Skip to main content
POST
Execute trade
v1 sunsets December 31, 2026. Migrate to v2 — see the migration guide.
Executes a currency exchange trade using a valid quote ID. Must be called within 3 seconds of quote generation. Use this endpoint to:
  • Execute currency exchanges
  • Lock in quoted rates
  • Convert between currencies
  • Initiate settlement process
Idempotency is supported on v2 and v3 for this endpoint. v1 does not support idempotency keys — see Migration guide.

Errors

See the full v1 error reference.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string<uuid>
required

Unique key to ensure idempotent requests. UUID v4 recommended. Valid for 24 hours.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Path Parameters

orgId
string
required

Body

application/json
quoteId
string<uuid>
required
Example:

"d8bc9618-2830-1822-9ae2-414aaf2b2de3"

Response

success

status
enum<string>
Available options:
success,
error
Example:

"success"

data
object
message
string
Example:

"Data fetched successfully"