Skip to content
SkinsNodeDocumentation
Read catalog
Docs/Withdrawals

Read catalog

Return items currently available to the authenticated account.

GET/v1/catalog

Client credentials. Account scoped.

Request

cURL
curl -X GET 'https://api.skinsnode.com/v1/catalog' \
  -H "x-client-id: client_live_abc123" \
  -H "x-client-secret: sk_live_replace_me"

Response 200 OK

JSON response
{
  "items": [
    {
      "id": "8d15e82b-21fe-4ec1-a37f-1e2e5edeb1fd",
      "marketHashName": "Example Item",
      "price": 1840,
      "currency": "USD",
      "phase": null,
      "floatValue": "0.2183",
      "paintIndex": 282,
      "paintSeed": 771,
      "rarityColor": "#eb4b4b",
      "classId": "310777746",
      "instanceId": "188530139",
      "imageUrl": "https://...",
      "stickers": [
        {
          "name": "Sticker | Titan (Holo) | Katowice 2014",
          "img": "https://cdn.example.com/items/sticker.png",
          "slot": 2,
          "wear": "12%",
          "rotation": 18,
          "offsetX": -0.08,
          "offsetY": 0.11
        }
      ],
      "keyChains": [
        {
          "name": "Charm | Hot Wurst",
          "img": "https://cdn.example.com/items/charm.png",
          "slot": 1,
          "pattern": 847,
          "offsetX": 0.21,
          "offsetY": -0.04,
          "offsetZ": 1.42
        }
      ]
    }
  ]
}

Integration rules

Refresh before quoting or ordering. Use the returned item id as catalogItemId and price as expectedPrice. Preserve the exact variant, phase and asset details.

Optional item metadata includes float, paint seed, stickers and charms. See the OpenAPI schema for the complete object shape.