Referencia APISwaps

Enviar stablecoin

Convierte tu balance (GTQ/USD/USDC) y envía stablecoin on-chain a una dirección cripto. Requiere un cliente Bridge activo 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.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

Clave de idempotencia para reintentos seguros de operaciones que mueven dinero. 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
modeenumOptional

Por defecto exact_in

Allowed values:
source_amount_as_decimalstringOptional

Monto origen para exact_in, p.ej. “100.00”

destination_amount_as_decimalstringOptional

Monto destino para 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