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.

​
Creating an account

Sign up with any of:
  • Email and password
  • Google OAuth
  • MetaMask
  • Coinbase Wallet
  • Any EVM-compatible web3 wallet
If you sign up with a web3 wallet, your payout address is automatically set to your connected wallet address. You can change it later in Settings.

​
API Keys

Go to API Keys → Create Key to generate a new credential pair. Each credential has two parts:
FieldDescription
MONKEPAY_API_KEY_IDPublic identifier. Safe to log.
MONKEPAY_API_KEY_SECRETSigning secret. Never log, never commit.
The secret is shown once at creation time. If you lose it, revoke the key and create a new one.
Store both in your environment: 
MONKEPAY_API_KEY_ID=mk_live_abc123...
MONKEPAY_API_KEY_SECRET=your-secret-here

​
Revoking a key

Go to API Keys, find the key, click Revoke, then confirm. Revoked keys stop working immediately. Any server using that key will start returning errors — redeploy with new credentials before revoking in production.

​
Payout Address

Go to Settings → Payout Address. Your MonkePay account has two wallets: MonkePay Wallet — managed by MonkePay. This receives USDC from every agent payment automatically. You cannot change this address. Payout Address — your personal wallet. This is where you withdraw your balance to. You set and control this. Enter any EVM wallet address and select your network (base for mainnet, base-sepolia for testnet). Save it before requesting your first payout.

​
Networks

MonkePay supports two networks:
NetworkUse for
base-sepoliaDevelopment and testing. Testnet USDC has no real value.
baseProduction. Real USDC.
Your network is set per-account in Settings. Balances on base and base-sepolia are completely separate — testnet balance never carries over to mainnet.
Get free testnet USDC for development from the Circle faucet or the Coinbase Developer Platform faucet.

​
Transactions

The Transactions page shows every payment received. Each row shows:
  • Timestamp
  • Agent wallet address (who paid)
  • Endpoint (which route was called)
  • Amount gross / fee / net
  • Transaction hash (links to Basescan)
  • Network
You can filter by agent address, transaction hash, endpoint path, and date range. Export to CSV for accounting.

​
Payouts

The Payouts page shows your payout history. Payouts are sent to your configured payout address.
Payouts are currently processed manually. Automatic scheduled payouts are coming soon.

​
Reports

In Settings you can download:
  • Tax report — all transactions for a given year as CSV
  • Financial report — transactions for a specific month as CSV