Quién tiene qué
La API nunca almacena, recibe ni solicita una clave privada. La clave de API autentica la integración, pero no firma transacciones.
Ciclo de vida de una operación
Toda operación que mueve fondos (asignación, rebalanceo o rescate) pasa por cinco etapas: preparar, aprobar, firmar, ejecutar y registrar.1
Preparar
El software arma la operación según la política de asignación definida por la empresa, cuando se cumple una de sus reglas o a solicitud de la integración, y devuelve una propuesta con los movimientos calculados.
2
Aprobar
La empresa la aprueba o la rechaza en el panel o por la API, con una clave de alcance
admin. Sin aprobación, no se ejecuta nada.3
Firmar
Las transacciones sin firmar van a la billetera de la empresa, en autocustodia o con el custodio autorizado en su jurisdicción.
4
Ejecutar
Las transacciones firmadas se transmiten. El USDC se mueve por el CCTP de Circle y se asigna a USDY y BUIDL, o regresa a la custodia de la empresa en el caso de un rescate.
5
Registrar
TESA sigue la confirmación, actualiza las posiciones y envía webhooks con el hash de cada transacción.
Entornos
Cada entorno tiene sus propias claves. Las URL de arriba son propuestas y todavía no están activas.
Convenciones
- Formato: JSON en UTF-8, con campos en
snake_case. - Montos: los montos en USDC son cadenas decimales con dos decimales (
"842110.00"), para evitar pérdida de precisión. - Fechas: ISO 8601 en UTC (
2026-09-01T00:00:00Z). - Identificadores: cadenas opacas con un prefijo por recurso, como
prop_,res_ycart_. - Paginación: las listas usan cursor, con los parámetros
limiteyapos.
Versionado
La versión mayor va en la ruta (/v1). Los cambios compatibles hacia atrás, como nuevos campos o eventos, se publican sin cambiar de versión, y su integración debe ignorar los campos que no reconozca. Los cambios incompatibles crean una nueva versión mayor, con un período de coexistencia anunciado con anticipación. Siga el changelog.