POST /v1/archive/csfloat

On this page

POST /v1/archive/csfloat
Access
Request
Parameters
Response
Response fields
Daily data
Errors

Returns CSFloat daily average sale price and sale volume. Data begins in 2022 and updates ~1-2x per day.

Max 100 items per request.

Access#

Requires a Scale or Enterprise API key.

Request#

POSTapi.cs2.sh/v1/archive/csfloat

curl -X POST https://api.cs2.sh/v1/archive/csfloat \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "USP-S | Printstream (Factory New)"
  ],
  "start": "2024-01-01",
  "end": "2026-08-23",
  "currency": "USD"
}'

Parameters#

Field	Type	Required	Description
`items`	`string[]`	Yes	List of `market_hash_name` values (max 100).
`start`	`string`	No	Start date/time as YYYY-MM-DD or RFC3339, inclusive. Defaults to 2020-01-01.
`end`	`string`	No	End date/time as YYYY-MM-DD or RFC3339, exclusive. Defaults to now.
`currency`	`string`	No	Default: `USD`. Allowed: `AUD`, `CAD`, `CHF`, `CNY`, `EUR`, `GBP`, `JPY`, `NZD`, `SGD`, `USD`. Currency for every price in the response.

Response#

{
  "response_time": "2026-08-23T22:00:08.282900466Z",
  "currency": "USD",
  "start": "2026-05-25T00:00:00Z",
  "end": "2026-08-22T00:00:00Z",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "count": 89,
      "data": [
        {
          "date": "2026-05-25",
          "price": 132.03,
          "volume": 12
        },
        {
          "date": "2026-05-26",
          "price": 119.67,
          "volume": 10
        }
      ]
    }
  }
}

Response fields#

ArchiveCSFloatResponse fields:

Field	Type	Required	Description
`response_time`	`string (date-time)`	Yes	When the response was generated.
`currency`	`string`	Yes	Currency code for every price in the response. Matches the requested `currency`; defaults to `USD`.
`start`	`string (date-time)`	Yes	Effective start of the queried range, floored to the day boundary. Inclusive.
`end`	`string (date-time)`	Yes	Effective end of the queried range, ceiled to the day boundary. Exclusive.
`items`	`Record<string, ArchiveCSFloatItem>`	Yes	Map of `market_hash_name` to CSFloat sale time-series.
`errors`	ItemError[]	No	Per-item failures alongside successful results (partial success).

Daily data#

Field	Description
`items.<name>.count`	Number of daily aggregates.
`items.<name>.data[]`	Daily aggregates.
`data[].date`	Day, `YYYY-MM-DD`, UTC.
`data[].price`	Arithmetic average of all sale prices that day, USD.
`data[].volume`	Number of sales that day.
`items.<name>.variants`	The same shape per variant.

date, price, and volume are present on returned daily aggregates. price can be null when the stored day has volume but no usable price.
Variants appear under variants when CSFloat archive data exists for that variant.
Valid requested items with no CSFloat archive data return not_in_archive.

Full schemas: ArchiveCSFloatItem, ArchiveCSFloatBucket.

Errors#

404 not_found means none of the requested valid items have CSFloat archive data. Partial results return 200 with errors[]; possible item codes are unknown_item, invalid_format, and not_in_archive. See Partial success and Request errors.