> ## 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.

# Rebalanceo

> Cómo las reglas de su política generan transacciones de rebalanceo para que usted las apruebe y las firme

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

Rebalancear significa ajustar la proporción entre USDY y BUIDL en el saldo que está rindiendo. La empresa decide cuándo ocurre: las reglas viven en la política de asignación, y todo rebalanceo ocurre solo con la aprobación y la firma de la empresa. TESA no recomienda asignaciones ni define disparadores.

## De dónde vienen las propuestas

* **Generadas por una regla de su política** (`origem: regra`): usted define el disparador, por ejemplo un diferencial de tasas por encima de un umbral que usted elija. Cuando se cumple su regla, el software prepara la transacción y el evento `alocacao.proposta` avisa a la integración. El campo `regra_id` indica qué regla se cumplió.
* **Creadas manualmente por la integración** (`origem: manual`): con `POST /propostas`, indicando la asignación objetivo elegida por la empresa.

El monitoreo de reglas funciona como un informe sobre el cumplimiento de la política propia de la empresa por parte de la cartera, no como una sugerencia.

```mermaid theme={null}
stateDiagram-v2
  [*] --> pendente
  pendente --> aprovada: aprobar
  pendente --> rejeitada: rechazar
  aprovada --> executada: firmada por el custodio y confirmada on-chain
```

## Flujo

**1. Reciba o cree la propuesta**

```bash theme={null}
curl -X POST https://api.t3sa.com/v1/propostas \
  -H "Authorization: Bearer tesa_live_..." \
  -H "Idempotency-Key: 3c9a0d52-1e7b-4f28-8d6a-5b2e7f0c9a14" \
  -H "Content-Type: application/json" \
  -d '{"alocacao_alvo":[{"ativo":"USDY","percentual":55},{"ativo":"BUIDL","percentual":45}],"motivo":"Revisão trimestral"}'
```

**2. Revise los movimientos**

`GET /propostas/{id}` muestra `movimentos` y `alocacao_resultante`. Revíselos antes de aprobar.

**3. Apruebe o rechace**

Con una clave `admin`, llame a `POST /propostas/{id}/aprovar` o `POST /propostas/{id}/rejeitar`. La aprobación exige una `Idempotency-Key` y, en la propuesta actual, puede firmarse con HMAC.

**4. Firme con el custodio**

La propuesta aprobada incluye `transacoes[].payload_nao_assinado`. El custodio firma y transmite.

**5. Siga la ejecución**

Tras la confirmación on-chain, la propuesta pasa a `executada` y aparecen registros de tipo `rebalanceamento` en `GET /registros`.

## Cambiar la política

Para cambiar la proporción o las reglas de forma permanente, y no solo una vez, use `PUT /politica-de-alocacao`. La nueva versión se aplica a los depósitos futuros y sus `regras` generan las próximas propuestas. Los porcentajes deben sumar 100; de lo contrario, la API devuelve `422` con `politica_invalida`.

Cada regla tiene un `gatilho` (`spread_acima` o `desvio_da_alocacao`) y un `limite` elegido por la empresa. TESA no sugiere umbrales.

> [!NOTE]
>
> Aprobar no mueve fondos. Los fondos se mueven únicamente después de la firma del custodio de la empresa.


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