REST
Histórico de Preços
Série temporal do histórico de preços para um único item em um único marketplace.
Endpoint
Retorna uma série temporal de preços históricos para um único item em um único marketplace. Útil para gráficos e análise de tendências.
GET /v2/price-history
Parâmetros de consulta
marketplace
string
Nome do marketplace.
game
string
Código do jogo (ex.:
CS2, Dota2, Rust, TF2).name
string
Nome de mercado completo do item.
days
number
Quantos dias de histórico retornar. Padrão é
15.dataPoints
number
Número máximo de pontos de dados a retornar. O servidor reduz a amostragem uniformemente ao longo da janela. Padrão é
100.Autenticação
Veja Visão geral REST para URL base, autenticação e formato de erros.
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome de mercado do item |
marketplace | string | Marketplace de onde vem o histórico |
game | string | Jogo ao qual o item pertence |
history | array | Array de pontos de preço |
Ponto de preço
| Campo | Tipo | Descrição |
|---|---|---|
timestamp | number | Unix timestamp do ponto de dados |
priceUSD | number|null | Preço em USD |
priceEUR | number|null | Preço em EUR |
priceCNY | number|null | Preço em CNY |
priceRUB | number|null | Preço em RUB |
Exemplo de resposta
response.json
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"history": [
{
"timestamp": 1710547200,
"priceUSD": 44.10,
"priceEUR": 40.80,
"priceCNY": 312.00,
"priceRUB": 4025.00
},
{
"timestamp": 1710633600,
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00
}
]
}