Market data

See what providers offer before you send a request. The public endpoints need no key and do not name providers. The live feed names providers and needs an API key.

The book is the set of standing offers. An offer is one provider's price for one model, with the deadlines that the provider promises. A market is all the offers for one model.

Public endpoints

Path Description
/v1/models Models and router models with quotes now. With a key, it adds your presets.
/v1/exchange/offers Each resting offer without the provider name, lowest generation rate first.
/v1/exchange/models One row for each served model and kind: price range and depth.
/v1/exchange/markets Depth for each served model: independent suppliers, offer count, liquidity.
/v1/exchange/routers Each router model: ranking, default cap, rules and the models that it admits now.
/v1/exchange/lifetime Jobs settled and tokens processed since the exchange opened.

All are GET.

curl https://router.inference.ai.exchange/v1/exchange/offers

/v1/exchange/markets takes model (names or patterns) and query (a word search).

A job pays the rate of the offer that it won. A provider can change its rates at any time. Offer lists the fields.

Live feed

GET /v1/exchange/stream upgrades to a WebSocket and requires an API key of scope list or higher. Send the key in the first frame, within five seconds after you connect:

{ "type": "subscribe", "credential": "sk-liquid-..." }

The exchange sends a snapshot of the book, then one frame for each change. Frames lists them.

A slow market subscriber misses frames, and the feed does not send them again. The feed disconnects a slow receipts subscriber. Reconnect for a new snapshot.

The exchange pings every 30 seconds. It closes a socket that answers no ping before the next one, or that reads no frame for 10 seconds.

Unverified deployments

The exchange lists a new deployment only after it measures it. Until then, the deployment is unverified. The exchange never chooses it for a model name, router model, basket or preset, and no public view shows it.

Only the workspace that owns the provider can buy from it, with the deployment symbol, such as acme/gpt-oss-120b, as the model. The receipt then has "addressing": { "unverified": true, … }. Any other workspace gets model_not_found.

Reference

Offer

{
  "market": "gpt-oss-120b",
  "model": "gpt-oss-120b",
  "creator": "OpenAI",
  "precision": "fp8",
  "region": "us",
  "input_length_band": { "min": 0, "max": 128000 },
  "output_limit_band": { "min": 0, "max": 4096 },
  "ttft_ms": 1500,
  "completion_ms": 30000,
  "pricing": [
    { "billable": "input_text", "unit": "mtok", "usd": 0.12 },
    { "billable": "output_text", "unit": "mtok", "usd": 0.48 }
  ],
  "synthetic": false,
  "valid_until": "2026-09-21T10:15:02.412Z"
}
Field Description
market, model, creator The model, and the company that made it if the provider stated it.
input_length_band, output_limit_band The token limits that the deployment accepts. The exchange refuses a request outside all bands. A null output maximum means no output limit. Input and output must then fit in input_length_band together.
ttft_ms, completion_ms The provider's deadlines. If it misses one, the receipt shows missed. You still pay.
pricing Every price of the offer, one line for each billable: billable, unit, usd and an optional variant. For mtok, usd is USD per million tokens. Empty on an offer with no price. See Prompt caching for the cache lines.
kind image_generation, audio_speech, video_generation or embedding. Absent on a chat offer.
pricing_unit, image_output_tokens_max On an image offer priced in tokens: pricing_unit is tokens, and the cap holds image_output_tokens_max tokens for each image.
valid_until When the quote expires, unless the provider re-marks or withdraws it first.

Market

{
  "market": "gpt-oss-120b",
  "independent_providers": 3,
  "offer_rows": 5,
  "affiliation_groups": ["grp_acme"],
  "liquid": true
}

Affiliated accounts count as one supplier, and so do resellers of the same upstream. A market is liquid with three or more independent suppliers. If a request sends exchange.rank.allow_single_supplier: false, the exchange refuses an award when only one supplier is eligible.

Frames