sh.graded/graded-x402

name:sh.graded/graded-x402

Discover and call 2,000+ x402 machine-payable services through one graded API key + gateway.

transport:: remote
credential class:: open

Owner verification

Not yet verified. Verifying proves you control this server and is free, permanently — it never changes a published score.

Start verification →

Tools

account
Your balance, totals, limits, and recent calls. Requires Authorization: Bearer <gwk_ key>.
shallow
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 account key with credits.
shallow
create_account
Create a gateway account. Returns your secret key (gwk_…) - store it; it is shown only once. New accounts start at 0 credits.
shallow
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 - the human should store it where the agent can't read it. Requires Authorization: Bearer <gwk_ key>.
shallow
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 within seconds of payment. Requires Authorization: Bearer <gwk_ key>.
shallow
get_service
Full detail for one catalog service: grade breakdown, live price, our price (incl. markup), input schema, output example. Free.
shallow
list_services
Search the graded catalog of x402 services (ours + the Bazaar), ranked by real 30-day demand and agent-usability grade (A-F). Free.
shallow
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 below it), allow (exact service-id allowlist). Send only fields to change; null clears a field. Requires Authorization: Bearer <gwk_ key>.
shallow
top_up_info
How to add credits (x402 USDC, or a card checkout link via create_topup_link).
shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/e73b74d7-b798-43a2-8d0b-9ce478567f8c/badge.svg)](https://vouch.tools/servers/e73b74d7-b798-43a2-8d0b-9ce478567f8c)