How Do I Create a Paid API Endpoint with x402 Cloud?
In this article
In this article group
- How Do I Create a Project Page?
- How Do I Trigger My Agent from External Apps (Webhooks)?
- Using Bankr from Claude Code
- How Do I Execute Direct Transactions via the Wallet API?
- How Do I Provision Wallets for My Users?
- Why Isn't My x402 Endpoint Listed in the Marketplace?
- How Do I Use Private (Confidential) AI Models?
The easiest way is to ask Bankr in chat: describe what the endpoint should do and what to charge, and Bankr writes it, deploys it, and gives you a live URL. Every time an agent or app calls that URL, it pays you automatically. Bankr handles the hosting and the payments.
Create an Endpoint in Chat
create an x402 endpoint called "sentiment" that takes a stock ticker and returns a sentiment score from recent news. charge $0.005 per request.
The first time, Bankr shows its App Building Terms and waits until you reply exactly I agree. You can also update, reprice, pause, or delete endpoints by asking, for example "change the price of my sentiment endpoint to $0.01".
Prefer the Command Line?
Developers can build and deploy endpoints locally with the Bankr CLI (bankr x402 deploy). Endpoints made in chat and in the CLI are the same, so you can manage either way. See the x402 Cloud quick start on docs.bankr.bot.
Discovery
New endpoints work by URL as soon as they're deployed, but appear in the marketplace only once Bankr enables them for discovery. See Why Isn't My x402 Endpoint Listed in the Marketplace?
Managing Your Endpoints
The x402 Dashboard shows every paid request and your revenue, and is where you add encrypted secrets such as API keys. Endpoints accept USDC on Base by default, and you can price them in another ERC-20 token instead.
Pricing and Payouts
There are no monthly fees. You get a free monthly allowance for USDC- and EURC-priced endpoints, and after that Bankr takes a small platform fee at settlement. Endpoints priced in a custom token pay the fee from the first request. See x402 Cloud Pricing for current numbers.
Payments settle on-chain on Base and go straight to your wallet, so there are no invoices or payout schedules.
Gotchas
You're only paid for successful responses. If your endpoint returns an error, the caller's payment isn't collected.
Paused endpoints don't take payments. Calls to a paused endpoint return 404.
Not in the marketplace yet? That's expected for new endpoints. Share the URL directly in the meantime.
For the handler format, config options, and custom tokens, see x402 Cloud on docs.bankr.bot.