# Superspice Documentation

> Superspice lets anyone charge AI agents for API calls or website access,
> paid per use in USDC over the open x402 protocol (HTTP 402), with the
> money settling directly to the seller's own wallet. These docs cover
> selling, buying as an agent, and the full wire-level reference.

Each page is available as raw markdown at the URLs below, or all at once at https://superspice.xyz/docs/llms-full.txt.

## Start here

- [What is Superspice?](https://superspice.xyz/docs/index.md): Charge AI agents for your API or website — paid per use in USDC, settled straight to your own wallet over the open x402 protocol.
- [Quickstart: sell your API](https://superspice.xyz/docs/getting-started/sell-your-api.md): Put a price on any HTTP API in about 15 minutes — no code changes, no crypto plumbing, agents pay per call in USDC.
- [Quickstart: charge AI crawlers](https://superspice.xyz/docs/getting-started/charge-ai-crawlers.md): Put your website behind the shield — signpost AI agents to a paid catalog or toll them per page, without touching human visitors.

## Selling

- [Pricing your endpoints](https://superspice.xyz/docs/sellers/pricing.md): Per-call, bundles, time passes, volume tiers, and free trials — composed per endpoint and edited live, no redeploys.
- [Payouts, your wallet & the splitter](https://superspice.xyz/docs/sellers/payouts.md): How money reaches you — your own on-chain splitter contract, no custody, no payout schedule, no withdrawal button.
- [Connecting your domain](https://superspice.xyz/docs/sellers/domains.md): Four ways to put your own domain behind the shield — one-click, one-paste, copy-paste DNS, or zero-DNS installs inside your own hosting.
- [The shield: signpost & toll modes](https://superspice.xyz/docs/sellers/shield.md): Charge AI traffic on your own domain — signpost agents to your paid catalog, or toll them per page, while humans stream through untouched.
- [Securing your origin](https://superspice.xyz/docs/sellers/origin-security.md): Your origin URL stays private, buyers can't spoof gateway headers, and an optional shared secret lets your API reject anything that didn't come through Superspice.
- [Dashboard tour](https://superspice.xyz/docs/sellers/dashboard.md): What each page of the Superspice dashboard shows — overview, endpoints, domains, transactions, analytics, and wallet.

## Buying (for agents)

- [Paying for a call](https://superspice.xyz/docs/buyers/pay-per-call.md): The x402 flow from an agent's point of view — request, 402 terms, signed USDC payment, response. No account, no API key, about a second end to end.
- [Prepaid credit & sessions](https://superspice.xyz/docs/buyers/prepaid.md): Pay on-chain once, then draw hundreds of calls off-chain with a session token — with your live balance on every response.
- [Free trials](https://superspice.xyz/docs/buyers/free-trials.md): Sellers can offer a new wallet its first calls free — test an endpoint end to end before wiring any money.
- [Discovering sellers](https://superspice.xyz/docs/buyers/discovery.md): Machine-readable catalogs at every level — the gateway directory, per-seller menus, and shielded domains that announce their own terms.

## Reference

- [The 402 response](https://superspice.xyz/docs/reference/http-402.md): Field-by-field reference for the x402 v2 challenge a Superspice endpoint returns — terms in the payment-required header, extensions included.
- [Headers](https://superspice.xyz/docs/reference/headers.md): Every request and response header in the Superspice payment flow, in one table.
- [Errors](https://superspice.xyz/docs/reference/errors.md): The status codes and error shapes a buyer can see, and what to do about each.
- [Fees & limits](https://superspice.xyz/docs/reference/fees.md): One fee, paid by the buyer on top of your price. Sellers keep 100% of their list price, and using Superspice is free.
- [FAQ](https://superspice.xyz/docs/reference/faq.md): Common questions about Superspice — the token question, failed calls, chargebacks, SEO, and what happens if we disappear.