Quickstart

A funded, governed agent in 10 seconds, then its first real payment.

The fastest way in. One command mints a sandbox agent with a wallet, a budget, and an API key, then pays a live endpoint so you can see the whole loop.

Create a funded agent

npx agentpay
✓ created agent   acc_8f21c4
✓ wallet funded   $25.00        (sandbox)
✓ budget set      $5.00 / tx · $25.00 total
✓ api key         apk_live_4c…  (saved to .env)

No signup wall. The agent has a wallet, a per-transaction cap, a total budget, and a key you can use from code.

Make its first payment

A paid endpoint returns 402 Payment Required. The CLI signs a payment, settles it, and retries, all in one step.

npx agentpay pay https://agentpay-gateway.fly.dev/demo/fact
→ 402  →  paid $0.10  →  200 OK
"Sea otters hold hands when they sleep so they don't drift apart."

That is the entire protocol: hit a paywall, pay within your limits, get the result.

Set the rules

Budgets are enforced atomically before any money moves. Change them anytime.

# total budget and a per-transaction cap, in dollars
npx agentpay budget --total 25 --per-tx 5

If a payment would cross either limit, it is refused and logged, the agent is never allowed to overspend.

Next steps

  • On-ramps · wire the wallet into Claude, an SDK, or your own loop.
  • Wire protocol · what actually happens on each payment.
  • Agent SDK · pay.fetch and the wallet, in code.