v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-014254240.1 KB

Conversions

Create conversion

Creates and executes a conversion.

post/v1/conversions

Headers

Idempotency-Keystring

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

source_account_idstring uuid required

ID of the source account to debit.

target_account_idstring uuid required

ID of the target account to credit.

source_amountstring required

Amount to convert as a string decimal (e.g. "100.50").

metadataobject

Key-value pairs stored with the conversion.

Response

Success

idstring uuid required

Unique identifier of the conversion.

quote_idstring uuid nullable required

ID of the associated quote, or null.

type'conversion' required

Resource type discriminator.

status'pending' | 'completed' | 'failed' required

Current status of the conversion.

source_amountstring required

Source amount as a string decimal.

source_currency'EUR' | 'GBP' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL' required

Source currency code.

target_currency'EUR' | 'GBP' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL' required

Target currency code.

source_account_idstring nullable required

ID of the source account, or null.

target_account_idstring nullable required

ID of the target account, or null.

metadataobject required

Key-value pairs stored with the conversion.

created_atstring date-time required

ISO 8601 UTC timestamp when the conversion was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the conversion was last updated.

completed_atstring date-time nullable required

ISO 8601 UTC timestamp when the conversion completed, or null.