Skip to main content
GET
Keyless min-ask feed
Публичный фид цен отвечает на один вопрос: какая сейчас самая дешёвая цена на CSBoard для каждого предмета? В ответе — один объект, где каждому market_hash_name, выставленному на продажу в выбранной игре, сопоставлена его минимальная цена в USD. Ни глубины стакана, ни количества листингов, ни разбивки по износу, ни пагинации. API-ключ не нужен. Не отправляйте заголовок Authorization, баланс тоже не требуется. Это эндпоинт для сайтов сравнения цен, таблиц и парсеров, которым нужно одно число на название.

Что вы получаете

  • Одна игра на запрос. appId=730 — CS2 (по умолчанию), 570 — Dota 2, 252490 — Rust.
  • Названия как в Steam. Фазы CS2 Doppler и Gamma Doppler объединены под базовым названием, которое использует Steam, поэтому Karambit | Doppler (Factory New) получает цену самой дешёвой фазы. Каждый ключ совпадает с реальным market_hash_name в Steam.
  • Ключи отсортированы, цены округлены до цента. В фид попадают только названия, у которых есть хотя бы один листинг в продаже.
  • updatedAt — момент, когда ответ был собран.

Лимиты и свежесть

Фид пересобирается не чаще раза в минуту и отдаётся с Cache-Control: public, max-age=60. Лимит — 1 запрос в минуту с одного IP-адреса. Более частый опрос не даст свежих данных — только 429 с заголовком Retry-After.
429 здесь выдаёт лимитер по IP, а не по ключу, поэтому тело ответа — { "error": "...", "statusCode": 429 }, без поля code. Ориентируйтесь на HTTP-статус и ждите Retry-After секунд.

Пример запроса

Пример ответа

Коды ошибок

Нужны разбивка по износу и фазам, количество листингов, фильтры или пагинация? Используйте GET /v1/prices с ключом. Нужен конкретный листинг для покупки? Используйте GET /v1/listings — этот фид индикативный и может отставать до минуты.

Параметры запроса

appId
enum<integer>
по умолчанию:730

Game to price: 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. A game that is not available answers 400 invalid_param.

Доступные опции:
730,
570,
252490

Ответ

Name → min-ask map for the game.

appId
integer
обязательно

The game these prices are for.

Пример:

730

currency
enum<string>
обязательно
Доступные опции:
USD
updatedAt
string<date-time>
обязательно

When this payload was built. It is rebuilt at most once a minute.

items
object
обязательно

market_hash_name → the cheapest current ask in USD, rounded to the cent. Keys are sorted. Only names with at least one listing on sale appear. CS2 Doppler and Gamma Doppler phases are merged into Steam's base name and carry the cheapest phase.