Items
Item Histograms
Get paginated buy/sell order histogram snapshots for a specific Steam market item.
Endpoint
This endpoint returns a paginated list of historical buy/sell order histogram snapshots for a specific item.
GET /v2/steam/items/{itemId}/histograms
Required parameters
itemId
string
The item document ID (the
_id field from the list items or item details endpoint).Query parameters
cursor
string
Pagination cursor. Pass the
cursor value from a previous response to fetch the next page.Authentication
Include your API key as the x-api-key request header.
x-api-key: YourSecretAPIKey
Response fields
| Field | Type | Description |
|---|---|---|
results | array | Array of histogram snapshot objects |
cursor | string|null | Cursor for the next page, or null if no more results |
hasMore | boolean | Whether there are more results to fetch |
Histogram object
| Field | Type | Description |
|---|---|---|
buyOrders | array | Array of buy order price points |
buyOrders[].price | number | Buy order price |
buyOrders[].quantity | number | Number of buy orders at this price |
sellOrders | array | Array of sell listing price points |
sellOrders[].price | number | Sell listing price |
sellOrders[].quantity | number | Number of sell listings at this price |
date | string | ISO timestamp of when the histogram was recorded |
Response example
response.json
{
"success": true,
"results": [
{
"buyOrders": [
{ "price": 1050, "quantity": 245 },
{ "price": 1049, "quantity": 12 }
],
"sellOrders": [
{ "price": 1089, "quantity": 3 },
{ "price": 1090, "quantity": 7 }
],
"date": "2025-01-15T12:00:00.000Z"
}
],
"cursor": "6789abcdef012345",
"hasMore": true
}
This endpoint returns up to 100 results per request. Use cursor-based pagination to retrieve more histogram snapshots.