Skip to main content
POST
Execute trade
Executes a currency exchange trade using a valid quote ID. The trade must be submitted within the quote’s validity window (3 seconds by default, up to 60 seconds when quoteForSeconds was specified at quote generation). Use this endpoint to:
  • Execute currency exchanges
  • Lock in quoted rates
  • Convert between currencies
  • Initiate settlement process
Idempotency required. This POST requires an Idempotency-Key header. Keys are cached for 24 hours. Reusing the same key with the same body returns the cached response; reusing it with different parameters returns a 422 error.

Errors

See the full v2 error reference for retry semantics and idempotency-specific codes.

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"