Items

Item Details

Get full details for a specific Steam market item including metadata, histogram, and price history.

Endpoint

This endpoint returns comprehensive data for a specific Steam market item, including the item record, metadata, latest buy/sell histogram, and price history.

GET   /v2/steam/items/{appId}/{marketHashName}

Required parameters

appId
number
The Steam application ID the item belongs to.
marketHashName
string
The URL-encoded market hash name of the item.

Authentication

Include your API key as the x-api-key request header.

x-api-key: YourSecretAPIKey

Response fields

FieldTypeDescription
itemobjectThe item record
metaobject|nullItem metadata (images, tags, descriptions)
histogramobject|nullLatest buy/sell order histogram
priceHistoryobject|nullHistorical price data

Item object

FieldTypeDescription
_idstringDocument ID
nameIdnumber|nullSteam market name ID
appIdnumberSteam application ID
marketNamestringMarket display name
marketHashNamestringURL-encoded market name
classIdnumber|nullSteam class ID
instanceIdnumber|nullSteam instance ID
isGlitchedbooleanWhether the item listing is glitched
metaUpdatedAtstring|nullISO timestamp of last metadata update
histogramUpdatedAtstring|nullISO timestamp of last histogram update
priceHistoryUpdatedAtstring|nullISO timestamp of last price history update

Meta object

FieldTypeDescription
appIdnumberSteam application ID
contextIdnumberSteam inventory context ID
classIdnumberSteam class ID
instanceIdnumberSteam instance ID
imageobjectItem image URLs
image.iconUrlstring|nullIcon image URL
image.iconUrlLargestring|nullLarge icon image URL
image.iconDragUrlstring|nullDrag icon image URL
colorobjectItem color information
color.namestring|nullName color hex code
color.backgroundstring|nullBackground color hex code
flagsobjectItem flags
flags.commoditybooleanWhether the item is a commodity
flags.marketablebooleanWhether the item is marketable
flags.tradablebooleanWhether the item is tradable
descriptionsarrayArray of description objects from Steam
tagsarrayArray of tag objects from Steam

Histogram object

FieldTypeDescription
buyOrdersarrayArray of buy order price points
buyOrders[].pricenumberBuy order price
buyOrders[].quantitynumberNumber of buy orders at this price
sellOrdersarrayArray of sell listing price points
sellOrders[].pricenumberSell listing price
sellOrders[].quantitynumberNumber of sell listings at this price
datestringISO timestamp of when the histogram was recorded

Price history object

FieldTypeDescription
dataarrayArray of historical price points
data[].pricenumberSale price
data[].quantitynumberNumber of sales
data[].datestringISO timestamp of the sale date

Response example

response.json
{
  "success": true,
  "result": {
    "item": {
      "_id": "6789abcdef012345",
      "nameId": 176096978,
      "appId": 730,
      "marketName": "AK-47 | Redline (Field-Tested)",
      "marketHashName": "AK-47 %7C Redline %28Field-Tested%29",
      "classId": 310777487,
      "instanceId": 480085569,
      "isGlitched": false,
      "metaUpdatedAt": "2025-01-15T00:00:00.000Z",
      "histogramUpdatedAt": "2025-01-15T00:00:00.000Z",
      "priceHistoryUpdatedAt": "2025-01-15T00:00:00.000Z"
    },
    "meta": {
      "appId": 730,
      "contextId": 2,
      "classId": 310777487,
      "instanceId": 480085569,
      "image": {
        "iconUrl": "-9a81dlWLwJ2UXnc...",
        "iconUrlLarge": "-9a81dlWLwJ2UXnc...",
        "iconDragUrl": null
      },
      "color": {
        "name": "D2D2D2",
        "background": null
      },
      "flags": {
        "commodity": false,
        "marketable": true,
        "tradable": true
      },
      "descriptions": [],
      "tags": []
    },
    "histogram": {
      "buyOrders": [
        { "price": 1050, "quantity": 245 },
        { "price": 1049, "quantity": 12 }
      ],
      "sellOrders": [
        { "price": 1089, "quantity": 3 },
        { "price": 1090, "quantity": 7 }
      ],
      "date": "2025-01-15T12:00:00.000Z"
    },
    "priceHistory": {
      "data": [
        { "price": 1075, "quantity": 150, "date": "2025-01-14T00:00:00.000Z" },
        { "price": 1062, "quantity": 142, "date": "2025-01-13T00:00:00.000Z" }
      ]
    }
  }
}