Referencia APISwaps

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.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

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.

Query parameters

quotebooleanOptional

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

Request

This endpoint expects an object.
source_currencystringRequired

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

destination_currencyenumRequired
Allowed values:
chainenumRequired
source_amount_as_decimalstringOptional

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

destination_amount_as_decimalstringOptional

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

blockchain_memostringOptional
Requerido para la red stellar
crypto_address_idstringOptional

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

recipient_addressstringOptional

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

Response

Swap creado (asíncrono)

idstring
statusenum
source_currencystring
source_amountinteger

Monto origen en la unidad mínima de la moneda

destination_currencyenum
destination_amountinteger
exchange_ratedouble
chainstring
recipient_addressstring or null
created_atdatetime

Errors

403
Forbidden Error
422
Unprocessable Entity Error