Bids API: Buy Orders Across CS2 Marketplaces

The Bids API exposes the highest active buy orders placed across CS2 marketplaces. Use it to see where demand is strongest for an item, identify arbitrage opportunities between ask and bid prices, or track buy-order depth over time. You can query individual items, batch up to 100 at once, or stream the entire live bids catalog as NDJSON, or page through historical buy-order records.

GET /bids — List bids

Returns the current highest buy order across buy-order-enabled providers. You can filter by item, phase, provider, and currency. Valid filters with no current matches return 200 with an empty items array; 503 indicates the data source is temporarily unavailable. Tiers: Starter, Pro, Quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/bids?item_id=4994&providers=buff163&providers=csfloat&currency=USD"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.BidsApi(client)
    response = api.list_bids(
        item_id=4994,
        providers=["buff163", "csfloat"],
        currency="USD",
    )

print(client.sanitize_for_serialization(response))

import { Configuration, BidsApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new BidsApi(new Configuration({ accessToken }));
const response = await api.listBids({
  itemId: 4994,
  providers: ["buff163", "csfloat"],
  currency: "USD",
});

console.log(response);

Parameters

integer

Filter by item ID. Takes precedence over market_hash_name and phase when provided.

string

Exact item name as it appears in inventory. Ignored when item_id is provided.

string

Doppler or Gamma Doppler phase filter. Can be used without market_hash_name. One of: Phase 1, Phase 2, Phase 3, Phase 4, Ruby, Sapphire, Black Pearl, Emerald.

string[]

Buy-order provider keys to include. Repeat to pass more than one: providers=steam&providers=buff163. Valid keys: buff163, buffmarket, c5, csfloat, dmarket, dupefi, ecosteam, marketcsgo, steam, waxpeer, whitemarket, youpin.

string

default:"USD"

Target currency. Accepts 200+ ISO 4217 codes. See GET /fx for the full list.

integer

Results per page. Range: 1–1000. Defaults to the caller’s effective tier cap.

integer

default:"0"

Pagination offset.

Response example

Abbreviated response (ellipsis placeholders are not JSON):

{
  "meta": {...},
  "items": [
    {
      "item_id": 12632,
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "provider": "buff163",
      "highest_bid": 3001,
      "num_bids": 232,
      "timestamp": "2026-03-21T05:22:39.570895Z",
      "last_updated": "2026-03-21T05:22:43.400024Z"
    },
    {
      "item_id": 12632,
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "provider": "steam",
      "highest_bid": 3923,
      "num_bids": 57053,
      "timestamp": "2026-03-21T05:00:30.858070Z",
      "last_updated": "2026-03-21T05:00:34.493615Z"
    },
    {
      "item_id": 12632,
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "provider": "dmarket",
      "highest_bid": 3081,
      "num_bids": 310,
      "timestamp": "2026-03-21T05:22:07.475923Z",
      "last_updated": "2026-03-21T05:22:10.170889Z"
    }
  ],
  "pagination": {...}
}

Response fields

integer

Catalog item ID.

string

Full item name as it appears in the Steam economy.

string

Doppler phase, or null for non-phased items.

string

Provider key for this buy order.

integer

Current best bid price in minor units of the response currency. For example, 3923 with currency=EUR = €39.23.

string

highest_bid as a decimal string with adaptive precision: two decimal places at or above 1.0, eight below it. Use this for low-value currencies such as crypto, where the integer highest_bid rounds to 0 (for example a $25.50 bid in BTC returns highest_bid = 0, highest_bid_decimal = "0.00041600").

integer

Total number of active buy orders at this provider for the item.

string

When the bid or quantity last changed.

string

When this record was last refreshed, even if the bid stayed the same.

If the item exists in the catalog but none of the selected providers currently has a buy order, the endpoint returns 200 with items: [].

POST /bids — Stream full bids snapshot

Streams the complete live buy-orders catalog as NDJSON, with one JSON object per line. The snapshot is captured once at request start and then streamed in full. Tiers: Starter, Pro, Quant Rate limit: rolling 24h quota of successful stream starts per API key — 50/day on pro, 300/day on quant, counted separately from POST /prices. One active stream per API key at a time (409 otherwise, with Retry-After).

⚡ Why NDJSON? A full market snapshot contains hundreds of thousands of bids. If this payload were delivered as a standard JSON array ([...]), your backend would be forced to decompress and buffer a massive ~200MB string into memory before JSON.parse() could even begin. This causes delayed processing, blocked event loops, and massive RAM spikes.By streaming this endpoint as NDJSON, CS2Cap achieves a sub-1s TTFB (~500ms). Your backend can decompress and parse the stream line-by-line as packets arrive, which keeps memory usage minimal and allows for instant inserts in your database.

Query parameters

string[]

Optional. Repeat to restrict the stream to specific buy-order providers. Uses the same provider keys as GET /bids. If omitted, all buy-order providers are included.

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/bids?providers=buff163"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.BidsApi(client)
    response = api.stream_full_bids_snapshot(
        providers=["buff163"]
    )

print(client.sanitize_for_serialization(response))

import { Configuration, BidsApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new BidsApi(new Configuration({ accessToken }));
const response = await api.streamFullBidsSnapshot({ providers: ["buff163"] });

console.log(response);

Response example

{"provider":"buff163","item_id":12632,"market_hash_name":"AK-47 | Redline (Field-Tested)","phase":null,"highest_bid":3001,"num_bids":232,"timestamp":"2026-03-21T05:22:39.570895Z","last_updated":"2026-03-21T05:22:43.400024Z"}
{"provider":"csfloat","item_id":12632,"market_hash_name":"AK-47 | Redline (Field-Tested)","phase":null,"highest_bid":2946,"num_bids":2,"timestamp":"2026-03-21T04:59:16.565601Z","last_updated":"2026-03-21T05:03:40.837477Z"}
{"provider":"steam","item_id":2,"market_hash_name":"'Blueberries' Buckshot | NSWC SEAL","phase":null,"highest_bid":289,"num_bids":4820,"timestamp":"2026-03-22T01:41:00.000000Z","last_updated":"2026-03-22T01:41:36.221322Z"}

POST /bids/batch — Batch bids lookup

Returns current highest buy orders for up to 100 items in a single request, grouped by item ID across the selected buy-order providers. Tiers: Starter, Pro, Quant

Request body

integer[]

Array of item IDs to fetch. Provide at least one of item_ids or market_hash_names.

string[]

Array of market hash names to fetch. Provide at least one of item_ids or market_hash_names.

string[]

Buy-order provider keys to include. If omitted, all supported buy-order providers are queried. Valid keys: buff163, buffmarket, c5, csfloat, dmarket, dupefi, ecosteam, marketcsgo, steam, waxpeer, whitemarket, youpin.

string

default:"USD"

Target currency. Use GET /fx for supported ISO 4217 codes.

Phased items (Dopplers / Gammas): market_hash_name resolves to the phaseless catalog entry and returns results for the cheapest variant regardless of phase. To target a specific phase (Phase 1, Phase 2, Phase 3, Phase 4, Sapphire, Ruby, Emerald, or Black Pearl), pass the corresponding item_id instead.

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_ids":[4994,12632],"providers":["buff163","csfloat"],"currency":"USD"}' \
  "https://api.cs2c.app/v1/bids/batch"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.BidsApi(client)
    response = api.batch_bid_lookup(
        cs2cap.BatchBidsRequest(
            item_ids=[4994, 12632],
            providers=["buff163", "csfloat"],
            currency="USD",
        )
    )

print(client.sanitize_for_serialization(response))

import { Configuration, BidsApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new BidsApi(new Configuration({ accessToken }));
const response = await api.batchBidLookup({
  batchBidsRequest: {
    itemIds: [4994, 12632],
    providers: ["buff163", "csfloat"],
    currency: "USD",
  },
});

console.log(response);

Request example

{
  "item_ids": [12632, 2],
  "market_hash_names": ["AK-47 | Redline (Field-Tested)"],
  "providers": ["buff163", "steam"],
  "currency": "USD"
}

Response example

Abbreviated response (ellipsis placeholders are not JSON):

{
  "meta": {...},
  "items": [
    {
      "item_id": 12632,
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "quotes": [
        {
          "provider": "buff163",
          "highest_bid": 3001,
          "num_bids": 232,
          "timestamp": "2026-03-21T05:22:39Z",
          "last_updated": "2026-03-21T05:22:43Z"
        },
        {
          "provider": "steam",
          "highest_bid": 3923,
          "num_bids": 57053,
          "timestamp": "2026-03-21T05:00:30Z",
          "last_updated": "2026-03-21T05:00:34Z"
        }
      ]
    },
    {
      "item_id": 2,
      "market_hash_name": "'Blueberries' Buckshot | NSWC SEAL",
      "phase": null,
      "quotes": [
        {
          "provider": "buff163",
          "highest_bid": 224,
          "num_bids": 1,
          "timestamp": "2026-03-21T05:27:20Z",
          "last_updated": "2026-03-21T05:27:22Z"
        }
      ]
    }
  ],
  "items_not_found": [],
  "names_not_found": []
}

Response fields

object[]

Array of results, one entry per resolved item.

Show item properties

integer

Catalog item ID.

string

Full item name.

string

Doppler phase or null.

object[]

Per-provider bid quotes for this item.

Show quote properties

string

Provider key.

integer

Highest buy order in minor units of the response currency.

string

highest_bid as an adaptive-precision decimal string (eight places below 1.0). Use for sub-cent currencies such as crypto.

integer

Total number of active buy orders at this provider.

string

When the bid was observed.

string

When the record was last refreshed.

integer[]

Item IDs (including those resolved from market_hash_names) that returned no bids on any queried provider.

string[]

market_hash_names that could not be resolved to any catalog item.

GET /bids/history — Bid history

Returns historical buy-order records for one item, optionally filtered to a single provider. Results are ordered newest-first and use cursor pagination. Requests reaching back more than 35 days return hourly buckets; more than 365 days, daily buckets. History is available from September 2026 onward. Tiers: Pro, Quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/bids/history?item_id=4994&provider=csfloat&currency=USD&limit=50"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.BidsApi(client)
    response = api.get_bid_history(
        item_id=4994,
        provider="csfloat",
        currency="USD",
        limit=50,
    )

print(client.sanitize_for_serialization(response))

import { BidsApi, Configuration } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new BidsApi(new Configuration({ accessToken }));
const response = await api.getBidHistory({
  itemId: 4994,
  provider: "csfloat",
  currency: "USD",
  limit: 50,
});

console.log(response);

Parameters

integer

Filter by item ID. Takes precedence over market_hash_name and phase when provided.

string

Exact item name as it appears in inventory.

string

Doppler or Gamma phase filter. One of: Phase 1, Phase 2, Phase 3, Phase 4, Ruby, Sapphire, Black Pearl, Emerald.

string

A single buy-order provider key, for example provider=csfloat. Returns records from that provider only. Only providers with buy-order support are accepted. Valid keys: buff163, buffmarket, c5, csfloat, dmarket, dupefi, ecosteam, marketcsgo, steam, waxpeer, whitemarket, youpin. Any other value returns 422.

string

Inclusive ISO 8601 timestamp. Accepts YYYY-MM-DD or YYYY-MM-DDThh:mm:ss. Defaults to the last 35 days when omitted.

string

Inclusive ISO 8601 timestamp.

string

default:"USD"

Target currency. Accepts 200+ ISO 4217 codes.

integer

Results per page. Range: 1–1000.

string

Cursor for keyset pagination. Pass the next_cursor value from the previous response.

Response example

Abbreviated response (ellipsis placeholders are not JSON):

{
  "meta": {...},
  "items": [
    {
      "item_id": 4994,
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "provider": "CSFloat",
      "time": "2026-09-10T11:55:00Z",
      "highest_bid": 2450,
      "currency": "USD",
      "num_bids": 5
    }
  ],
  "pagination": {...}
}

Response fields

integer

Catalog item ID.

string

Full item name.

string

Doppler phase or null.

string

Provider name for this record.

string

ISO 8601 timestamp of the buy-order observation. For bucketed rows, the start of the bucket.

integer

Highest bid in minor units of the response currency.

string

ISO 4217 currency code for the returned bid.

integer

Number of active buy orders observed at this timestamp.

pagination.total is always -1 on this endpoint. Use has_next and next_cursor to paginate.

Overview

Market Data

Analytics

Portfolio

Bids API: Buy Orders Across CS2 Marketplaces

GET /bids — List bids

Parameters

Response example

Response fields

POST /bids — Stream full bids snapshot

Query parameters

Response example

POST /bids/batch — Batch bids lookup

Request body

Request example

Response example

Response fields

GET /bids/history — Bid history

Parameters

Response example

Response fields

​GET /bids — List bids

​Parameters

​Response example

​Response fields

​POST /bids — Stream full bids snapshot

​Query parameters

​Response example

​POST /bids/batch — Batch bids lookup

​Request body

​Request example

​Response example

​Response fields

​GET /bids/history — Bid history

​Parameters

​Response example

​Response fields

GET /bids — List bids

Parameters

Response example

Response fields

POST /bids — Stream full bids snapshot

Query parameters

Response example

POST /bids/batch — Batch bids lookup

Request body

Request example

Response example

Response fields

GET /bids/history — Bid history

Parameters

Response example

Response fields