Wallet & balance

Your wallet is the container of your cards, like Apple Wallet. Your balance is the cash that funds new cards — held in USDC, but you add and withdraw in USD.

Show your wallet

agent-cards wallet

Shows the cards in your wallet, then your balance (with any deposit still settling). The first run provisions everything automatically.

Check your balance

agent-cards balance          # your cash balance (add --json for scripts)
agent-cards balance <cardId> # one card's remaining balance

Add cash

agent-cards fund --amount 50

Option	Description
`--amount <dollars>`	Required. Amount in dollars (e.g. `50` = $50.00), up to$ 10,000.00. The minimum is $2.00 or$ 20.00 depending on your funding provider — the error tells you your exact range.
`--method <method>`	`apple_pay` (default) or `google_pay`.

Opens a checkout page in your browser — pay with Apple Pay or Google Pay and the cash lands in your balance within minutes. First-time funding asks for a one-time verification code (sent by text or email); it stays fresh for 60 days.

Brand-new account? Identity verification comes first. Run agent-cards cards create — it walks you through identity (ID photo + a short face scan), sends the one-time code, and funds your balance in the same flow. After that one-time step, agent-cards fund works directly.

agent-cards redeem SUMMER25   # the credit lands in your balance
agent-cards codes             # your code history: used, processing, retryable

Each code works once per user. The credit becomes spendable within a minute or two; agent-cards balance shows it land. If a redemption fails mid-transfer, nothing is consumed: agent-cards codes marks it retryable and you can run redeem again with the same code. Both commands take --json for scripts.

Withdraw

# To your bank account (picks a saved account, or walks you through adding one)
agent-cards withdraw --amount 25

# As USDC on Base, to an address you control
agent-cards withdraw --amount 25 --to 0xYourWallet...

Option	Description
`--amount <dollars>`	Required. Amount in dollars, $2.00 to$ 10,000.00 per request.
`--to <address>`	Send USDC on Base to this `0x` address instead of a bank account.

Withdrawals are processed by our team, usually within 1-3 business days — you get an email when the request is received and another when it’s sent. Open requests hold your balance until they complete, so you can never over-request. Bank accounts are saved once and reused: US accounts use ACH (routing + account number), everywhere else uses an international wire (IBAN + SWIFT). Some countries need one extra identifier — the CLI prompts for it (IFSC in India, CLABE in Mexico, BSB in Australia). Account numbers are masked everywhere after saving. Crypto withdrawals go to any address on Base — double-check it, crypto transfers can’t be reversed. Agentcard-managed addresses are rejected. If you connected through a company’s app and withdrawals are unavailable, that company has disabled them — contact them.

The older spellings agent-cards wallet fund and agent-cards wallet withdraw keep working as aliases.

Get Started

CLI

MCP

Guides

Concepts

Show your wallet

Check your balance

Add cash

Withdraw

​Show your wallet

​Check your balance

​Add cash

​Redeem a promo code

​Withdraw

Show your wallet

Check your balance

Add cash

Redeem a promo code

Withdraw