Crear un swap
Convierte saldo entre dos de tus monedas, de forma síncrona y atómica — tu saldo cambia al instante y la plata nunca sale de tu cuenta (sin OTP). Los pares volátiles (BTC/GOLD) comparten los límites por operación y de volumen 24h con payouts y compras con tarjeta. Requiere clave de idempotencia: el replay devuelve el swap original y jamás re-ejecuta.
Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Encabezados
Alternativa al campo idempotency_key del body.
Cuerpo
USDT, USDC, BTC, GOLD USDT, USDC, BTC, GOLD Monto en la moneda de origen (6 decimales para USDT/USDC/GOLD, 8 para BTC).
Clave elegida por el cliente. Los prefijos payin-convert: y checkout-swap: están reservados para las auto-conversiones del sistema y se rechazan con 400 reserved_idempotency_key.
Respuesta
Replay de idempotencia (swap original, jamás re-ejecutado).
Cuenta dueña. Permite a los org admins atribuir cada registro en la vista org-wide.
USDT, USDC, BTC, GOLD USDT, USDC, BTC, GOLD Unidades de destino por unidad de origen (tasa de ejecución marcada).
"completed"
Presente en replays.