Skip to main content
Rascunho: especificação em definição. Endpoints e campos podem mudar.

​
Quem guarda o quê

A API nunca guarda, recebe ou solicita chave privada. A chave de API autentica a integração, mas não assina transações.

​
Ciclo de uma operação

Toda operação que move fundos (alocação, rebalanceamento ou resgate) segue cinco etapas: preparar, aprovar, assinar, executar e registrar.
1

Preparar

A TESA monta a operação conforme a política de alocação e devolve uma proposta com os movimentos calculados.
2

Aprovar

A empresa aprova ou rejeita pelo painel ou pela API, com uma chave de escopo admin. Sem aprovação, nada é executado.
3

Assinar

As transações não assinadas seguem para a carteira da empresa, em self-custody ou no custodiante qualificado.
4

Executar

As transações assinadas são transmitidas. O USDC circula pelo CCTP da Circle e é alocado em USDY e BUIDL, ou volta para a custódia da empresa no resgate.
5

Registrar

A TESA acompanha a confirmação, atualiza posições e emite webhooks com o hash de cada transação.

​
Ambientes

Cada ambiente tem chaves próprias. As URLs acima são propostas e ainda não estão ativas.

​
Convenções

  • Formato: JSON em UTF-8, com campos em snake_case.
  • Valores: montantes em USDC são strings decimais com duas casas ("842110.00"), para evitar perda de precisão.
  • Datas: ISO 8601 em UTC (2026-09-01T00:00:00Z).
  • Identificadores: strings opacas com prefixo por recurso, como prop_, res_ e cart_.
  • Paginação: listas usam cursor, com os parâmetros limite e apos.

​
Versionamento

A versão principal fica no caminho (/v1). Mudanças compatíveis, como novos campos ou eventos, entram sem troca de versão, e a integração deve ignorar campos que não reconhece. Mudanças incompatíveis geram uma nova versão principal, com período de convivência anunciado com antecedência. Acompanhe o changelog.