Skip to main content
Read the balances of your own personal wallet — the funding source the crypto rails pull from when pay_service charges a personal delegation. It answers how much do I have, and on which chain. Reading charges nothing. Needs a credential. Auth: key / grant · Charges: nothing

Arguments

Returns

The wallet address and, per network, its token balances and the money it has locked in payment channels:
Read the network the merchant quoted, not the one with money in it. Live settles on two chains with two tokens — most services accept only one. A healthy balance on one chain says nothing about a purchase on the other; that’s why every chain is reported by default.
  • A token whose atomic/formatted is null was not read (the on-chain read failed) — that is not a zero balance. A chain that couldn’t be read at all comes back as an entry with error instead of balances.
  • lockedInChannels is money your payer wallet (the one the Router signs MPP payments with, which is this wallet once your account is migrated) has deposited into payment channels with merchants that charge per call over an MPP session, per token, held in the channel’s escrow. It is not part of balances and it is not spent: it can pay further calls only to the merchant holding that channel, and what is unused comes back to that wallet when the channel closes, after 15 minutes without use. Report it beside the balance, never as spending, and never count it toward paying any other merchant. A null symbol/decimals/formatted here means a token Nevermined does not recognise (report atomic as raw units of token), not an unread amount. An empty list means nothing is locked; null means it could not be read, not that nothing is locked.
  • Pass a chain id this deployment does not serve and you get the deployment’s primary network back (its own chain id, not the one you asked for) with a warning — so those balances say nothing about the chain you asked about.

What it doesn’t cover

  • A delegation backed by an organization wallet is paid from that wallet, not this one.
  • A card delegation has no wallet at all — there BCK.ROUTER.0009 is the card issuer declining, with nothing to top up, so this tool doesn’t apply and the fix is a different card.
  • On MPP the wallet is checked before anything is signed, and BCK.ROUTER.0009 names the wallet and chain but never how much is there — which is what this tool supplies. On x402 there’s no balance pre-check and BCK.ROUTER.0009 is never raised: the credential is minted, budget is reserved, and a short wallet only surfaces when the merchant’s on-chain transfer fails — by which point the budget is already committed, and the reserve comes back only once the reconciler sees the authorization expire unconsumed. So read the balance before you pay, and don’t read a just-committed reserve as money lost.
This tool diagnoses, it doesn’t fix: an agent can’t top up its own wallet, so a genuine shortfall is a stop condition — report the network and amount to the human and don’t retry. The human adds funds from the Wallet in the Nevermined App: they pick the network, then use + Add on the token’s row. Receive funds is a plain transfer, on any network this tool lists. Buy with card covers USDC on live Base (8453) and USDC.e on live Tempo (4217) only, never a testnet, and is region-restricted; it isn’t offered for EURC / EURC.e. On Tempo, + Add is enabled only once the account wallet has had its EIP-7702 upgrade. See Fund your wallet.

Nevermined credits

With an API key, the result also carries the same subscription, credits and creditsMessage fields as get_budget: your Nevermined credits, free and top-up credits included, by kind and expiry, and your subscription if you have one. Credits aren’t in your wallet — Nevermined pays the merchant on a credits call, so a credits call needs no wallet balance at all.

Try it

Ask your assistant:
What is my wallet balance on each network?
Call it directly (charges nothing):