graded-x402

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_services

  Search the graded catalog of x402 services (the x402 Bazaar + independent indexes), ranked by real 30-day demand and agent-usability grade (A-F). Free.

• get_service

  Full detail for one catalog service: grade breakdown, live price, our price (incl. markup), input schema, output example. Free.

• get_service_history

  Daily probe history for one catalog service (UTC days): uptime %, 402/2xx %, p50/p95 latency, grade per day, price changes, probe counts. Probed every 6 hours. Free.

• call_service

  Call a catalog service through the gateway. The gateway pays the upstream x402 USDC price from its own wallet and deducts your prepaid credits (upstream price + 25% markup, min $0.005). Requires an ac

• create_account

  Create a gateway account. Returns your secret key (gwk_…) - store it; it is shown only once. New accounts start at 0 credits.

• account

  Your balance, totals, limits, and recent calls. Requires Authorization: Bearer <gwk_ key>.

• set_limits

  Configure YOUR account's spending guardrails, enforced on every call_service: max_call_usd (refuse any call charging more), daily_usd (rolling-24h charge budget), min_grade (refuse services graded bel

• create_owner_key

  One-time: mint a separate OWNER key (gwo_…) for the human supervisor. After this, the gwk_ agent key can spend and TIGHTEN limits but never loosen or clear them; only the owner key can. Shown once - t

• top_up_info

  How to add credits (x402 USDC, or a card checkout link via create_topup_link).

• create_topup_link

  Create a hosted card-payment link (Stripe Checkout) that adds $5, $10 or $20 of credits to YOUR account. Give the returned url to your human to open and pay - no crypto wallet needed; credits land 1:1