SkinMarketCap API
Marketplaces

List deals

CS2 items listed below the reference marketplace's price, biggest discount first. Costs 2 credits per page. Needs the Starter plan or above.

GET
/v1/deals

Authorization

x-api-key<token>

In: header

Query Parameters

reference?string

The marketplace every deal is measured against; it is never the one to buy from. steam is the price most players know, buff163 the one traders quote

Default"steam"

Value in

  • "skinport"
  • "dmarket"
  • "csmoney"
  • "steam"
  • "buff163"
  • "lisskins"
  • "csfloat"
  • "marketcsgo"
  • "avanmarket"
  • "waxpeer"
  • "shadowpay"
q?string

Words in the market hash name

Length1 <= length <= 100
category?string

Comma-separated, any of: knife, gloves, pistol, rifle, sniper-rifle, smg, shotgun, machinegun, sticker, container, charm, agent, music-kit, equipment

Length1 <= length <= 500
minPrice?|

price at least this, integer USD cents. Defaults to 50: percent discounts on the cheapest items are rounding noise

Range0 <= value
maxPrice?|

price at most this, integer USD cents

Range0 <= value
minDiscount?|

discount at least this

Range0 <= value <= 99
sort?string

Largest first

Default"discount"

Value in

  • "discount"
  • "difference"
page?integer

Page to return, from 1

Range1 <= value
Default1
limit?integer

Deals per page, up to 1000

Range1 <= value <= 1000
Default100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/deals"
{  "data": [    {      "marketHashName": "★ Bayonet | Doppler (Minimal Wear)",      "name": "★ Bayonet | Doppler",      "itemSlug": "bayonet-doppler-ruby",      "weapon": "Bayonet",      "rarity": {        "name": "Covert",        "color": "#eb4b4b"      },      "exterior": "Minimal Wear",      "quality": "normal",      "phase": "Ruby",      "image": "https://community.akamai.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyLzn4_v8ydP0POjV7Z4IumsA2aCw-JzuftsSxa_nBovp3PWnomsdn2QPVN0D5UiEOUP50LtltTvY-Ll4g3YjItFmSv-2i9A6X4-_a9cBu2YVmHc",      "price": 167500,      "marketplace": "csmoney",      "listings": 4,      "reference": "buff163",      "referencePrice": 414691,      "discount": 59.61,      "difference": 247191    }  ],  "pagination": {    "page": 1,    "limit": 100,    "total": 15343,    "totalPages": 154  }}