API da TesaPrévia · especificação em definição

Sua tesouraria, programável.

Aloque, resgate e audite pelo seu sistema, sem abrir mão da custódia.

Solicitar chave de API Documentação

  • REST + JSON
  • Bearer por organização
  • Webhooks assinados
  • Sandbox
tesa · sandbox conectado 

          $ curl https://sandbox.api.t3sa.com/v1/posicoes \
              -H "Authorization: Bearer $TESA_API_KEY"
          HTTP/1.1 200 OK
          { "caixa_total": "1284530.00", "rendendo": "842110.00",
            "alocacao": { "USDY": 60, "BUIDL": 40 } }
           
          $ curl -X POST https://sandbox.api.t3sa.com/v1/propostas/prp_7Hq2/aprovar \
              -H "Authorization: Bearer $TESA_API_KEY" \
              -H "Idempotency-Key: 4f9c2a1e"
          HTTP/1.1 202 Accepted
          { "status": "aprovada", "proximo": "assinatura_custodiante" }
           
          ▸ webhook  alocacao.aprovada     14:04:07
          # aguardando a assinatura do custodiante
          $

Simulação no sandbox. Endpoints e campos podem mudar. Valores ilustrativos.

Como funciona

A Tesa prepara. Você decide.

Nada executa sem a sua aprovação e a assinatura do seu custodiante.

  1. Tesa 01Tesa prepara Proposta de alocação, rebalanceamento ou resgate. alocacao.proposta
  2. Você 02Você aprova No painel ou por uma chamada à API. POST /propostas/{id}/aprovar
  3. Seu custodiante 03Custodiante assina A chave fica com ele. Nunca com a Tesa. fora da Tesa
  4. Rede 04Execução A operação liquida em USDC nativo. evento por webhook
  5. On-chain 05Registro on-chain Hash, rede e horário de cada movimento. GET /registros

Recursos

Seis recursos, uma tesouraria.

Base /v1, JSON e erros com código estável.

GET/posicoes

Posições

Caixa, parcela rendendo e alocação atual.

escopoleitura

PUT/politica-de-alocacao

Política de alocação

Metas por ativo. Padrão: USDY 60%, BUIDL 40%.

escopoadmin

POST/propostas/{id}/aprovar

Propostas de rebalanceamento

Revise e aprove o que a Tesa preparou.

escopoadmin

POST/resgates

Resgates

Parcial ou total, de volta ao seu custodiante.

escopopropor

GET/registros

Registros on-chain

Cada movimento com hash, rede e horário.

escopoleitura

GET/rendimento

Rendimento e cobranças

Yield apurado e a cobrança de 5% do yield.

escopoleitura

Lista parcial e sujeita a mudança. Referência na documentação

Webhooks

Cada evento, no seu sistema.

Entregues por HTTPS e assinados com HMAC SHA-256.

  • deposito.confirmadoUSDC recebido na sua custódia.
  • alocacao.propostaA Tesa preparou uma proposta.
  • alocacao.aprovadaAprovada, segue para assinatura.
  • resgate.concluidoSaldo de volta ao custodiante.
  • rendimento.apuradoYield do período calculado.
  • cobranca.emitida5% do yield do período.
POST https://seu-sistema.com/webhooks/tesa 

            Tesa-Evento: alocacao.aprovada
            Tesa-Assinatura: t=1790431447,v1=9c4e1f…b21f
            Content-Type: application/json
             
            {
              "id": "evt_01J8Z6",
              "tipo": "alocacao.aprovada",
              "criado_em": "2026-09-26T14:04:07Z",
              "dados": {
                "proposta": "prp_7Hq2",
                "valor": "842110.00",
                "alocacao": { "USDY": 60, "BUIDL": 40 }
              }
            }

Confira a assinatura com o segredo do endpoint antes de processar. Valores ilustrativos.

Segurança

Acesso mínimo. Chaves com você.

Cada chave faz só o que precisa, de onde você permitir.

  • Chaves por organização

    Bearer, revogáveis a qualquer momento.

  • Escopos

    leituraproporadmin

  • Assinatura HMAC

    Opcional nas chamadas, sempre nos webhooks.

  • Allowlist de IP

    Só aceita chamadas dos seus endereços.

  • Idempotência

    Idempotency-Key evita operação duplicada.

  • Nunca custodiamos chaves

    A assinatura fica no seu custodiante.

Ambientes

Teste no sandbox. Opere em produção.

A mesma interface nos dois, com chaves separadas.

Sandbox

testes

https://sandbox.api.t3sa.com/v1

  • Saldos e ativos de teste
  • Webhooks reais, dados fictícios

Produção

após o onboarding

https://api.t3sa.com/v1

  • Operações reais, sob a sua aprovação
  • Allowlist de IP recomendada
Versionamento

Versão no caminho, /v1. Mudança incompatível só em nova versão.

Acesso

Regras públicas, sem contrato individual.

O uso da API é regido pelos Termos de Uso.
Somente para empresas.

Solicitar chave de API Termos de Uso

Prévia. Endpoints, campos e eventos podem mudar até a publicação da especificação. Valores ilustrativos.