Como meu agente de IA converte ganhos em USDC para uma conta bancária

Meu agente ganha USDC. Ele vende chamadas de API precificadas com x402, então pequenos pagamentos se acumulam em sua carteira. O que eventualmente levanta a questão pouco glamourosa que toda demonstração de "agentes ganhando dinheiro" ignora: como esse USDC se torna dinheiro que um humano pode gastar em um supermercado?

Aqui está o padrão que eu encontrei. Ele não precisa de uma conta de câmbio para o agente, sem chaves de API, e — o mais importante — ninguém no meio nunca detém os fundos.

A restrição que molda tudo

Qualquer coisa que converta cripto em fiat é uma atividade regulamentada (KYC/AML, custódia, pagamentos). Um agente autônomo não pode e não deve fazer essa parte. Portanto, o design se divide claramente:

• O agente lida com cotações, criação de sessões, pagamento de taxas e rastreamento de status — tudo máquina a máquina.
• Um provedor licenciado (Transak, neste caso) faz a conversão, o KYC e a custódia.
• O proprietário humano confirma a transferência final uma vez por sessão e completa o KYC exatamente uma vez, para sempre.

O serviço que une tudo isso é FiatDock — uma camada de tecnologia fina que nunca toca os fundos. Uma regra é vinculativa e vale a pena declarar desde o início: a carteira enviando USDC e a conta bancária recebendo fiat devem pertencer à mesma pessoa — o proprietário do agente. Nenhum fundo de terceiros, nenhuma agregação, nenhum P2P.

Passo 1 — o agente verifica a taxa (grátis)

curl "https://fiatdock.com/v1/quote?side=SELL&cryptoAmount=50"

Sem autenticação, sem cadastro. A resposta detalha cada taxa (incluindo a comissão de 1% do serviço) e o valor exato que chega na conta bancária. Meu agente chama isso antes de decidir se vale a pena sacar agora.

Passo 2 — o agente paga por uma sessão com x402

Pontos finais pagos não usam chaves de API. Uma solicitação não paga retorna HTTP 402 com os requisitos de pagamento exatos — ativo, rede, valor ($0,05 USDC) e o endereço. O agente assina o pagamento de sua própria carteira e tenta novamente:

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.AGENT_PRIVATE_KEY));
const res = await payFetch("https://fiatdock.com/v1/offramp/session", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ cryptoAmount: 50, email: "owner@example.com", customerId: "agent-1" }),
});
const { checkoutUrl, partnerOrderId } = await res.json();

Pagamento, autenticação e limitação de taxa colapsam em uma única transferência assinada. Esse é todo o truque do x402, e é por isso que isso funciona para agentes que não podem preencher um formulário de cadastro.

Passo 3 — entregar o link ao humano

checkoutUrl é de uso único e válido por cerca de cinco minutos. Meu agente apenas me envia uma mensagem com ele. Eu o abro, o provedor licenciado executa o KYC (apenas na primeira vez — depois ele se lembra), e eu confirmo. USDC vai da carteira diretamente para o provedor; EUR chega na minha conta bancária. O agente nunca viu uma credencial bancária, e a FiatDock nunca deteve um centavo.

Passo 4 — o agente confirma a conclusão

curl https://fiatdock.com/v1/orders/$ORDER_ID

Ou passe um callbackUrl no passo 2 e verifique o cabeçalho HMAC X-FiatDock-Signature em cada push. De qualquer forma, o agente sabe quando o dinheiro chegou e volta ao trabalho.

A direção inversa — abastecendo o agente (on-ramp)

O mesmo padrão funciona na outra direção quando o agente precisa de capital de trabalho. POST /v1/onramp/session (também $0,05 via x402) cria uma sessão de recarga com o destino bloqueado para o endereço da própria carteira do agente; o proprietário abre o link de checkout, paga EUR de seu próprio banco ou cartão, e USDC chega na carteira do agente. As cotações para essa direção são a mesma chamada gratuita com side=BUY:

curl "https://fiatdock.com/v1/quote?side=BUY&fiatAmount=100"

Um fluxo para fora, um fluxo para dentro — e a mesma regra vinculativa em ambas as direções: o lado fiat é sempre a conta do proprietário, o lado cripto é a carteira do agente do proprietário. Nada cruza entre estranhos.

Se seu agente fala MCP, é ainda mais curto

Todo o fluxo acima está encapsulado em quatro ferramentas MCP (get_quote, create_offramp_session, create_onramp_session, get_order_status):

{
  "mcpServers": {
    "fiatdock": {
      "command": "npx",
      "args":