Market
Item
Get detailed market data for a specific Steam item including price history and buy/sell orders.
Endpoint
This endpoint fetches detailed data about any item in our database.
GET /market/item/{ AppID }/{ MarketHashName }?api_key={ YourSecretAPIKey }
Required parameters
AppID
number
Identifier of the application which item you want to fetch.
market_hash_name
string
The
market_hash_name of the item you want to fetch (e.g. AK-47 | Redline (Field-Tested)).YourSecretAPIKey
string
A unique identifier that allows developers to access the Steam Web API.
Optional parameters
median_history_days
number
How many median prices to return in a single response. Default is
15.Response fields
| Field | Type | Description |
|---|---|---|
nameID | number | Unique market name identifier |
appID | number | The Steam application ID |
market_name | string | Display name of the item |
market_hash_name | string | URL-safe market hash name |
description | string | Application name the item belongs to |
url | string | Full Steam Community Market URL for the item |
image | string | URL to the item image |
border_color | string | Hex color code for item border |
app_context_data | object | Application context information |
median_avg_prices_15days | array | Array of price history entries |
histogram | object | Current buy/sell order histogram data |
assets | object | Item asset information including descriptions and actions |
updated_at | number | Timestamp of when the data was last updated (Unix milliseconds) |
Median price entry
Each entry in median_avg_prices_15days is an array with:
| Index | Type | Description |
|---|---|---|
| 0 | string | Date string (e.g. "Jan 08 2021") |
| 1 | number | Median price in USD |
| 2 | number | Number of sales on that day |
Histogram object
| Field | Type | Description |
|---|---|---|
sell_order_array | array | Array of sell order objects with price and quantity |
sell_order_summary | object | Summary with lowest price and total quantity |
buy_order_array | array | Array of buy order objects with price and quantity |
buy_order_summary | object | Summary with highest price and total quantity |
highest_buy_order | number | Highest current buy order price |
lowest_sell_order | number | Lowest current sell order price |
buy_order_graph | array | Graph data for buy orders |
sell_order_graph | array | Graph data for sell orders |
graph_max_y | number | Maximum Y-axis value for graphing |
graph_min_x | number | Minimum X-axis value for graphing |
graph_max_x | number | Maximum X-axis value for graphing |
price_prefix | string | Currency prefix (e.g. "$") |
price_suffix | string | Currency suffix (empty for USD) |
Assets object
| Field | Type | Description |
|---|---|---|
descriptions | array | Array of description objects with type, value, and optional color |
actions | array | Array of action objects with link and name |
type | string | Item type classification (e.g. "Classified Rifle") |
Response example
Example output for this endpoint. For brevity's sake, some objects and arrays were omitted.
response.json
{
"nameID": 7178002,
"appID": 730,
"market_name": "AK-47 | Redline (Field-Tested)",
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"description": "Counter-Strike: Global Offensive",
"url": "https://steamcommunity.com/market/listings/730/AK-47%20%7C%20Redline%20(Field-Tested)",
"image": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV09-5lpKKqPrxN7LEmyVQ7MEpiLuSrYmnjQO3-UdsZGHyd4_Bd1RvNQ7T_FDrw-_ng5Pu75iY1zI97bhLsvQz",
"border_color": "#D2D2D2",
"app_context_data": {
"730": {
"appid": 730,
"name": "Counter-Strike: Global Offensive",
"icon": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/apps/730/69f7ebe2735c366c65c0b33dae00e12dc40edbe4.jpg",
"link": "https://steamcommunity.com/app/730"
}
},
"median_avg_prices_15days": [
[
"Jan 08 2021",
19.726874999999996,
730
],
[
"Jan 09 2021",
19.85370833333334,
790
],
[
"Jan 10 2021",
20.311833333333336,
629
],
[
"Jan 11 2021",
20.089541666666666,
632
],
[
"Jan 12 2021",
20.194166666666664,
615
],
[
"Jan 13 2021",
20.31454166666667,
650
],
[
"Jan 14 2021",
20.253833333333333,
681
],
[
"Jan 15 2021",
20.18208333333333,
630
],
[
"Jan 16 2021",
19.99816666666667,
688
],
[
"Jan 17 2021",
19.86004166666667,
726
],
[
"Jan 18 2021",
19.719541666666665,
602
],
[
"Jan 19 2021",
20.25795833333333,
580
],
[
"Jan 20 2021",
20.142291666666665,
703
],
[
"Jan 21 2021",
19.878958333333333,
578
],
[
"Jan 22 2021",
19.92508333333333,
196
]
],
"histogram": {
"sell_order_array": [
{
"price": 19.8,
"quantity": 1
},
{
"price": 19.91,
"quantity": 1
},
{
"price": 20.09,
"quantity": 1
},
{
"price": 20.28,
"quantity": 2
},
{
"price": 20.5,
"quantity": 1
},
{
"price": 20.51,
"quantity": 1119
}
],
"sell_order_summary": {
"price": 19.8,
"quantity": 1125
},
"buy_order_array": [
{
"price": 19.27,
"quantity": 51
},
{
"price": 19.26,
"quantity": 10
},
{
"price": 19.24,
"quantity": 1
},
{
"price": 19.15,
"quantity": 20
},
{
"price": 18.88,
"quantity": 10
},
{
"price": 18.86,
"quantity": 66934
}
],
"buy_order_summary": {
"price": 19.27,
"quantity": 67026
},
"highest_buy_order": 19.27,
"lowest_sell_order": 19.8,
"buy_order_graph": [
[
19.27,
51,
"51 buy orders at $19.27 or higher"
],
[
19.26,
61,
"61 buy orders at $19.26 or higher"
],
],
"sell_order_graph": [
[
19.8,
1,
"1 sell orders at $19.80 or lower"
],
[
19.91,
2,
"2 sell orders at $19.91 or lower"
],
],
"graph_max_y": 2000,
"graph_min_x": 16.19,
"graph_max_x": 24.96,
"price_prefix": "$",
"price_suffix": ""
},
"assets": {
"descriptions": [
{
"type": "html",
"value": "Exterior: Field-Tested"
},
{
"type": "html",
"value": " "
},
{
"type": "html",
"value": "Powerful and reliable, the AK-47 is one of the most popular assault rifles in the world. It is most deadly in short, controlled bursts of fire. It has been painted using a carbon fiber hydrographic and a dry-transfer decal of a red pinstripe.\n\nNever be afraid to push it to the limit"
},
{
"type": "html",
"value": " "
},
{
"type": "html",
"value": "The Phoenix Collection",
"color": "9da1a9"
},
{
"type": "html",
"value": " "
}
],
"actions": [
{
"link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20M3282516681038144004A%assetid%D9513866172767414267",
"name": "Inspect in Game..."
}
],
"type": "Classified Rifle"
},
"updated_at": 1611452771457
}