DEV Community

FiatDock
FiatDock

Posted on • Originally published at fiatdock.com

How my AI agent cashes out its USDC earnings to a bank account

My agent earns USDC. It sells API calls priced with x402, so tiny payments accumulate in its wallet. Which eventually raises the unglamorous question every "agents earning money" demo skips: how does that USDC become money a human can spend at a supermarket?

Here is the pattern I landed on. It needs no exchange account for the agent, no API keys, and — importantly — nobody in the middle ever holds the funds.

The constraint that shapes everything

Whatever converts crypto to fiat is regulated activity (KYC/AML, custody, payments). An autonomous agent can't and shouldn't do that part. So the design splits cleanly:

  • The agent handles quotes, session creation, payment of fees, and status tracking — all machine-to-machine.
  • A licensed provider (Transak, in this case) does the conversion, the KYC, and the custody.
  • The human owner confirms the final transfer once per session, and completes KYC exactly once, ever.

The service tying these together is FiatDock — a thin technology layer that never touches funds. One rule is binding and worth stating up front: the wallet sending USDC and the bank account receiving fiat must belong to the same person — the agent's owner. No third-party funds, no aggregation, no P2P.

Step 1 — the agent checks the rate (free)

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

No auth, no signup. The response itemises every fee (including the service's 1% commission) and the exact amount that lands in the bank account. My agent calls this before deciding whether cashing out now is worth it.

Step 2 — the agent pays for a session with x402

Paid endpoints don't use API keys. An unpaid request returns HTTP 402 with exact payment requirements — asset, network, amount ($0.05 USDC), and the address. The agent signs the payment from its own wallet and retries:

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();
Enter fullscreen mode Exit fullscreen mode

Payment, authentication, and rate-limiting collapse into one signed transfer. That's the whole x402 trick, and it's why this works for agents that can't fill out a signup form.

Step 3 — hand the human the link

checkoutUrl is single-use and valid about five minutes. My agent just messages it to me. I open it, the licensed provider runs KYC (first time only — afterwards it remembers), and I confirm. USDC goes from the wallet straight to the provider; EUR lands in my bank account. The agent never saw a bank credential, and FiatDock never held a cent.

Step 4 — the agent confirms completion

curl https://fiatdock.com/v1/orders/$ORDER_ID
Enter fullscreen mode Exit fullscreen mode

Or pass a callbackUrl in step 2 and verify the X-FiatDock-Signature HMAC header on each push. Either way the agent knows when the money arrived and goes back to work.

The reverse direction — topping up the agent (on-ramp)

The same pattern works the other way when the agent needs working capital. POST /v1/onramp/session (also $0.05 via x402) creates a top-up session with the destination locked to the agent's own wallet address; the owner opens the checkout link, pays EUR from their own bank or card, and USDC lands in the agent's wallet. Quotes for this direction are the same free call with side=BUY:

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

One flow out, one flow in — and the same binding rule in both directions: the fiat side is always the owner's own account, the crypto side is the owner's agent wallet. Nothing crosses between strangers.

If your agent speaks MCP, it's even shorter

The whole flow above is wrapped in four MCP tools (get_quote, create_offramp_session, create_onramp_session, get_order_status):

{
  "mcpServers": {
    "fiatdock": {
      "command": "npx",
      "args": ["-y", "fiatdock-mcp"],
      "env": { "AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

That config works as-is in Claude Desktop, Cursor, Windsurf, and Gemini CLI; there's a remote endpoint (https://fiatdock.com/mcp) for zero-install hosts, and a tools.json with OpenAI/Gemini function-calling schemas if you're not using MCP at all. It's in the official MCP Registry as com.fiatdock/fiatdock-mcp. Per-client configs live in INTEGRATIONS.md.

Honest limitations

  • Eligibility: 18+, Portugal + Transak-supported EU/EEA countries — not the UK or restricted jurisdictions (full list). The restrictions come from the licensed provider's coverage.
  • Quotes are indicative; crypto is volatile; none of this is investment advice.
  • The human stays in the loop by design. That's a feature, not a missing automation — it's what keeps the whole thing compliant.

Everything is documented machine-first if you want to point your own agent at it and let it figure things out: llms.txt · OpenAPI · repo.

Top comments (0)