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. En Sandbox, esta operación y su modo de cotización están bloqueados.

Authentication

X-SECRET-KEYstring
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`.

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)

idstringOptional
statusenumOptional
source_currencystringOptional
source_amountintegerOptional

Monto origen en la unidad mínima de la moneda

destination_currencyenumOptional
destination_amountintegerOptional
exchange_ratedoubleOptional
chainstringOptional
recipient_addressstring or nullOptional
created_atdatetimeOptional

Errors

403
Forbidden Error
422
Unprocessable Entity Error