Усі за найнижчою ціною

Передумови

Перш ніж почати, переконайтеся, що у вас є:

Працююче підключення до Інтернету
Відповідна мова програмування або клієнт API (наприклад, Postman, CURL або бібліотека HTTP вашої мови програмування)

Кінцева точка API

JSON

CSV

Замініть {APP} на відповідне значення для потрібної програми:

730 - для CS2

10min, 1hour, 12hours чи 24hours - максимальний термін доставки від продавця.

Поля у відповіді

Відповідь API містить такі поля:

market_hash_name - хеш скіна
price - значення ціни в USD
market_product_link - посилання на групу товарів певного скіна
market_product_count - кількість товарів у групі скіна
cheapest_asset_id – asset ID найдешевшого скіна
cheapest_float – float-значення найдешевшого скіна
paint_index – індекс фарбування найдешевшого скіна
paint_seed – seed фарбування найдешевшого скіна
inspect_link – посилання для перегляду найдешевшого скіна

Для участі в партнерській програмі необхідно третє поле - market_product_link. Значення в цьому полі - це посилання, яке веде до продукту на WhiteMarket за найкращою ціною.

Ключ запису

Ключ запису — пара (market_hash_name, paint_index), а не лише market_hash_name.

Steam не кодує фазу Doppler у market_hash_name — вона зберігається в paint_index. Тому предмети з фазами (Doppler, Gamma Doppler) присутні кількома рядками з однаковим market_hash_name і різними paint_index, кожен зі своєю ціною. Якщо ключувати лише за market_hash_name, буде взято довільну фазу, і ціна може відрізнятися на порядок (напр. ★ Butterfly Knife | Doppler (Factory New): Phase 4 ≈ $2 281, Ruby ≈ $13 406).

cheapest_float дорівнює null для предметів без float (агенти, наліпки, кейси), а також може бути null, якщо у найдешевшого лота групи немає значення float.

Свіжість даних

Кожен файл експорту має sidecar із метаданими свіжості за адресою <файл>.meta.json, наприклад https://export.white.market/v1/prices/730.json.meta.json:

{
  "file": "730.json",
  "data_as_of": "2026-07-31T10:30:02+00:00",
  "generated_at": "2026-07-31T10:32:54+00:00",
  "items": 20848
}

data_as_of — момент, на який актуальний знімок даних. Це і є реальний вік даних, він завжди раніший за Last-Modified файла.
generated_at — момент збірки самого файла.
items — кількість записів у файлі.

Фід — це знімок, а не realtime-потік: типовий вік даних — кілька хвилин, тому найдешевший лот популярного предмета може бути вже проданий. Використовуйте data_as_of, щоб вирішити, чи достатньо свіжий знімок для вашого сценарію.

Приклад використання API

Postman

CURL

Щоб отримати ціни на скіни CS2 у форматі JSON, використовуйте таку команду CURL:

curl -X GET "https://export.white.market/v1/prices/730.json"

Python

Ось приклад використання API з Python і бібліотекою запитів:

import requests
    
url = "https://export.white.market/v1/prices/730.json"

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")