Base wallet balance API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent the ETH and USDC balance of any Base address, read live from the chain with the block it was read at, from $0.003 per lookup.
Ask in plain words, like 'does this wallet hold at least 5 USDC on Base', and get a yes or no with the numbers.
No subscription · Sign-up optional · From $0.003 per call · Charged only when it works · No account needed
Does 0x7a3c...8a1c hold any USDC or ETH on Base?
TollNode · base-wallet-balance$0.003 · 1 lookup · 1 s
| Field | Value |
|---|---|
| ETH | 0 |
| USDC | 0 |
| Chain | Base |
| Block | 57,885,638 |
Real result.
What your agent gets from a balance check
Balances
Base wallet balance API
ETH and USDC, as exact decimal strings.
- ETH
- 0
- USDC
- 0
- Chain
- Base
You get
- eth: ETH balance
- usdc: USDC balance
- address: the address you asked about
- chain: always Base
- format: decimal strings, no rounding
Proof of freshness
Which block it was read at.
- Block
- 57,885,638
- USDC contract
- 0x833589fC...A02913
- Source
- the chain, live
You get
- block: the block number it was read at
- USDC contract: the token contract checked
- live read: read from the chain, not cached
- input: a 0x address, 40 hex characters
- scope: Base only, ETH and USDC only
Every result is structured JSON your agent can sort, filter, summarize or turn into a spreadsheet.
What people ask their AI to do with it
Agent builders
Check funds before paying
“Does this agent wallet hold at least 5 USDC on Base before I run the next call?”
1 call
Cost today$0.003
Founders
Confirm a transfer landed
“Did the 100 USDC I sent to this address arrive?”
1 call
Cost today$0.003
Finance teams
Verify a payout wallet
“What is the USDC balance of our payout address right now?”
1 call
Cost today$0.003
Support teams
Answer a customer fast
“Check this customer's wallet for the USDC they say they sent”
1 call
Cost today$0.003
Developers
Gate an action on balance
“Only run the next step if the wallet holds enough USDC”
1 call
Cost today$0.003
Auditors
Spot-check a treasury
“Read the balance of these 3 treasury addresses”
3 calls
Cost today$0.009
Use it as a Base wallet balance MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's Base wallet balance node. Call POST https://tollnode.com/api/v1/nodes/base-wallet-balance with address (required). The price is one flat price per call, charged only when it returns a result. Over MCP, call the "base-wallet-balance" tool; use list_models to see prices. Return results as tables when I ask for lists.Price
$0.003
per lookup
Charged only when a call returns a result. Failed or empty calls cost $0.
Base wallet balance without running your own tools
No subscription, no credit packs
Pay per lookup: $0.003 for every call, with nothing to choose.
No node, no RPC key, no block explorer account
Your agent calls TollNode. You never set up billing or request access with anyone else.
Only charged when it works
If a call returns nothing or fails, it costs nothing.
One connection, much more
The same setup also gives your agent Google search, YouTube, Maps, images and video, so one prompt can chain them.
FAQ
- Is this an official chain API?
- No. TollNode reads the Base chain itself and returns the balance as plain data. There is no account or RPC key to set up.
- Can I use it as a Base wallet balance MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "base-wallet-balance" tool appears with its fields and price.
- Which tokens does it cover?
- ETH and USDC on Base only. Other chains, other tokens and transaction history are not covered.
- Can it move funds?
- No. It only reads balances. It never holds or sends money.
- What do I send?
- A Base (EVM) address: 0x followed by 40 hex characters.
- What if nothing comes back?
- You're not charged. TollNode only collects payment when a usable result is returned, and your agent can try a different input.
- How do I pay for Base wallet balance?
- Your agent sends the request, gets an HTTP 402 with the exact price (from $0.003 per call), signs a USDC payment on Base and retries. Or use an account balance with an API key. Either way you are charged only when a result comes back.
- What does the Base wallet balance response look like?
- Structured JSON, with the fields listed in the cards above. Your agent can sort it, filter it, summarize it or turn it into a table or spreadsheet.
Works well with
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/base-wallet-balance
Input
| Field | Type | Notes |
|---|---|---|
| address* | string | A Base (EVM) address, 0x followed by 40 hex characters |
Example response
{
"eth": "0",
"usdc": "0",
"block": 57885638,
"chain": "Base",
"address": "0x7a3c9e1b5d2f4a6c8e0b1d3f5a7c9e2b4d6f8a1c",
"usdcContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.