@fiatdock/agentkit

FiatDock actions for Coinbase AgentKit — pay-per-call on-chain intelligence for Base over x402, settled directly from your agent's wallet.

Two actions are free and need no wallet at all, so the provider is useful before your agent has spent anything.

npm install @fiatdock/agentkit

import { AgentKit } from "@coinbase/agentkit";
import { fiatdockActionProvider } from "@fiatdock/agentkit";

const agentkit = await AgentKit.from({
  walletProvider,
  actionProviders: [
    fiatdockActionProvider({ maxPriceUsd: 0.01 }), // optional spending ceiling per call
  ],
});

Actions

| action | price | what it is for | |---|---|---| | token_price | free | Price, liquidity, 24h volume, market cap and the most-liquid pair for any EVM token — by contract address or symbol. No wallet required. | | search_services | free | Search the FiatDock marketplace for MCP services your agent can pay for per call. Matches each server's own tool names, so q: "captcha" finds a captcha solver even if the seller never wrote the word. No wallet required. | | gas_price | $0.001 | Current Base gas price in wei and gwei. | | eth_balance | $0.001 | Native ETH balance of any address on Base. | | usdc_balance | $0.001 | USDC balance — the x402 settlement asset — of any address on Base. | | tx_status | $0.001 | Success/failed, block, confirmations, gas used, from/to. An unknown or pending hash returns 404 so an agent can poll safely. | | address_intel | $0.005 | EOA vs contract, ERC-20 identity, nonce, ETH + USDC balance, and a security verdict flagging phishing / sanctioned / mixer / money-laundering / blacklist associations. Run it on every counterparty, payout target and approval spender. | | token_safety | $0.01 | Honeypot detection, buy/sell tax, owner privileges, holder concentration, LP-locked share, CEX listing. Returns safe \| caution \| danger. | | token_report | $0.05 | Price and the full safety verdict in one payment, instead of chaining two calls. |

Prices are the advertised figures. The authoritative amount always arrives in the HTTP 402 challenge, and @x402/fetch pays what the challenge says.

You are never charged for a missing answer

Every FiatDock failure answers HTTP >= 400, and x402 settles only below 400. A bad address, an unknown token, an upstream outage or a partial scan all cost nothing. The error strings say so, and they carry FiatDock's hint field verbatim — it names the exact fix.

Spending ceiling

maxPriceUsd (or the FIATDOCK_MAX_PRICE_USD environment variable) refuses any action priced above it before the request is made, so an over-budget call costs not even a round trip.

Notes

• Base only. x402 settles on Base here; supportsNetwork declares that, so the actions are not offered to an agent wired to another chain where every payment would fail at signing time.
• This provider never holds, reads or asks for a key. It signs through the wallet provider you already configured, exactly as AgentKit's own x402 provider does.
• The USDC ↔ bank ramp is deliberately not here — not on price, but on shape. It returns a checkout link a human has to open and complete, so an autonomous agent cannot finish the job it starts, and AgentKit already ships an onramp provider. It remains available over MCP (npx fiatdock-mcp) and at fiatdock.com.

MIT · fiatdock.com · docs