List item listings

curl --request GET \
  --url https://api.skinshark.gg/market/items/{itemId}/listings \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.skinshark.gg/market/items/{itemId}/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.skinshark.gg/market/items/{itemId}/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.skinshark.gg/market/items/{itemId}/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.skinshark.gg/market/items/{itemId}/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>",
        "assetId": "<string>",
        "delivery": "<string>"
      }
    ],
    "total": 123
  },
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

Market

List item listings

Auth context: sub-user — On-Behalf-Of required. Rate limit: 200/min.

Live cross-marketplace offers for an item, dispatched to marketplace workers. market filters by marketplace index (0 = all, 3 = C5Game, 4 = EcoSteam, 6 = YouPin; 1 = Steam is sell-only and rejected here). delivery filters by delivery mode (instant = auto-deliver only); omit for both. For Doppler knives, optionally filter by phase. For float-relevant items, pass wearMin + wearMax together (both required if either is sent).

Listing ids are opaque and ephemeral; the market index is encoded inside them. Ids minted before the v0.4.x market-index remap are invalidated — always re-read listings before buying rather than caching ids.

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>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.skinshark.gg/market/items/{itemId}/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.skinshark.gg/market/items/{itemId}/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.skinshark.gg/market/items/{itemId}/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.skinshark.gg/market/items/{itemId}/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>",
        "assetId": "<string>",
        "delivery": "<string>"
      }
    ],
    "total": 123
  },
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

{
  "requestId": "<string>",
  "success": true,
  "data": "<unknown>",
  "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

Marketplace index — 0 all, 3 C5Game, 4 EcoSteam, 6 YouPin (1 Steam is sell-only, rejected).

Required range: x >= 0

delivery

enum<string>

Available options:

standard,

instant

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.

Show child attributes

error

object

Show child attributes

Account

Users

Trades

Profile

Trade URLs

Wallet

Deposits

Partner Payout Custody

Market

WebSocket

List item listings

Authorizations

Headers

Path Parameters

Query Parameters

Response