Trilhos que um agente opera sozinho

O que um agente precisa que uma pessoa não precisa

Uma pessoa tolera ambiguidade: lê a tela, entende o erro, tenta de novo. Um agente não. Ele precisa de operação com resultado determinístico, de um jeito de provar que tem autorização para mover fundo, e de um sinal confiável de que a operação terminou.

A API da Hodle é construída nesses três pontos. O disparo é um POST com corpo em JSON. A autorização é a chave do usuário, buscada uma vez e cacheada. O fim da operação chega por webhook assinado, não por polling esperançoso.

• Operações com resultado determinístico, não fluxo de tela.
• Autorização por chave do usuário final, não por sessão de navegador.
• Confirmação por webhook assinado com HMAC, não por polling.
• Gas patrocinado nas redes EVM: o agente não administra saldo de rede.

O que o agente consegue fazer pela API

Cada item é uma chamada documentada. Nenhum passo exige interface.

1. 1Pagar um Pix com saldo em stablecoin. POST /api/wallet/payout, financiado por USDT em Polygon ou Tron, ou USDC em Base.
2. 2Receber de fora do Brasil. POST /api/lightning/invoice emite uma BOLT11 que, ao ser paga, liquida em Pix em segundos.
3. 3Converter reais em ativo. O deposit-asset entrega em Lightning, USDT, USDC ou USDCE num endereço.
4. 4Mover entre redes. USDT para qualquer endereço em Polygon, Base ou Tron, com gas patrocinado nas EVM.
5. 5Ler estado. Endereços por rede, saldo por ativo e extrato paginado de operações.
6. 6Reconciliar. Webhook assinado com HMAC em depósito, payout e mudança de KYC.

Quem autoriza o que

Há dois níveis. A API key identifica a sua plataforma e define o escopo do que ela alcança. A chave do usuário final é o que permite mover os fundos dele: sem ela não há payout nem transfer, por construção.

Isso significa que o desenho do seu agente decide o limite dele. Você escolhe quais usuários ele alcança, quais operações expõe e o que faz antes de cada disparo. A plataforma não decide isso no seu lugar, e a Hodle não movimenta fundo de usuário sem a chave dele.

• API key com escopo por plataforma, nos headers.
• Chave do usuário final necessária para qualquer movimentação.
• A fronteira do agente é o desenho do seu fluxo, não uma configuração nossa.

A chamada que o agente faz

A mesma API que roda o painel da Hodle é a que o agente consome. Autenticação por header, corpo em JSON, resposta com o estado da operação.

• POST /api/wallet/payout — paga Pix com saldo em stablecoin.
• POST /api/lightning/invoice — invoice BOLT11 que liquida em Pix ao ser paga.
• GET wallet-keys — o protectedSymmetricKey do usuário, cacheado uma vez.
• POST wallet-transfer — USDT em Polygon, Base ou Tron.

Ativos e redes que o agente alcança

USDT em Polygon e Tron, USDC em Base, as duas também em Arbitrum e Spark. Bitcoin on-chain e por Lightning. Reais entram e saem por Pix.

USDT

USDC

Bitcoin

Lightning

Polygon

Tron

Base

Arbitrum

Spark