x402 Paid-API Starter Kit
The paid-API server we run in production, as a zip you deploy yourself. Charge agents per call in USDC on Base, with the never-charged-on-failure contract already wired.
01 / What you get
One zip, the whole stack
- 01
The server.
server.mjs,handler.mjsandlib/: facilitators, a store and a fake facilitator for offline tests. Plussmoke.mjsand a contract test. - 02
The contract.
CONTRACT.mdandLAUNCH_CHECKLIST.md: never charged on failure, the body released only after settlement, idempotent recovery. - 03
The deploy. A Caddyfile example, a systemd unit and
DEPLOY.md. - 04
The listings. Example 402 bodies (v1 and v2), a Bazaar discovery extension, llms.txt, openapi.json and /.well-known/x402, plus
DIRECTORIES.md.
- deploy3
- Caddyfile.example
- DEPLOY.md
- your-api.service
- listings7
- 402-body.v1-compatible.example.json
- 402-payment-required.v2.decoded.example.json
- DIRECTORIES.md
- bazaar-discovery-extension.example.json
- llms.example.txt
- openapi.example.json
- well-known-x402.example.json
- server11
- lib
- facilitators.mjs
- fake-facilitator.mjs
- store.mjs
- test
- contract.test.mjs
- .env.example
- .gitignore
- handler.mjs
- package-lock.json
- package.json
- server.mjs
- smoke.mjs
- lib
- CONTRACT.md
- LAUNCH_CHECKLIST.md
- LICENSE.txt
- README.md
sha256 ab5cfc51fba8c9ca877108b4b8a384b9eb095643eb5fcadd6e982d7c172fc477
02 / How to buy
Your agent buys it in one call
Default x402 clients stop at $1, so the one step buyers miss is the limit. Set it to $49.00, fund the agent and repeat the GET.
x402 Paid-API Starter Kit
Ship a pay-per-call agent endpoint in an afternoon.
Research + Rails Retainer (1 month)
Research and rails tuning for teams selling to agents.
White-Label x402 Rails Pack
Our production paid-API rails, under your brand and payTo.
Prepaid API credit
One payment, many calls. Failed calls are never debited.
payx402USDC on Base (eip155:8453)Free /info ↗
payx402USDC on Base (eip155:8453)Free /info ↗
payx402USDC on Base (eip155:8453)Free /info ↗
payx402USDC on Base (eip155:8453)Free /v1/meter ↗
-
01
Pick an offer
Catalog
-
02
Raise payment limit
Limitper-payment limit ≥ $49.00
Default x402 clients stop at $1, so a $49.00 quote is refused before it is signed. Set the limit first.
client.setSpendControls({ maxAmountPerPayment: "$49" }) -
03
Fund your agent
USDC$49.00exact · USDC on Baseone paymentSend USDC on Base to your agent's wallet. The facilitator pays gas, so it needs no ETH. Meter credit can't buy the kit.
-
04
Buy once
Buy$49.00once · never charged on failure- Never charged on failure: any 4xx/5xx is not settled; a failed settlement is a 402.
- The body is released only after settlement succeeds.
- Idempotent: re-send the identical signed request to get the same delivery free (recovered:true, charged_again:false).
-
02
Scope it
Intake30 days from settlement; renew by paying again (each payment = one more month)
Rather pay by invoice or scope first? Email abhay@avasis.ai.
-
03
Raise limit, fund the agent
USDCper-payment limit ≥ $999.00
client.setSpendControls({ maxAmountPerPayment: "$999" })$999.00exact · USDC on Baseone payment -
04
Buy one month
Buy$999.0030 days from settlement · renew by paying again- The 200 body is a purchase receipt with a purchase token and a free status_url. Email the token to start.
- Never charged on failure: any 4xx/5xx is not settled; a failed settlement is a 402.
- Idempotent: identical signed request re-sent = same receipt free.
-
02
Scope it
IntakeOne-time; custom scope agreed at intake, delivered under your brand
Rather pay by invoice or scope first? Email abhay@avasis.ai.
-
03
Raise limit, fund the agent
USDCper-payment limit ≥ $2,500.00
client.setSpendControls({ maxAmountPerPayment: "$2500" })$2,500.00exact · USDC on Baseone payment -
04
Buy the pack
Buy$2,500.00one-time · custom scope agreed at intake- The 200 body carries the purchase receipt, the token, intake steps and the starter-kit code base zip.
- Never charged on failure: any 4xx/5xx is not settled; a failed settlement is a 402.
- Idempotent: identical signed request re-sent = same receipt free.
-
02
Pick a rail
Catalogsizes the pack to the 30-day expiry -
03
Add prepaid credit
USDC600 verdicts · $0.01 each · 25 days at 24/day
Default x402 clients stop at $1. Set your client's per-payment limit (spendControls.maxAmountPerPayment) to at least $5.00 before paying.
Credit expires 30 days after the last top-up. Balance cap $200. Trying it first? Trial pack $0.05 → $0.06 credit
-
04
Run
Run$0.01per call · debited only for 2xx/3xx answerscurl -H "Authorization: Bearer <token>" "https://agents.avasis.ai/v1/sol/token-verdict…"
- Debited only for 2xx/3xx answers; 4xx/5xx/aborted calls are refunded.
- Insufficient or expired balance falls back to the normal per-call x402 402.
- Expiry: 30 days after the last top-up. Balance cap: 200.000 USDC.
- Rate: 25 req/s per token (burst 50).
03 / Guarantees
Paid once, delivered once
- 01
Never charged on failure: any 4xx/5xx is not settled; a failed settlement is a 402.
- 02
The body is released only after settlement succeeds.
- 03
Idempotent: re-send the identical signed request to get the same delivery free (recovered:true, charged_again:false).
License
Use, modify and deploy in your own projects (commercial or not); no resale or redistribution as a template, course or starter kit.
Delivery
- Inline
- zip_base64 in the 200 body
- Link
- https://agents.avasis.ai/v1/downloads/x402-starter-kit/<token>/x402-paid-api-starter-kit.zip (application/zip, 30 days, 50 downloads)
- Status
- https://agents.avasis.ai/v1/base/x402-starter-kit/status/<token>
Quote
- Price
- $49.00 · 49000000 atomic USDC
- Network
- eip155:8453 (Base)
- Asset
- USD Coin 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- payTo
- 0x6264191D6dD5427435B5E829077842e130Ef1fc8
- Scheme
- exact · quote timeout 120 s
- Pay URL
- https://agents.avasis.ai/v1/base/x402-starter-kit (agents: a browser gets the free 402 quote)
- Before you sign
client.setSpendControls({ maxAmountPerPayment: "$49" })- Snapshot
- 2026-11-04T20:38:29.498Z · prices re-read at every build
Verify the payTo against the live 402 quote before you sign, never against explorer history.
Questions before you buy
Talk to a human, or let your agent buy
Rather pay by invoice or scope first? Email abhay@avasis.ai.
//Agents: agents.md lists every paid route with its exact cap.