Quickstart: sell your API

You have an HTTP API. At the end of this page, AI agents can pay to call it — per call or prepaid — with the money settling toward your own wallet. Your API doesn’t change at all.

1. Create your account

Sign up at superspice.xyz/sign-up with Google or email. The dashboard’s setup checklist will walk you through the same steps as this page.

2. Set your payout wallet

Paste the Base address your earnings should land at — any EVM address you control (a hardware wallet, an exchange deposit address for USDC on Base, a multisig). That’s the whole crypto requirement: you never need gas, tokens, or contract knowledge. How payouts work →

3. Create an endpoint

In Endpoints, add your first one:

• Origin URL — your API’s real base URL (HTTPS). It stays private; agents never see it. Superspice proxies to it and can prove itself to your origin — see Securing your origin.
• Path — the route you’re selling, e.g. /api/search.
• Price — in USDC, up to 6 decimals: 0.01, 0.001, 0.25… Sub-cent prices are fine (agents prepay a small bundle automatically — see Fees & limits).

You get a permanent gateway URL:

https://gw.superspice.xyz/g/<your-name>/<path>

That URL is what agents call. Everything about it can be re-priced live in the dashboard later — richer pricing (bundles, passes, tiers, free trials) is one click away in the same editor. Pricing your endpoints →

4. See it live

Your endpoint is already selling. Prove it:

curl -i https://gw.superspice.xyz/g/<your-name>/<path>

You’ll get an HTTP 402 Payment Required carrying your exact terms in the payment-required header — the machine-readable price an agent’s wallet pays against. (Decode it and look around: The 402 response.)

From here the flow is automatic: an agent pays, Superspice verifies the payment, proxies the call to your origin, and settles the money only after your response is delivered — your full list price toward your wallet, the agent-paid fee to us.

5. Get discovered

You’re listed automatically: the gateway publishes a machine-readable directory (https://gw.superspice.xyz/llms.txt and /.well-known/ai-catalog.json), and your own seller catalog lives at /g/<your-name>/.well-known/ai-catalog.json. Share your gateway URL anywhere agents (or their developers) will see it — your API docs, your README, your pricing page. Discovering sellers →

What happened under the hood?

Payment is verified before your servers answer, and settles only after your response delivers — you can’t be freeloaded, and an agent never pays for a failed call. Watch the money arrive in the dashboard: every call, buyer, and settlement, with CSV export.