REST
Obter Item
Buscar um único item de um marketplace específico, incluindo suas ofertas atuais e ordens de compra abertas.
Endpoint
Retorna os dados completos de um único item em um único marketplace, incluindo todas as ofertas atualmente listadas e todas as ordens de compra abertas.
GET /v2/items
Parâmetros de consulta
marketplace
string
Nome do marketplace (ex.:
Buff163). Não diferencia maiúsculas de minúsculas.game
string
Código do jogo (ex.:
CS2, Dota2, Rust, TF2).name
string
Nome de mercado completo do item (ex.:
AK-47 | Redline (Field-Tested)).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 onde o item está listado |
game | string | Jogo ao qual o item pertence |
priceUSD | number|null | Menor preço de oferta em USD |
priceEUR | number|null | Menor preço de oferta em EUR |
priceCNY | number|null | Menor preço de oferta em CNY |
priceRUB | number|null | Menor preço de oferta em RUB |
offerCount | number | Número de ofertas abertas |
condition | string|null | Condição do item (ex.: Field-Tested) |
thumbnail | string|null | URL da imagem em miniatura do item |
updatedAt | number | Unix timestamp (segundos) da última atualização |
offers | array | Array de objetos de oferta |
buyOrders | array | Array de objetos de ordem de compra |
Objeto de oferta
| Campo | Tipo | Descrição |
|---|---|---|
purchaseLink | string|null | Link direto para comprar o item no marketplace |
inspectLink | string|null | Link de inspeção do Steam (apenas CS2) |
priceUSD | number|null | Preço da oferta em USD |
priceEUR | number|null | Preço da oferta em EUR |
priceCNY | number|null | Preço da oferta em CNY |
priceRUB | number|null | Preço da oferta 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) |
daysTradeLocked | number|null | Dias até o item se tornar negociável |
foundAt | number | Unix timestamp de quando a oferta foi detectada |
updatedAt | number | Unix timestamp da última atualização |
stickers | array|null | Adesivos aplicados (apenas CS2) |
ownerId | string|null | Identificador do vendedor no marketplace |
Objeto de ordem de compra
| Campo | Tipo | Descrição |
|---|---|---|
orderId | string|null | ID da ordem específico do marketplace |
quantity | number|null | Número de unidades solicitadas |
priceUSD | number|null | Preço de lance em USD |
priceEUR | number|null | Preço de lance em EUR |
priceCNY | number|null | Preço de lance em CNY |
priceRUB | number|null | Preço de lance em RUB |
itemPhase | string|null | Fase ou variante do item (fases doppler do CS2, etc.) |
updatedAt | number | Unix timestamp da última atualização |
Exemplo de resposta
response.json
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"offerCount": 128,
"condition": "Field-Tested",
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000,
"offers": [
{
"purchaseLink": "https://buff.163.com/goods/...",
"inspectLink": "steam://rungame/730/...",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"float": 0.2341,
"paintIndex": 282,
"paintSeed": 123,
"daysTradeLocked": 0,
"foundAt": 1711150000,
"updatedAt": 1711152000,
"stickers": [],
"ownerId": "user-abc"
}
],
"buyOrders": [
{
"orderId": "order-xyz",
"quantity": 5,
"priceUSD": 43.00,
"priceEUR": 39.80,
"priceCNY": 305.00,
"priceRUB": 3950.00,
"itemPhase": null,
"updatedAt": 1711151800
}
]
}