Market

Histograms

Get buy and sell order data for all items in a Steam application. View highest buy orders and lowest sell orders.

Endpoint

This endpoint returns buy and sell order data (histogram information) for all monitored items that belong to the specified application. This provides a quick overview of the current highest buy orders and lowest sell orders across all items.

GET   /market/items/{ AppID }/histograms?api_key={ YourSecretAPIKey }

Required parameters

AppID
number
Identifier of the application which item histograms you want to fetch.
YourSecretAPIKey
string
A unique identifier that allows developers to access the Steam Web API.

Response fields

The response is an array of histogram objects for each item.

FieldTypeDescription
market_hash_namestringThe market hash name of the item
histogramobjectObject containing buy and sell order data

Histogram object

FieldTypeDescription
highest_buy_ordernumber | nullThe highest current buy order price in USD. Returns null if no buy orders exist.
lowest_sell_ordernumber | nullThe lowest current sell order price in USD. Returns null if no sell orders exist.

Response example

Example output for this endpoint. For brevity's sake, some objects were omitted.

response.json
[
  {
    "market_hash_name": "Junker's Vest",
    "histogram": {
      "highest_buy_order": 0.7,
      "lowest_sell_order": 0.81
    }
  },
  {
    "market_hash_name": "Warlord Hatchet",
    "histogram": {
      "highest_buy_order": 0.75,
      "lowest_sell_order": 0.95
    }
  },
  {
    "market_hash_name": "Box",
    "histogram": {
      "highest_buy_order": null,
      "lowest_sell_order": null
    }
  },
  {
    "market_hash_name": "Scrap Hazard Vest",
    "histogram": {
      "highest_buy_order": 0.78,
      "lowest_sell_order": 0.89
    }
  },
  {
    "market_hash_name": "Poseidon SMG",
    "histogram": {
      "highest_buy_order": 1.61,
      "lowest_sell_order": 1.93
    }
  },
  {
    "market_hash_name": "Green Checkered Shirt",
    "histogram": {
      "highest_buy_order": 7.6,
      "lowest_sell_order": 9.44
    }
  },
  {
    "market_hash_name": "Digital Camo MP5",
    "histogram": {
      "highest_buy_order": 92.52,
      "lowest_sell_order": 97.49
    }
  },
  {
    "market_hash_name": "Big Grin",
    "histogram": {
      "highest_buy_order": 1077,
      "lowest_sell_order": 1225
    }
  }
]