RErecurrente
swaps

Enviar stablecoin

Changed on

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.

post/swaps

Request

Query parameters

quoteboolean

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

Headers

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

  • 33bad9197d59Revision changes
    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

  • 3d76463f9fd8Revision changes
    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API