Pular para o conteúdo principal
Rascunho: especificação em definição. Endpoints e campos podem mudar.
Rebalancear é ajustar a proporção entre USDY e BUIDL no saldo rendendo. A empresa define quando isso acontece: as regras ficam na política de alocação, e todo rebalanceamento só acontece com aprovação e assinatura da empresa. A TESA não recomenda alocações nem define gatilhos.

De onde vêm as propostas

  • Geradas por uma regra da sua política (origem: regra): você define o gatilho, por exemplo spread de taxa acima de um limite escolhido por você. Quando a sua regra é atingida, o software prepara a transação e o evento alocacao.proposta avisa a integração. O campo regra_id indica qual regra foi atingida.
  • Criadas manualmente pela integração (origem: manual): com POST /propostas, informando a alocação alvo escolhida pela empresa.
O monitoramento das regras funciona como relatório de enquadramento da carteira à política da própria empresa, não como sugestão.

Fluxo

1

Receba ou crie a proposta

2

Revise os movimentos

GET /propostas/{id} mostra movimentos e alocacao_resultante. Confira antes de aprovar.
3

Aprove ou rejeite

Com uma chave admin, chame POST /propostas/{id}/aprovar ou POST /propostas/{id}/rejeitar. A aprovação exige Idempotency-Key e, na proposta atual, pode ser assinada com HMAC.
4

Assine no custodiante

A proposta aprovada traz transacoes[].payload_nao_assinado. O custodiante assina e transmite.
5

Acompanhe a execução

Depois da confirmação on-chain, a proposta passa a executada e os registros do tipo rebalanceamento aparecem em GET /registros.

Alterar a política

Para mudar a proporção ou as regras de forma permanente, e não só uma vez, use PUT /politica-de-alocacao. A nova versão vale para depósitos futuros e suas regras passam a gerar as próximas propostas. A soma dos percentuais deve fechar em 100, senão a API retorna 422 com politica_invalida. Cada regra tem um gatilho (spread_acima ou desvio_da_alocacao) e um limite escolhido pela empresa. A TESA não sugere limites.
Aprovar não move fundos. A movimentação só acontece depois da assinatura no custodiante da empresa.