▸ __BREADCRUMB__ usage
new: genuinely free AI models are live — try surp/free + see live budgets · token-gating prototype · vote on SRP

x402 LLM API

POST /v1/chat/completions # paid per request

surp.ivc.lol is an x402 LLM API — a fully OpenAI-compatible inference endpoint where every request is paid with x402 (USDC on Base, per request). No account, no API key, no subscription. Send a chat completion, get a 402 with the price, sign with your wallet, and the model answers.

the cheapest model, every request

Unlike a static API, surp.ivc.lol watches the live Surplus Intelligence marketplace (150+ models across Anthropic, OpenAI, Google, DeepSeek, Alibaba, xAI, and more) and routes each request to the cheapest model for your task right now. Ask for surp/best-coding and you get whatever coding model is cheapest at that second.

150+
models on the marketplace
15
built-in combos
~1¢
typical request cost
0
accounts required

how to call the x402 LLM API

Any HTTP client works. The first call returns 402 with payment requirements; an x402 client library completes the sign-and-retry automatically:

curl -X POST https://surp.ivc.lol/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"surp/best-chat",
       "messages":[{"role":"user","content":"explain x402 like I'm five"}],
       "max_tokens":100}'

using an x402 client library (docs.x402.org) handles the 402 → sign → retry loop so your code just works.

what it costs

You pay the live market price of the cheapest model in the combo, plus a transparent 5% gateway markup. Current examples (per 1M tokens):

combotypical modelUSD / 1M tokens
surp/best-chatdeepseek-v4-flash~$0.04
surp/best-codingkimi-k2.7-code~$0.42
surp/pro-chatgpt-5.6-terra~$0.18
surp/best-reasoningqwen3-thinking~$0.05

live prices: homepage ticker

why agents love an x402 LLM API

  • Autonomous — an agent pays per request with its own wallet; no human provisioning.
  • No lock-in — pay only for what you use, stop anytime.
  • Auditable — every request is an on-chain USDC transfer on Base.
  • Cheap — dynamic routing means you never overpay for a model you didn't need.

faq

Is the x402 LLM API OpenAI-compatible?

Yes — it uses the standard /v1/chat/completions shape, so it works with Cursor, Aider, OpenCode, Hermes, and any OpenAI-compatible client.

What wallet do I need?

Any wallet holding USDC on Base. The request signs an EIP-3009 authorization; a facilitator submits the transfer (gas sponsored).

How cheap is it compared to OpenAI or Anthropic?

Typically 70–99% cheaper than retail list prices, because we route to the cheapest marketplace seller rather than a fixed provider price.

Can I use it without a crypto wallet?

Yes — we also offer prepaid API keys. Create one on the usage dashboard and use a standard Authorization header.

related: what is x402? · x402 gateway · pay-per-request LLM API · connect your agent · docs