Skip to main content
POST
Execute a conversion (consume a quote, terminal state inline)

Authorizations

Authorization
string
header
required

Enter Auth0 JWT token

Headers

Idempotency-Key
string

A repeat returns the original conversion result.

Body

application/json
quoteId
string
required

Id of the firm convert quote to execute

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

The executed conversion in its terminal state.

createdAt
string
required

Created at (ISO 8601)

fee
string
required

Fixed fee charged, in feeCurrency. Always 0 for conversions created after fixed fees were retired from converts.

Example:

"0.0000"

feeCurrency
string
required

Fee currency

Example:

"USD"

id
string
required

Conversion id

Example:

"uuid"

rate
string
required

All-in rate applied: source units per 1 target unit

Example:

"1.09860000"

sourceAmount
string
required

Debited from the source balance

Example:

"500.0000"

sourceCurrency
string
required

Source currency

Example:

"USD"

status
enum<string>
required

Terminal status

Available options:
completed,
failed
Example:

"completed"

targetAmount
string
required

Credited to the target balance

Example:

"455.1200"

targetCurrency
string
required

Target currency

Example:

"EUR"