Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.monkepay.xyz/llms.txt

Use this file to discover all available pages before exploring further.

NetworkTypeUse for
base-sepoliaTestnetDevelopment and testing
baseMainnetProduction

​
Choosing a network

Your network is set per-account in the dashboard under Settings. All API keys on your account share the same network setting. Use base-sepolia while:
  • Building and testing your integration
  • Running the agent locally against a dev server
  • Verifying the full payment flow before going live
Switch to base when:
  • Your API is deployed to production
  • You’re ready to receive real USDC

​
Separate balances

Balances on base and base-sepolia are completely independent. Testnet USDC has no real value and never converts to mainnet USDC. Switching your account from testnet to mainnet starts a fresh balance at zero.

​
Testnet USDC

Testnet USDC is free. Get it from: You’ll also need a small amount of testnet ETH for gas. The Coinbase faucet provides both.

​
For agents

Agents must have USDC on the same network as your MonkePay account. If your account is on base-sepolia, agents need testnet USDC. If you’re on base, agents need mainnet USDC. The network is communicated automatically in the x402 402 response — agents don’t need to know your network in advance.

​
Roadmap

Additional EVM networks are planned. Adding a new chain requires:
  1. Coinbase x402 facilitator support for that network
  2. A USDC contract on that network
Chains being evaluated: Arbitrum, Optimism, Polygon. Solana support (SVM) is a separate workstream. See the Roadmap for current status.