agents.u.cash

The agent + merchant surface for the 402 Online Protocol — multi-coin, non-custodial.

Quickstart

curl -X POST https://agents.u.cash/v1/signup \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"longpass"}'

# -> {"success":true,"response":{"api_key":"…","activated":false,"next":"POST /v1/top-up …"}}

Then activate with a $1 top-up and configure your own receive wallets:

curl -X POST https://agents.u.cash/v1/top-up \
  -H 'X-Api-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"amount":1}'

curl -X POST https://agents.u.cash/v1/wallets \
  -H 'X-Api-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"asset":"btc","address":"bc1q…"}'

Endpoints

• POST /v1/signup — register, get your api_key (wallet-first)
• POST /v1/top-up — $1 min; activates the account on confirmation
• GET /v1/agent — balance, activation state, your wallets
• POST /v1/wallets — set your own receive address per asset
• POST /v1/resources — create a priced resource
• POST /v1/challenge — build the multi-coin 402 accepts[]
• POST /v1/verify — verify + settle a payment (tx hash)
• GET /r/{res_id} — the 402 door (public)

Reference

OpenAPI spec · llms.txt · Protocol spec