Skip to main content
Tells you how much USDC a wallet holds right now. We check the blockchain itself each time, rather than adding up the deposits we’ve recorded, so the figure always matches what’s really there. An address is the same on every network your plan includes, so this checks all of them and adds them up.

​
Endpoint

​
Example

​
Response (200)

​
string
required
The network the wallet was first created on, always BASE. The amount next to it is the balance on Base only. It’s there for older setups that only read these two fields.
​
string
required
The balance on chain, as text. Store and compare it as an exact decimal, never a floating-point number.
​
array
required
One entry for each network the address works on, BASE first. We check each network separately. If we can’t read one, it comes back as { "chain": ..., "amount": null, "error": "unavailable" }, and the rest of the call still works.
​
string
required
The total across every network we could read, to 6 decimal places.
​
boolean
required
false if we couldn’t read one of the networks in balances. In that case total is the least the wallet holds, not the full amount. true when we read every network.

​
Errors