Skip to main content

​
Overview

Use this endpoint to execute a conversion with a valid quote_id from Create Conversion Quote. In a standard flow, this is the second step after quote creation.

​
Prerequisites

Before execution:
  • Create a quote via Create Conversion Quote.
  • Ensure the quote has not expired (expires_at).
  • Ensure your source balance can cover amount.

​
Authentication

Type: API Key (required)

​
Request

​
Method & Path

​
Request Parameters

​
string
required
Source currency. Must match the quote.
​
string
required
Destination currency. Must match the quote.
​
string
required
Amount as decimal string. Must match the quote.
​
string
required
Quote ID returned by Create Conversion Quote.

​
Request Example

​
Response

​
200 - Success

​
Response Fields

​
string
Unique conversion ID for reconciliation and retrieval.
​
string
Conversion state. Use this to determine whether funds moved successfully.
​
string
Source currency debited for this conversion.
​
string
Destination currency credited for this conversion.
​
string
Debited amount in source currency.
​
string
Credited amount in destination currency.
​
string
Applied execution rate for this conversion.
​
string
ISO 8601 timestamp when conversion was created.
​
string|null
Quote used during execution, when available.
​
object|null
Optional metadata attached to conversion records when provided by system flow.

​
Error Responses

Cause: Invalid payload, quote mismatch, or expired quote.Resolution: Request a fresh quote and retry with matching values. See Create Conversion Quote.
Cause: API key is missing, invalid, or revoked.Resolution: Use a valid API key in the Authorization header.