Skip to main content

​
GET /v2/partner/live/listings

Get real-time mixed live listings, sorted by popularity rank.

​
Response type

type PartnerLiveListingsV2Response = ApiSuccess<{
  listings: ListingItemV2[];
  listingsCount: number;
}>;

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v2/partner/live/listings" \
  --header "X-API-Key: <YOUR_API_KEY>"

{
  "requestId": "25f3f0f0-31b3-4f6d-9ca2-55fcb41de843",
  "success": true,
  "data": {
    "listings": [
      {
        "itemId": "567bab62f59de004",
        "id": "2026012171560510343364609",
        "marketHashName": "M4A1-S | Printstream (Field-Tested)",
        "type": "skin",
        "iconUrl": "https://cdn.skinshark.gg/items/567bab62f59de004.png",
        "price": 86.25,
        "priceWithFee": 90.57,
        "steamPrice": 87.11,
        "delivery": "auto",
        "market": "ecosteam",
        "exterior": "Field-Tested",
        "wear": 0.189,
        "paintSeed": 321,
        "rarity": "Covert",
        "collection": "The Operation Broken Fang Collection",
        "color": "#eb4b4b",
        "stickers": [],
        "charm": null
      }
    ],
    "listingsCount": 1
  }
}

​
POST /v2/partner/listing-detail

Batch fetch listing details for up to 10 mixed-market listings.

​
Request type

interface PartnerListingDetailV2Request {
  items: Array<{
    item: string; // 16-char SkinShark item id
    listing: string; // numeric listing id
    market: 'c5game' | 'ecosteam';
  }>;
}

​
Response type

type PartnerListingDetailV2Response = ApiSuccess<{
  items: Array<
    | ListingItemV2
    | {
        id: string;
        error: 'ITEM_NOT_FOUND' | 'LISTING_NOT_FOUND';
      }
  >;
}>;

​
Example

curl --request POST \
  --url "https://api.skinshark.gg/v2/partner/listing-detail" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: <YOUR_API_KEY>" \
  --data '{
    "items": [
      { "item": "567bab62f59de004", "listing": "2026012171560510343364609", "market": "ecosteam" }
    ]
  }'

{
  "requestId": "5228af37-f962-4ce0-a6fb-a4a7d7627317",
  "success": true,
  "data": {
    "items": [
      {
        "itemId": "567bab62f59de004",
        "id": "2026012171560510343364609",
        "marketHashName": "M4A1-S | Printstream (Field-Tested)",
        "type": "skin",
        "iconUrl": "https://cdn.skinshark.gg/items/567bab62f59de004.png",
        "price": 86.25,
        "priceWithFee": 90.57,
        "steamPrice": 87.11,
        "delivery": "auto",
        "market": "ecosteam",
        "exterior": "Field-Tested",
        "wear": 0.189,
        "paintSeed": 321,
        "rarity": "Covert",
        "collection": "The Operation Broken Fang Collection",
        "color": "#eb4b4b",
        "stickers": [],
        "charm": null
      }
    ]
  }
}