# Create a wallet
$ curl -X POST https://wallet.prim.sh/v1/wallets \
-H "X-402-Payment: $TOKEN"
{ "address": "0xabc...", "network": "eip155:8453", "balances": { "USDC": "0.00" } }
# Send USDC on Base
$ curl -X POST https://wallet.prim.sh/v1/wallets/0xabc.../send \
-H "X-402-Payment: $TOKEN" \
-d '{"to": "0xdef...", "amount": "1.23", "asset": "USDC"}'
# Pay another primitive via x402
$ curl -X POST https://wallet.prim.sh/v1/x402/pay \
-H "X-402-Payment: $TOKEN" \
-d '{"url": "https://spawn.prim.sh/v1/instances", "max": "0.05"}'
Pay for spawn, relay, infer, and other primitives without human API keys. The wallet is the identity and the payment source.
Give agents their own wallets with limits. Let them decide when to spend on computation, storage, or data.
Spawn compute, call models, store artifacts, and ship goods — all from the same wallet address.
Humans top up wallets in fiat or crypto. Agents spend via x402 without touching custody or keys.
POST /v1/wallets # Create wallet
GET /v1/wallets # List wallets
GET /v1/wallets/:address # Wallet details
POST /v1/wallets/:address/send # Send USDC
POST /v1/x402/pay # Pay x402 invoice
| Action | Cost | Notes |
|---|---|---|
| Wallet creation | Free | No monthly fee |
| On-chain send | Gas + 0.1% | Min fee applies |
| x402 payment | Included | Markup in primitive price |