TESA API

Draft: specification in progress. Endpoints and fields may change.

The TESA API brings the same infrastructure as the dashboard into your company’s own systems. With it, your integration reads positions and yield, prepares allocations, rebalancing and redemptions, and tracks every on-chain transaction. The keys stay with the company or with the custodian it already uses.

Quickstart

First call in 5 minutes.

Why TESA

What the API saves you compared with building in-house.

API reference

Every endpoint, with parameters and responses.

Webhooks

Deposit, allocation, redemption and billing events.

Examples

End-to-end redemption and rebalancing flows.

Key features

Real-time positions and yield

Consolidated cash, yielding balance, available balance, split between USDY and BUIDL, and accrued yield, with the same figures as the dashboard.

Policy-driven allocation

The company defines the approved assets and the proportion between them. The default portfolio is about 60% USDY and 40% BUIDL.

Rebalancing only with approval

TESA suggests adjustments when the spread between the assets changes, but nothing is executed without the company’s explicit approval.

Redemption in seconds

USDC returns to the company’s custody within seconds of signing, ready for payments.

Complete on-chain trail

Every deposit, CCTP transfer, allocation and redemption generates a record with the transaction hash.

What you can build

Automated treasury

Internal rules that keep a USDC liquidity buffer and send the surplus to earn yield.

Your own dashboard

Positions, yield and charges inside the tool your finance leadership already uses.

ERP integration

Redemptions triggered by the payment batch and automatic reconciliation by internal reference.

Partner custodian

Qualified custodians receive unsigned transactions and offer Treasury yield to their own clients.

Supported networks and assets

Type	Supported
Networks	Ethereum, Solana
Inflow and outflow	USDC, via Circle’s CCTP
Tokenized Treasuries	USDY (Ondo), BUIDL (BlackRock)

Details in Supported networks and assets.

Quick example

Read positions and request a redemption to the operating wallet. Values are illustrative.

TypeScript

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

// 1. How much is yielding and how much is available
const posicoes = await fetch(`${BASE}/posicoes`, { headers }).then((r) => r.json());
console.log(posicoes.rendendo, posicoes.disponivel);

// 2. Request a redemption (stays pending until approved)
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

After approval, the unsigned transaction goes to the custodian, which signs and broadcasts it. The resgate.concluido event arrives by webhook once the USDC is in the destination wallet.

Next steps

Request an API key

Write to contact@t3sa.com with your company name and use case. Your first key is a sandbox key.

Follow the quickstart

Make your first call in 5 minutes, from GET /posicoes to the redemption webhook.

Understand the architecture

See in Architecture who holds the keys and how each operation is prepared, approved and signed.

Integrate

Use the guides and the API reference to take the flow to production.

Access and support

TESA is B2B infrastructure and the API is available to companies only. There is no individual contract per client: access is governed by the Terms of Use, accepted during the organization’s onboarding. Questions about the specification or the integration: contact@t3sa.com.

Getting started

Guides

Reference

API reference

Quickstart

Why TESA

API reference

Webhooks

Examples

Key features

What you can build

Automated treasury

Your own dashboard

ERP integration

Partner custodian

Supported networks and assets

Quick example

Next steps

Access and support

Quickstart

Why TESA

API reference

Webhooks

Examples

​Key features

​What you can build

Automated treasury

Your own dashboard

ERP integration

Partner custodian

​Supported networks and assets

​Quick example

​Next steps

​Access and support

Key features

What you can build

Supported networks and assets

Quick example

Next steps

Access and support