Funding your AgentPay wallet
Your AgentPay wallet must hold USDC on Base for the API to pay 402-protected endpoints and other x402 services. This page explains how to fund it.
Why fund?
- Pay for APIs — When your agent hits a 402 Payment Required or x402 endpoint, AgentPay uses your wallet's USDC to satisfy the payment.
- No balance = no pay — If the wallet has insufficient USDC, the payment fails. Keep the wallet topped up so your agent can keep making paid requests.
Get your wallet address
You need your wallet's on-chain address (a 0x... address on Base) to receive USDC.
- Dashboard: Sign in at agentpay.solutions/dashboard, open Wallets, and copy the address for your Base wallet.
- API:
GET /wallets/mewith headerX-Api-Key: <your-api-key>. The response lists wallets; use theaddressfield for the wallet whosenetworkisbase.
Send only USDC on Base to this address. Sending other tokens or USDC on other networks may not be credited to your AgentPay balance.
Ways to fund
1. Receive from someone else
Anyone can send USDC (on Base) to your wallet address. Use cases:
- Payments from users or customers — They send USDC to your AgentPay wallet address.
- Grants or reimbursements — Another wallet sends USDC to your agent's wallet.
No extra step on your side: once the transfer confirms on Base, the funds are in your wallet and available for 402/x402 payments.
2. Self-fund (top up from your own wallet)
You can send USDC to your own AgentPay wallet from:
- A personal wallet (e.g. MetaMask, Coinbase Wallet) on Base
- An exchange (e.g. Coinbase): withdraw USDC to Base and use your AgentPay wallet address as the destination
- Any other wallet or app that supports sending USDC on Base
This is often called "topping the tank": you move USDC from somewhere you hold it into the AgentPay wallet so your agent can spend it on paid APIs.
Steps:
- Get your AgentPay wallet address (dashboard or
GET /wallets/me). - From your other wallet or exchange, send USDC on the Base network to that address.
- After the transaction confirms, the balance is available for AgentPay payments.
3. Buy USDC and send (onramp)
If you don't have USDC yet:
- Buy on an exchange (e.g. Coinbase): buy USDC, then withdraw it to Base using your AgentPay wallet address.
- Fiat onramp (e.g. Coinbase Pay or other onramps): buy USDC with a card or bank transfer, then send it on Base to your AgentPay wallet address.
Always use Base as the network when withdrawing or sending to your AgentPay wallet.
Summary
| Method | What you do |
|---|---|
| Receive from another wallet | Share your wallet address; they send USDC on Base to it. |
| Self-fund | Send USDC on Base from your own wallet or exchange to your AgentPay wallet address. |
| Buy and send | Buy USDC (exchange or onramp), then withdraw/send on Base to your AgentPay wallet address. |
Network: Base only. Token: USDC. After funding, your agent can pay 402 and x402 endpoints using that wallet.