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
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.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
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
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
Si es true, devuelve una cotización sin ejecutar el envío.
Request
Moneda de tu balance a debitar (GTQ, USD, USDC)
Envía este monto si sabes cuánto balance quieres convertir (exact-in), p.ej. “100.00”
O envía solo este monto si sabes cuánto debe llegar al destino (exact-out)
ID público de una dirección cripto guardada (de /crypto_addresses)
O una dirección on-chain nueva (alternativa a crypto_address_id)
Response
Swap creado (asíncrono)
Monto origen en la unidad mínima de la moneda