REST
Ordens de Compra
Liste ordens de compra abertas de marketplaces que expõem dados de ordens de compra.
Endpoint
Retorna ordens de compra abertas de marketplaces que expõem dados de ordens de compra. Cada ordem inclui seu contexto de item (nome, marketplace, jogo), para que você possa trabalhar com a resposta como uma lista plana.
GET /v2/buy-orders
Cobertura
Apenas um subconjunto de marketplaces expõe dados de ordens de compra. A lista abaixo é obtida ao vivo da API e reflete quais marketplaces atualmente têm ordens de compra disponíveis.
Carregando disponibilidade de marketplaces…
Parâmetros de consulta
game
string
Código do jogo (ex.:
CS2, Dota2, Rust, TF2).marketplace
string
Filtro opcional de marketplace. Deve ser um marketplace que exponha ordens de compra — veja a tabela acima.
name
string
Filtro opcional de nome de item. A correspondência é exata.
limit
number
Número máximo de ordens a retornar. Padrão é
500.Autenticação
Veja Visão geral REST para URL base, autenticação e formato de erros.
Campos da resposta
A resposta é um array de objetos de ordem de compra.
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome de mercado do item |
marketplace | string | Marketplace onde a ordem foi colocada |
game | string | Jogo ao qual o item pertence |
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",
"orderId": "order-xyz",
"quantity": 5,
"priceUSD": 43.00,
"priceEUR": 39.80,
"priceCNY": 305.00,
"priceRUB": 3950.00,
"itemPhase": null,
"updatedAt": 1711151800
}
]