cs2.sh vs Official CSFloat API for CS2 Market Data
Updated
Use CSFloat's official API when you need individual active listings, asset-level float, paint, sticker, seller, or auction fields, or the ability to list an item. Use cs2.sh when you need the lowest sell listing, highest buy order, intraday history, daily completed-sale price and volume from 2022, variant history, or liquidity across the full item schema.
CSFloat's API is a listing interface
The official CSFloat documentation publishes a collection endpoint for active listings, a lookup for one listing, and an authenticated operation to list an item. The collection endpoint supports filters for market_hash_name, float, paint index, paint seed, price, rarity, collection, stickers, seller, and listing type. Results are cursor-paginated with at most 50 listings per response.
That raw listing detail is more useful than an item-level minimum when the product is a listing browser, sniper, or seller tool. It is not the same product as a historical market database. The public documentation does not publish price history, completed-sale history, liquidity, or a public buy-order endpoint.
Current differences
| Requirement | CSFloat API | cs2.sh |
|---|---|---|
| Individual listings | Rich asset, seller, price, and auction records | Item-level current data on public plans; live full-depth CSFloat listings are an Enterprise option |
| Current item price | Compute it by paging and filtering listings | Ready-to-use ask for the lowest sell listing and bid for the highest buy order |
| Buy-order prices | No endpoint in the published docs | Current CSFloat bid on most items, including many Doppler variants |
| Intraday history | No published endpoint | Ask and bid OHLC at 5m, 30m, 1h, and 1d |
| Completed sales | No published endpoint | Daily average completed-sale price and completed-sale volume from 2022 onward |
| Variants | Filter listing assets by paint fields | Doppler, Gamma Doppler, and Case Hardened in a stable variants object, including historical queries |
| Liquidity | No published endpoint | Daily liquidity bucket and estimated sale time for every item and variant |
| Throughput terms | Maximum 50 listings per page; the docs show 429 errors but do not publish a numeric request allowance | Unlimited monthly requests at 10 requests per second |
For cs2.sh, ask means the lowest sell listing and bid means the highest buy order. Those item-level values are intentionally different from a raw list of uniquely painted and stickered assets.
Use CSFloat for exact listings and selling
CSFloat's official API is the right source when an application needs to show or act on a particular CSFloat listing. It provides the asset's float, paint seed, stickers, auction state, seller, and listing ID, and it supports creating a listing. Those listing-level records are intentionally outside the public cs2.sh item-level response; cs2.sh offers a live CSFloat listing feed only on Enterprise.
Add cs2.sh for completed sales and market history
cs2.sh provides the market-level record around those assets: current bid and ask data, OHLC at four intervals, daily completed-sale price and volume from 2022, per-variant current and historical prices, and liquidity estimates. A listing browser can use CSFloat for the exact asset a buyer sees and cs2.sh for the price, sale, variant, and liquidity history needed to evaluate it.
The roles are complementary rather than interchangeable: CSFloat is the listing and marketplace-action API; cs2.sh is the retained market-data API.
What cs2.sh returns for CSFloat
The CSFloat source arrives alongside five other marketplaces in one response, keyed by the same market_hash_name:
"csfloat": {
"updated_at": "2026-07-26T18:53:05.094Z",
"collected_at": "2026-07-26T18:53:05.134Z",
"ask": 107.99,
"ask_volume": 227,
"bid": 105
}CSFloat publishes no buy-order count, so bid_volume is absent here exactly as it is at source. For completed sales, POST /v1/archive/csfloat returns a daily row per item from 2022:
"data": [
{ "date": "2026-04-27", "price": 149.76, "volume": 8 }
]price is the arithmetic average of every CSFloat sale that day and volume is the sale count. Doppler, Gamma Doppler, and Case Hardened variants carry their own series under variants, each with an independent daily average, so a Ruby is priced separately from its base item rather than blended into it.
| Property | Value |
|---|---|
| Sale coverage | Daily from 2022 |
| Listing history | Ask and bid OHLC from December 24, 2025 |
| Items per request | 100 |
| Refresh | Prices ~5 min; CSFloat variants ~10-15 min; sale archive ~1-2x per day |
| Access | Current prices on all plans; history and archive need Scale or Enterprise |
Disclosure: this comparison is published by cs2.sh. CSFloat endpoints, filters, pagination, and published limits were checked against its official documentation on August 5, 2026.