Skip to main content
GET
/
market
/
items
/
{itemId}
/
listings
List item listings
curl --request GET \
  --url https://api.skinshark.gg/market/items/{itemId}/listings \
  --header 'api-key: <api-key>'
{
  "requestId": "<string>",
  "success": true,
  "data": {
    "items": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "marketHashName": "<string>",
        "name": "<string>",
        "type": "<string>",
        "iconUrl": "<string>",
        "price": 123,
        "referencePrice": 123,
        "exterior": "<string>",
        "rarity": "<string>",
        "collection": "<string>",
        "color": "<string>",
        "wear": "<string>",
        "paintSeed": 123,
        "doppler": {
          "status": 123,
          "name": "<string>",
          "paintIndex": 123
        },
        "fade": {
          "percentage": 123
        },
        "hardened": {
          "status": 123,
          "name": "<string>"
        },
        "stickers": [
          {
            "name": "<string>",
            "slot": 123,
            "iconUrl": "<string>",
            "marketHashName": "<string>",
            "wear": 123
          }
        ],
        "charm": {
          "name": "<string>",
          "iconUrl": "<string>",
          "marketHashName": "<string>",
          "pattern": "<string>"
        },
        "inspectUrl": "<string>",
        "delivery": "<string>"
      }
    ],
    "total": 123
  },
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

Authorizations

​
api-key
string
header
required

Your raw API key. Generate, rotate, and revoke keys from the merchant dashboard. Keys can optionally be bound to one or more allowed source IPs — requests from any other IP are rejected with API_KEY_IP_DENIED.

Headers

​
On-Behalf-Of
string

Sub-user UUID or the merchant's externalId for that sub-user. Required for sub-user-context routes; rejected (via requireMerchant) on merchant-context routes.

Required string length: 1 - 128

Path Parameters

​
itemId
string
required
Minimum string length: 1

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:100
Required range: 1 <= x <= 100
​
market
integer
default:0
Required range: x >= 0
​
phase
enum<string>
Available options:
Phase 1,
Phase 2,
Phase 3,
Phase 4,
Ruby,
Sapphire,
Black Pearl,
Emerald
​
wearMin
number
Required range: 0 <= x <= 1
​
wearMax
number
Required range: 0 <= x <= 1

Response

OK.

​
requestId
string
required
​
success
boolean
required
​
data
object

Present when success: true. Shape varies per endpoint.

​
error
object