GET/v1/nbboDEVELOPER+

National Best Bid & Offer

National Best Bid & Offer across all indexed marketplaces for a single CS2 item, with freshness metadata, a basis-points spread, and a confidence score. Query by id (canonical id) or market_hash_name, optionally narrowed to a markets CSV. Prices are integer USD cents.

NBBO answers one question: across every market at once, what's the best price to buy at and the best to sell at? bestAsk is the lowest ask anywhere (and names its source market); bestBid is the highest bid anywhere; the gap between them is spreadBps, in basis points.

Not every item has a two-sided market. When no venue exposes a buy order, bestBid and spreadBps come back null, which is normal, not an error (see Nulls & partial data). confidence (0 to 1) blends how many markets contributed, how fresh they are, and how much they agree, so you can down-weight a thin or stale read.

locked (bid == ask) and crossed (the bid, net of the selling venue's estimated commission, above the ask) flag the rare moments a quote inverts across markets, usually because one leg went stale a beat before the other refreshed. Filter on them if you're acting on the spread.

By default bestBid only considers cash-executable venues (Steam wallet-credit and trade-credit markets are excluded), so the default cross-market bid is one you could actually realize in cash. Pass a markets CSV to include every requested venue's bid instead. /v1/pricing applies the same default, so the two agree unless you pass markets.

spreadBps is clamped to null above 10000 bps (±100%) to drop garbage bids. Negative (crossed) spreads are kept here, alongside the crossed flag; pricing reads return null on a crossed book instead. For a realistic execution spread rather than a sticker-price spread, read the nullable executionAdjusted block: it re-prices both sides after fees and an executability discount and carries its own spreadBps and executableConfidence.

Want the full per-market breakdown instead of just the best two sides? Use /v1/pricing/:marketHashName. Want order-book depth beyond the top of book? Use /v1/nbbo/depth.

Game-scoped variant: GET /v2/nbbo serves both games with a required game=cs2|rust parameter - same shape, auth, and quotas. See Games: CS2 & Rust.

Parameters

market_hash_namestringoptional

Query. Exact market hash name. Provide either this OR id (400 if neither).

idstringoptional

Query. Canonical item id. Provide either this OR market_hash_name (400 if neither).

marketsstringoptional

Query. CSV of market ids to restrict the response, e.g. csfloat,buff163. Passing this also overrides the default cash-executable bestBid filter: every requested venue's bid is then considered verbatim.

Response fields

NbboResponseBest bid + best ask across all indexed markets for one item.

marketHashNamestring

The item's Steam market hash name.

canonicalItemIdstring

SkinPricer's canonical item id.

bestAskQuotenullable

Lowest ask across markets. Null when no fresh ask exists.

bestBidQuotenullable

Highest bid across markets. In the default (all-markets) view this is restricted to cash-executable venues; see the bestBid note below. Null when no eligible market exposes a bid.

spreadBpsintegernullable

bestAsk − bestBid in basis points. Null when a side is missing, and also clamped to null when it would exceed 10000 bps (a ±100% spread, almost always a stale/garbage bid). Negative (crossed) spreads are preserved.

marketCountinteger

Markets contributing a quote.

freshMarketCountinteger

Of those, how many are still fresh.

lockedboolean

True when bestBid == bestAsk (zero spread).

crossedboolean

True when bestBid, net of the selling venue's estimated commission, is above bestAsk (a fleeting inversion). A bid that is only higher before fees does not set it.

confidencenumber

0 to 1 confidence from coverage, freshness, and agreement.

executionAdjustedExecutionAdjustedNbbonullable

Fee- and executability-adjusted 'real best market' (SP-261). Null when it can't be computed. See the dedicated object.

calculatedAtstring (date-time)

When this NBBO was computed.

Nested and shared shapes link to the API Objects reference.

Errors

400Neither market_hash_name nor id supplied.

404Item not found.

401Missing Authorization header, unsupported scheme, or a key that is unknown, inactive, expired, or revoked.

403Valid key, but the subscription is inactive/expired or the plan does not include this endpoint.

429Rate limit exceeded; see Retry-After + X-RateLimit-* headers. Pooled per account across all keys.

5xxUpstream snapshot unavailable or a server-side issue. Retry with backoff.

Guides using this endpoint

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/nbbo" \
  --data-urlencode "market_hash_name=AK-47 | Redline (Field-Tested)" \
  -H "Authorization: ApiKey $SKINPRICER_API_KEY"

// npm i @skinpricer/sdk
import { SkinpricerClient, formatUsd } from "@skinpricer/sdk";

const client = new SkinpricerClient({
  apiKey: process.env.SKINPRICER_API_KEY!,
  authScheme: "ApiKey",
});

const quote = await client.nbbo.get({ marketHashName: "AK-47 | Redline (Field-Tested)" });
if (quote.bestAsk && quote.bestBid) {
  console.log(formatUsd(quote.bestBid.price), "bid /", formatUsd(quote.bestAsk.price), "ask");
}

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/nbbo",
    params={"market_hash_name": "AK-47 | Redline (Field-Tested)"},
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response 200

{
  "marketHashName": "Glock-18 | Water Elemental (Factory New)",
  "canonicalItemId": "cmlofca920lka01yozajhixt3",
  "bestAsk": {
    "market": "csfloat",
    "price": 4373,
    "updatedAt": "2026-09-25T11:20:00.981Z",
    "isStale": false
  },
  "bestBid": {
    "market": "marketcsgo",
    "price": 4486,
    "updatedAt": "2026-09-25T11:20:03.070Z",
    "isStale": false
  },
  "spreadBps": -252,
  "marketCount": 16,
  "freshMarketCount": 15,
  "locked": false,
  "crossed": false,
  "confidence": 0.88,
  "executionAdjusted": {
    "bestAsk": {
      "market": "csfloat",
      "price": 4373,
      "rawPrice": 4373,
      "appliedFeeBps": 0,
      "executability": 0.51,
      "updatedAt": "2026-09-25T11:20:00.981Z",
      "isStale": false,
      "reasons": [
        "unknown_executable_depth"
      ]
    },
    "bestBid": {
      "market": "buff163",
      "price": 4256,
      "rawPrice": 4365,
      "appliedFeeBps": 250,
      "withdrawalFlatUsdCents": 0,
      "executability": 0.51,
      "updatedAt": "2026-09-25T11:20:11.402Z",
      "isStale": false,
      "reasons": [
        "unknown_executable_depth"
      ]
    },
    "spreadBps": 275,
    "locked": false,
    "crossed": false,
    "executableConfidence": 0.7,
    "reasons": [
      "unknown_executable_depth"
    ],
    "feeModelVersion": "exec-fees-v1-estimated",
    "calculatedAt": "2026-09-25T11:28:40.236Z"
  },
  "calculatedAt": "2026-09-25T11:28:40.236Z"
}

Response headers

X-RateLimit-Limit: <per-minute, set by your plan>

X-RateLimit-Remaining: <remaining this minute>

X-RateLimit-Reset: <seconds to reset>

X-RateLimit-Remaining-Month: <left this month, capped plans>

X-Request-ID: req_xxxxxxxxxxxxxxxx