REST
Zlecenia kupna
Lista otwartych zleceń kupna z marketplace'ów, które udostępniają dane o zleceniach kupna.
Endpoint
Zwraca otwarte zlecenia kupna z marketplace'ów, które udostępniają dane o zleceniach kupna. Każde zlecenie zawiera kontekst przedmiotu (nazwa, marketplace, gra), więc możesz pracować z odpowiedzią jako płaską listą.
GET /v2/buy-orders
Zakres
Tylko część marketplace'ów udostępnia dane o zleceniach kupna. Lista poniżej jest pobierana na żywo z API i pokazuje, które marketplace'y obecnie mają dostępne zlecenia kupna.
Ładowanie dostępności marketplace'ów…
Parametry zapytania
game
string
Kod gry (np.
CS2, Dota2, Rust, TF2).marketplace
string
Opcjonalny filtr marketplace'u. Musi być marketplace'em udostępniającym zlecenia kupna — zobacz tabelę powyżej.
name
string
Opcjonalny filtr nazwy przedmiotu. Dopasowanie jest dokładne.
limit
number
Maksymalna liczba zwracanych zleceń. Domyślnie
500.Uwierzytelnianie
Zobacz Przegląd REST po bazowy URL, uwierzytelnianie i format błędów.
Pola odpowiedzi
Odpowiedź to tablica obiektów zleceń kupna.
| Pole | Typ | Opis |
|---|---|---|
name | string | Rynkowa nazwa przedmiotu |
marketplace | string | Marketplace, na którym zostało złożone zlecenie |
game | string | Gra, do której należy przedmiot |
orderId | string|null | ID zlecenia specyficzne dla marketplace'u |
quantity | number|null | Liczba żądanych jednostek |
priceUSD | number|null | Cena oferowana w USD |
priceEUR | number|null | Cena oferowana w EUR |
priceCNY | number|null | Cena oferowana w CNY |
priceRUB | number|null | Cena oferowana w RUB |
itemPhase | string|null | Faza lub wariant przedmiotu (fazy doppler CS2 itp.) |
updatedAt | number | Unix timestamp ostatniej aktualizacji |
Przykład odpowiedzi
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
}
]