Itens
Histogramas do Item
Obtenha snapshots paginados de histogramas de ordens de compra/venda para um item específico do mercado Steam.
Endpoint
Este endpoint retorna uma lista paginada de snapshots históricos de histogramas de ordens de compra/venda para um item específico.
GET /v2/steam/items/{itemId}/histograms
Parâmetros obrigatórios
itemId
string
O ID do documento do item (o campo
_id retornado pelo endpoint de listagem de itens ou de detalhes do item).Parâmetros de query
cursor
string
Cursor de paginação. Passe o valor de
cursor de uma resposta anterior para obter a próxima página.Autenticação
Inclua sua API key no header x-api-key.
x-api-key: YourSecretAPIKey
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
results | array | Array de objetos de snapshot de histograma |
cursor | string|null | Cursor para a próxima página, ou null se não houver mais resultados |
hasMore | boolean | Se há mais resultados disponíveis |
Objeto histogram
| Campo | Tipo | Descrição |
|---|---|---|
buyOrders | array | Array de pontos de preço de ordens de compra |
buyOrders[].price | number | Preço da ordem de compra |
buyOrders[].quantity | number | Número de ordens de compra neste preço |
sellOrders | array | Array de pontos de preço de listagens de venda |
sellOrders[].price | number | Preço da listagem de venda |
sellOrders[].quantity | number | Número de listagens de venda neste preço |
date | string | Timestamp ISO de quando o histograma foi registrado |
Exemplo de resposta
response.json
{
"success": true,
"response": {
"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
}
}
Este endpoint retorna até 100 resultados por request. Use paginação baseada em cursor para obter mais snapshots de histograma.