swaps

Enviar stablecoin

Convierte tu balance (GTQ/USD/USDC) y envía stablecoin on-chain a una dirección cripto. Envía uno solo de los dos montos: source_amount_as_decimal si sabes cuánto balance quieres convertir, o destination_amount_as_decimal si sabes cuánto debe llegar — la dirección se infiere del monto que envíes. Requiere la verificación de stablecoin completada y una llave con movimiento de dinero habilitado. Es asíncrono (puede quedar en in_review/processing). Pasa quote=true para previsualizar el tipo de cambio y los montos sin mover dinero. Una plataforma puede listar y consultar swaps de una hija con X-ACCOUNT-ID, pero no crear swaps por ella; las cuentas conectadas conservan la restricción de destinos cripto. En Sandbox, esta operación y su modo de cotización están bloqueados.

post/swaps

Query parameters

quoteboolean

Si es true, devuelve una cotización sin ejecutar el envío.

Headers

X-SECRET-KEYstring required

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Idempotency-Keystring

Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.

Request body

source_currencystring required

Moneda de tu balance a debitar (GTQ, USD, USDC)

destination_currency'USDC' | 'USDT' | 'USAT' | 'XAUT' | 'PYUSD' required
chain'ethereum' | 'polygon' | 'base' | 'arbitrum' | 'avalanche_c_chain' | 'optimism' | 'solana' | 'tron' required
source_amount_as_decimalstring

Envía este monto si sabes cuánto balance quieres convertir (exact-in), p.ej. "100.00"

destination_amount_as_decimalstring

O envía solo este monto si sabes cuánto debe llegar al destino (exact-out)

blockchain_memostring

Requerido para la red stellar

crypto_address_idstring

ID público de una dirección cripto guardada (de /crypto_addresses)

recipient_addressstring

O una dirección on-chain nueva (alternativa a crypto_address_id)

Response

Swap creado (asíncrono)

idstring
status'pending' | 'in_review' | 'processing' | 'rejected' | 'sent' | 'failed' | 'completed'
source_currencystring
source_amountinteger

Monto origen en la unidad mínima de la moneda

destination_currency'USDC' | 'USDT' | 'USAT' | 'XAUT' | 'PYUSD'
destination_amountinteger
exchange_ratenumber double
chainstring
recipient_addressstring nullable
created_atstring date-time

Changes

No recorded changes to this endpoint across all 1 revision of this API.