Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cs2cap.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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" \
  "$CS2C_API_BASE/bids?item_id=4994&providers=buff163&providers=csfloat&currency=USD"

​
Parameters

​
item_id
integer
Filter by item ID. Takes precedence over market_hash_name and phase when provided.
​
market_hash_name
string
Exact item name as it appears in inventory. Ignored when item_id is provided.
​
phase
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.
​
providers
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.
​
currency
string
default:"USD"
Target currency. Accepts 160+ ISO 4217 codes. See GET /fx for the full list.
​
limit
integer
Results per page. Range: 1–1000. Defaults to the caller’s effective tier cap.
​
offset
integer
default:"0"
Pagination offset.

​
Response example

{
  "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

​
item_id
integer
Catalog item ID.
​
market_hash_name
string
Full item name as it appears in the Steam economy.
​
phase
string
Doppler phase, or null for non-phased items.
​
provider
string
Provider key for this buy order.
​
highest_bid
integer
Current best bid price in minor units of the response currency. For example, 3923 with currency=EUR = €39.23.
​
highest_bid_decimal
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").
​
num_bids
integer
Total number of active buy orders at this provider for the item.
​
timestamp
string
When the bid or quantity last changed.
​
last_updated
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: pro · quant
Rate limit: 1 request per 5 minutes per API key

​
Query parameters

​
providers
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" \
  "$CS2C_API_BASE/bids?providers=buff163"

​
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

​
item_ids
integer[]
Array of item IDs to fetch. Provide at least one of item_ids or market_hash_names.
​
market_hash_names
string[]
Array of market hash names to fetch. Provide at least one of item_ids or market_hash_names.
​
providers
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.
​
currency
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"}' \
  "$CS2C_API_BASE/bids/batch"

​
Request example

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

​
Response example

{
  "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

​
items
object[]
Array of results, one entry per resolved item.
​
items_not_found
integer[]
Item IDs (including those resolved from market_hash_names) that returned no bids on any queried provider.
​
names_not_found
string[]
market_hash_names that could not be resolved to any catalog item.
Last modified on May 29, 2026