API referenceMarket data
Get listings
Returns a cursor-paginated market page as `{ data, cursor }`.
GET
/listingsReturns a cursor-paginated market page as { data, cursor }. Filters combine freely; every
parameter below is optional.
Query Parameters
cursor?string
Opaque cursor from the preceding page.
limit?integer
Results per page. Official maximum is 50.
Range
1 <= value <= 50Default
50sort_by?string
Default
"best_deal"Value in
- "lowest_price"
- "highest_price"
- "most_recent"
- "expires_soon"
- "lowest_float"
- "highest_float"
- "best_deal"
- "highest_discount"
- "float_rank"
- "num_bids"
category?integer
0 any, 1 normal, 2 StatTrak, 3 souvenir.
Default
0Value in
- 0
- 1
- 2
- 3
def_index?integer
paint_index?integer
paint_seed?integer
min_float?number
Range
0 <= value <= 1max_float?number
Range
0 <= value <= 1rarity?integer
user_id?string
Seller Steam ID64.
Match
^\\d+$collection?string
min_price?integer
USD cents.
Format
int64Range
0 <= valuemax_price?integer
USD cents.
Format
int64Range
0 <= valuemarket_hash_name?string
type?string
Value in
- "buy_now"
- "auction"
stickers?string
Comma-separated stickerId|slot selectors. Slot is optional.
min_ref_qty?integer
Minimum reference-price sample quantity.
Range
0 <= valueResponse Body
application/json
curl -X GET "https://example.com/listings"{ "data": [ { "id": "string", "created_at": "2019-08-24T14:15:22Z", "sold_at": "2019-08-24T14:15:22Z", "type": "buy_now", "price": 0, "state": "string", "description": "string", "seller": { "steam_id": "string", "obfuscated_id": "string", "username": "string", "avatar": "http://example.com", "flags": 0, "online": true, "away": true, "stall_public": true, "statistics": { "median_trade_time": 0, "total_avoided_trades": 0, "total_failed_trades": 0, "total_trades": 0, "total_verified_trades": 0 } }, "item": { "asset_id": "string", "market_hash_name": "string", "item_name": "string", "type": "string", "type_name": "string", "wear_name": "string", "collection": "string", "description": "string", "def_index": 0, "paint_index": 0, "paint_seed": 0, "float_value": 0, "rarity": 0, "rarity_name": "string", "quality": 0, "is_stattrak": true, "is_souvenir": true, "is_commodity": true, "tradable": 0, "icon_url": "string", "inspect_link": "string", "d_param": "string", "serialized_inspect": "string", "gs_sig": "string", "cs2_screenshot_id": "string", "cs2_screenshot_at": "2019-08-24T14:15:22Z", "phase": "string", "low_rank": 0, "high_rank": 0, "sticker_index": 0, "keychain_index": 0, "keychain_pattern": 0, "stickers": [ { "stickerId": 0, "slot": 0, "wear": 0, "name": "string", "icon_url": "string", "offset_x": 0, "offset_y": 0, "reference": { "price": 0, "quantity": 0, "updated_at": "2019-08-24T14:15:22Z" } } ], "keychains": [ { "stickerId": 0, "slot": 0, "pattern": 0, "wrapped_sticker": 0, "name": "string", "icon_url": "string", "offset_x": 0, "offset_y": 0, "offset_z": 0, "reference": { "price": 0, "quantity": 0, "updated_at": "2019-08-24T14:15:22Z" } } ], "badges": [ "string" ], "reference": { "base_price": 0, "predicted_price": 0, "keychain_price": 0, "float_factor": 0, "quantity": 0, "last_updated": "2019-08-24T14:15:22Z", "buy_order": { "max_price": 0, "quantity": 0 } }, "fade": { "percentage": 0, "rank": 0, "seed": 0, "type": "string" }, "blue_gem": { "playside_blue": 0, "playside_gold": 0, "playside_purple": 0, "backside_blue": 0, "backside_gold": 0, "backside_purple": 0 } }, "reference": { "base_price": 0, "predicted_price": 0, "keychain_price": 0, "float_factor": 0, "quantity": 0, "last_updated": "2019-08-24T14:15:22Z", "buy_order": { "max_price": 0, "quantity": 0 } }, "is_seller": true, "min_offer_price": 0, "max_offer_discount": 0, "is_watchlisted": true, "watchers": 0, "auction_details": { "expires_at": "2019-08-24T14:15:22Z", "reserve_price": 0, "min_next_bid": 0, "top_bid": { "id": "string", "contract_id": "string", "obfuscated_buyer_id": "string", "price": 0, "state": "string", "created_at": "2019-08-24T14:15:22Z" } } } ], "cursor": "string"}