▸ surp.ivc.lol usage

Spend less on every AI call.

Surp uses live SurplusIntelligence.ai market prices, picks a model for the route you choose, and reuses identical answers for $0.001. Connect once and pay in USDC on Base.

145+ models one OpenAI-compatible endpoint
$0.001 The system remembers answers to identical questions. You pay a fraction of a penny to reuse an old answer. You do not pay full price to make it again. exact-response cache hit
No subscription pay only for requests you make

Give Surp a route.

No wallet. No account. No API key. Start on Free. See which live model Surp would pick, then copy a prompt into your agent.

Choose a route

Set how much intelligence, speed, and discount matter. Cost here is Surplus % off the AA list price.

Surp routes this to
surp/free
Live model pick
loading…

Free route. Treasury pays Surplus. You pay $0 within the daily cap.

Copy this into your agent

Create a Surp key, then paste the prompt. This is not a SurplusIntelligence.ai key. The base URL is different.

Use Surp as my OpenAI-compatible provider.

Base URL: https://surp.ivc.lol/v1
API key: YOUR_SURP_KEY
Model: surp/free

Do not use https://api.surplusintelligence.ai/min30/v1/chat/completions
Do not expect a SurplusIntelligence balance here. This key only works on this base URL.
Open account →

From zero to first paid call.

Pick the path that matches how your agent already works. Funding details stay closed until you need them.

1 · Choose

Pick a route: surp/free, surp/value, surp/frontier, surp/fast, surp/vision, or surp/custom.

2 · Fund

Add USDC on Base to a wallet, or use a Surp API key. Pay in USDC on Base — this page does not sell crypto.

3 · Call

Send an OpenAI-compatible request to https://surp.ivc.lol/v1.

This is not your SurplusIntelligence login. Same marketplace. Different address. Different key. Your Surplus balance does not show here.
Surplus example: https://api.surplusintelligence.ai/min30/v1/chat/completions
This router: https://surp.ivc.lol/v1
Connect Hermes
Install the plugin with hermes plugins install ivcained/surp-hermes-x402-llm, enable it, then use the free discovery and quote tools. Set the base URL to https://surp.ivc.lol/v1. Open the Hermes connection guide →
Pay from a wallet
Use USDC on Base. Surp returns an x402 payment challenge with the exact amount before the request is retried. Your wallet signs an EIP-3009 authorization; Surp never needs your private key. See the wallet flow →
Use an API key
Create a Surp key on this site. It is tied to this router, not to SurplusIntelligence.ai. Put the key in your agent secret store and call https://surp.ivc.lol/v1/chat/completions. Open account and funding →
Technical details belong in the docs.

Read about x402 settlement, cache fingerprints, route pools, benchmarks, model catalogs, and the gateway design when you need them. Intelligence scores: Artificial Analysis.

Read the documentation →