GET /v1/agent/me

Bearer self-service. Poll after signup or refill until spendable credit clears. Returns wallet, balances, price ceiling, and confirmation depth for the calling key.

Bearer pzero_… required. Session cookies are rejected (401).

Request

curl "https://api.pzero.studio/v1/agent/me" \
  -H "Authorization: Bearer pzero_..."

When to poll

After POST /v1/x402/signup or POST /v1/x402/refill, poll until confirmedUsdc covers your first request. Pending credit does not fund inference. topUpConfirmationBlocks is the configured block count; signup/refill responses name the same value confirmationBlocks.

Response fields

Field	Meaning
walletAddress	Account wallet (normalized)
accountId	accounts.id UUID
keyPrefix	Prefix of the calling key
confirmedUsdc	Spendable balance (six-decimal string)
pendingUsdc	Top-ups still confirming
maxPriceCentsPerDollar	Clearing ceiling (30–80; new accounts default to 49)
topUpConfirmationBlocks	Blocks before pending becomes confirmed

Only confirmedUsdc funds inference. Pending credit does not.

Next

• POST /v1/x402/refill before runway runs out
• PATCH /v1/agent/max-price when routing answers no_eligible_supply
• GET /v1/capacity before the first spend