REST
Histórico de Vendas
Vendas concluídas recentes para um único item em um único marketplace, incluindo metadados por venda.
Endpoint
Retorna vendas concluídas recentes para um único item em um único marketplace, incluindo metadados por venda como float, padrão e adesivos, quando disponíveis.
GET /v2/sales
Cobertura
Apenas um subconjunto de marketplaces expõe histórico de vendas. A lista abaixo é obtida ao vivo da API e reflete quais marketplaces atualmente têm vendas disponíveis.
Carregando disponibilidade de marketplaces…
Parâmetros de consulta
marketplace
string
Nome do marketplace. Deve ser um marketplace que exponha vendas — veja a tabela acima.
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 de vendas retornar. Padrão é
30.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 vêm as vendas |
game | string | Jogo ao qual o item pertence |
sales | array | Array de registros de venda |
Registro de venda
| Campo | Tipo | Descrição |
|---|---|---|
timestamp | number | Unix timestamp da venda |
priceUSD | number|null | Preço de venda em USD |
priceEUR | number|null | Preço de venda em EUR |
priceCNY | number|null | Preço de venda em CNY |
priceRUB | number|null | Preço de venda em RUB |
float | number|null | Valor de desgaste entre 0.0 e 1.0 (apenas CS2) |
paintIndex | number|null | ID do padrão da skin (apenas CS2) |
paintSeed | number|null | Número do seed do padrão (apenas CS2) |
stickers | array|null | Adesivos aplicados (apenas CS2) |
rarity | string|null | Raridade do item (apenas Dota 2) |
hero | string|null | Nome do herói associado (apenas Dota 2) |
Exemplo de resposta
response.json
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"sales": [
{
"timestamp": 1711150800,
"priceUSD": 45.50,
"priceEUR": 42.10,
"priceCNY": 322.00,
"priceRUB": 4160.00,
"float": 0.2341,
"paintIndex": 282,
"paintSeed": 123,
"stickers": [],
"rarity": null,
"hero": null
}
]
}