`PATCH /v1/agent/max-price`

Bearer self-service. Sets the highest cents-per-dollar you will clear against.

New accounts default to 49. Signup may set an initial ceiling via maxPriceCentsPerDollar on POST /v1/x402/signup. Posted prices move, so confirmed credit that will not spend is usually a stale ceiling, not an empty balance.

Request

bash

curl -X PATCH "https://api.pzero.studio/v1/agent/max-price" \
  -H "Authorization: Bearer pzero_..." \
  -H "Content-Type: application/json" \
  -d '{"maxPriceCentsPerDollar":60}'

400 if the body is invalid, maxPriceCentsPerDollar is missing, or the value is outside 30–80. Nothing is clamped. Bearer only: a session cookie on the request is rejected with 401 even if Authorization is present.

Response

200:

json

{
  "walletAddress": "0x…",
  "maxPriceCentsPerDollar": 60
}

When to raise it

Routing with nothing you can reach answers 503 no_eligible_supply. The body carries buyerMaxCents, cheapestPostedCents, and routableDiemAboveMax. Send at least cheapestPostedCents here (still capped at 80) and the same inference request clears.

See Errors & limits and GET /v1/capacity.

PATCH /v1/agent/max-price ​

Request ​

Response ​

When to raise it ​

Next ​

`PATCH /v1/agent/max-price`

Request

Response

When to raise it

Next