> ## Documentation Index
> Fetch the complete documentation index at: https://t3sa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API de TESA

> Ponga a trabajar la caja en USDC de su empresa en bonos del Tesoro tokenizados desde su propio sistema, sin entregar las claves.

> [!WARNING]
>
> Borrador: especificación en curso. Los endpoints y campos pueden cambiar.

La API de TESA lleva el mismo software del panel a los sistemas propios de su empresa. Con ella, su integración lee posiciones y rendimiento, prepara asignaciones, rebalanceos y rescates según la política propia de la empresa, y sigue cada transacción on-chain. Las claves permanecen con la empresa o con el custodio que ya utiliza. TESA no custodia fondos ni claves, no recomienda asignaciones, no administra carteras ni ejecuta órdenes en nombre de la empresa.

> [!NOTE]
>
> Cada empresa debe verificar la normativa aplicable en su jurisdicción.

> [card] [Quickstart](https://t3sa.com/docs/es/api/quickstart.md)
>
> Primera llamada en 5 minutos.

> [card] [Por qué TESA](https://t3sa.com/docs/es/api/por-que-tesa.md)
>
> Qué le ahorra la API frente a construirlo internamente.

> [card] [Referencia de la API](https://t3sa.com/docs/es/api/endpoints.md)
>
> Todos los endpoints, con parámetros y respuestas.

> [card] [Webhooks](https://t3sa.com/docs/es/api/webhooks.md)
>
> Eventos de depósito, asignación, rescate y facturas de uso.

> [card] [Ejemplos](https://t3sa.com/docs/es/api/guias/resgate.md)
>
> Flujos completos de rescate y rebalanceo.

## Funcionalidades principales

> [accordion] Posiciones y rendimiento en tiempo real
>
> Caja consolidada, saldo que está rindiendo, saldo disponible, división entre USDY y BUIDL y rendimiento acumulado, con las mismas cifras del panel.

> [accordion] Asignación guiada por política
>
> La empresa define los activos aprobados, la proporción entre ellos y las reglas de rebalanceo. No hay cartera preseleccionada: TESA no recomienda asignaciones.

> [accordion] Rebalanceo solo con aprobación
>
> Usted define el disparador. Cuando se cumple su regla, el software le avisa y prepara la transacción, y no se ejecuta nada sin la aprobación y la firma de la empresa.

> [accordion] Rescate en segundos
>
> El USDC regresa a la custodia de la empresa a los pocos segundos de la firma, listo para pagos.

> [accordion] Rastro on-chain completo
>
> Cada depósito, transferencia por CCTP, asignación y rescate genera un registro con el hash de la transacción.

## Qué puede construir

> [card] Tesorería automatizada
>
> Reglas internas que mantienen un colchón de liquidez en USDC y envían el excedente a rendir.

> [card] Su propio panel
>
> Posiciones, rendimiento y facturas de uso dentro de la herramienta que su área financiera ya utiliza.

> [card] Integración con el ERP
>
> Rescates disparados por el lote de pagos y conciliación automática por referencia interna.

> [card] Custodio socio
>
> Los custodios reciben transacciones sin firmar y ofrecen a sus propios clientes el rendimiento de los bonos del Tesoro.

## Redes y activos compatibles

| Tipo | Compatible |
| - | - |
| Redes | Ethereum, Solana |
| Ingreso y egreso | USDC, mediante el CCTP de Circle |
| Bonos del Tesoro tokenizados | USDY (Ondo), BUIDL (BlackRock) |

Detalles en [Redes y activos compatibles](https://t3sa.com/docs/es/produto/redes-e-ativos-suportados.md).

## Ejemplo rápido

Lea las posiciones y solicite un rescate hacia la billetera operativa. Los valores son ilustrativos.

```typescript TypeScript theme={null}
const BASE = "https://sandbox.api.t3sa.com/v1"; // URL propuesta
const headers = {
  Authorization: `Bearer ${process.env.TESA_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Cuánto está rindiendo y cuánto está disponible
const posicoes = await fetch(`${BASE}/posicoes`, { headers }).then((r) => r.json());
console.log(posicoes.rendendo, posicoes.disponivel);

// 2. Solicitar un rescate (queda pendiente hasta ser aprobado)
const resgate = await fetch(`${BASE}/resgates`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    valor: "150000.00",
    carteira_destino_id: "cart_3k9d",
    referencia_interna: "folha-2026-09",
  }),
}).then((r) => r.json());

console.log(resgate.id, resgate.status); // res_4t7x pendente
```

Tras la aprobación, la transacción sin firmar va al custodio, que la firma y la transmite. El evento `resgate.concluido` llega por webhook cuando el USDC está en la billetera de destino.

## Próximos pasos

**1. Solicite una clave de API**

Escriba a [contact@t3sa.com](mailto:contact@t3sa.com?subject=Solicitud%20de%20clave%20de%20API%20TESA) con el nombre de su empresa y el caso de uso. Su primera clave es una clave de sandbox.

**2. Siga el quickstart**

Haga su [primera llamada en 5 minutos](https://t3sa.com/docs/es/api/quickstart.md), desde `GET /posicoes` hasta el webhook de rescate.

**3. Entienda la arquitectura**

Vea en [Arquitectura](https://t3sa.com/docs/es/api/arquitetura.md) quién tiene las claves y cómo se prepara, aprueba y firma cada operación.

**4. Integre**

Use las [guías](https://t3sa.com/docs/es/api/guias/rebalanceamento.md) y la [referencia de la API](https://t3sa.com/docs/es/api/endpoints.md) para llevar el flujo a producción.

## Acceso y soporte

TESA es infraestructura B2B y la API está disponible solo para empresas. No hay un contrato individual por cliente: el acceso se rige por los [Términos de Uso](https://t3sa.com/docs/es/legal/termos-de-uso.md), aceptados durante la incorporación de la organización.

Consultas sobre la especificación o la integración: [contact@t3sa.com](mailto:contact@t3sa.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.