apxpay

Give an AI agent a funded wallet and a spending limit in seconds. The agent then pays APIs autonomously, within its budget. Sandbox (no real money moves).

npx apxpay

You get a funded agent with a per-call spending cap, an API key saved locally, and a one-paste line to connect it to Claude or Cursor.

apxpay try

Your agent autonomously pays a live demo API and prints the result back, with zero human approval, inside its budget.

Commands

| Command | What it does | |---|---| | apxpay | Create a funded agent (aliases: init, card) | | apxpay try | Agent pays a live demo API and prints the result | | apxpay balance | Show wallet balance | | apxpay fund <amount> | Add sandbox dollars | | apxpay connect | Print the Claude/Cursor + SDK connect snippets | | apxpay whoami | Show the saved agent |

Flags (for create)

| Flag | Default | Meaning | |---|---|---| | --name <s> | agent | Agent name | | --budget <n> | 25 | Total spend cap (dollars) | | --per-tx <n> | 5 | Per-call cap (dollars) | | --fund <n> | 25 | Starting sandbox balance (dollars) | | --gateway <url> | hosted sandbox | Point at a specific gateway |

State lives at ~/.apxpay/config.json. Set APXPAY_GATEWAY_URL to change the default gateway.

This is the agent-payments flow end to end: a 402 challenge, an Ed25519-signed payment, a double-entry ledger move, and a verifiable receipt — packaged so you can feel it in under two minutes.