Surplus docs

1. 01

   Buy CREDIT

   Pick an amount on the home page and pay in USDG. Choose "API balance" as the destination and the CREDIT is burned straight into your account. Already hold CREDIT in your wallet? Skip this: activate it from the account page.

   Buy credits →

2. 02

   Create a key

   Sign in with your wallet on the account page and create a key. It starts with sk-surplus- and is shown once.

   Open account →

3. 03

   Send a request

   Point any OpenAI-compatible client at the Surplus base URL. Model names, streaming and tool calls work as before.

   See endpoints →

curl https://api.surplusllm.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SURPLUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello" }],
    "max_tokens": 256
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.surplusllm.com/api/v1",
  apiKey: process.env.SURPLUS_API_KEY, // sk-surplus-…
});

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{ role: "user", content: "Hello" }],
  max_tokens: 256,
});

# Any client that reads the OpenAI env vars
OPENAI_BASE_URL=https://api.surplusllm.com/api/v1
OPENAI_API_KEY=sk-surplus-…

• Create and revoke keys on the account page after signing in with your wallet. A key is shown once; only its hash is stored.
• All keys on an account share one balance.
• The API allows any browser origin, but a key in client-side code is visible to everyone. Call it from a server.

Only the OpenAI-compatible Chat Completions format is served today. An Anthropic-format /messages endpoint is planned, so the Anthropic SDK can't be pointed at Surplus yet.

1. 01

   Fund

   Activating CREDIT burns it on Robinhood Chain and emits an Activated event. The gateway credits your balance from that event, once per transaction log, within about a minute (instantly when you buy on this site).

2. 02

   Hold

   Before forwarding a request the gateway holds its worst-case cost: the prompt estimated from its length plus max_tokens at the completion price. Without max_tokens, output is capped to what your balance can pay for.

3. 03

   Settle

   When the response finishes, the real cost is charged and the rest of the hold returns to your balance. If the provider errors, the whole hold is released.

Every request goes to zero-data-retention endpoints only. The gateway stores billing metadata (model, tokens, cost, timing), never prompts or responses.

Face value

1 CREDIT = $1 of inference

Decimals

6, like USDG

Discount levels

Every 2.5%, deepest filled first

Platform fee

5% on top of the credit price

Referral

1.5% of the price, out of the fee

Gas

ETH on Robinhood Chain

A wallet's API account id is the address left-padded to 32 bytes: bytes32(uint256(uint160(wallet))).

Full walkthrough with Solidity on the $CREDIT page.

1. 01

   Stake

   Stake SURPLUS in Staking. A fixed amount of CREDIT per hour is split across stakers by stake × time. Claim it any time.

2. 02

   List

   sell(amount, discountBps) escrows your CREDIT at one discount level. Orders in a level fill first in, first out.

3. 03

   Get paid

   Fills pay you in USDG. Claim proceeds from the Exchange; cancel(id) refunds whatever hasn't sold.

Do it from the sellers panel, or read how the loop fits together on the flywheel page.

1. 01

   Bring your model

   Your own LLM on Hugging Face. Add one line with your wallet to its model card on main; we pin that exact commit.

2. 02

   Launch on Pons

   You sign the launch from your own wallet, so Robinhood Chain records you as the deployer. The token trades on an ETH bonding curve.

3. 03

   Graduate at 4.2 ETH

   When the curve fills, Pons moves the liquidity into a Uniswap v4 pool that is locked forever.

4. 04

   Go live on Surplus

   We deploy the pinned commit and serve it through the Surplus API, paid in CREDIT like every other model.

Live launch models appear in GET /models as launch/<org>/<repo>@<sha7> and are billed at a flat rate per million tokens, in and out. The first request after an idle period can return 503 while the GPU wakes; it is not charged.

Start on the launchpad.