Open live-market WebSocket

curl --request GET \
  --url https://api.skinshark.gg/market/live \
  --header 'api-key: <api-key>'

WebSocket

Open live-market WebSocket

Auth context: sub-user — token from POST /auth/ws-token (must carry the market scope).

Open with wss://api.skinshark.gg/market/live?token=<wsToken>&scope=<scope>:

scope=watchlist — deltas for the curated live market (the same feed served by GET /market).
scope=all (default) — the full C5 firehose: every market event, transformed to our format but not DB-enriched. Uncached, WS-only.

Read-only. Any client → server frame closes the socket with code 4002. On connect the server sends { event: "market.ready", data: { scope }, ts }, then streams deltas. Prices carry the sub-user’s fee.

Events

Each frame has the shape { event, data, ts } where ts is Unix epoch ms.

market.new → a listing appeared. data is a MarketListing.
market.update → a listing’s price/fields changed. data is a MarketListing.
market.remove → a listing is gone. data is { listingId, itemId? }.

Treat market.new and market.update identically — upsert the listing keyed by data.id. On market.remove, drop it by data.listingId.

Close codes

Code	Reason	Cause
4001	Missing token	No `?token=` query string
4001	Invalid token	Bad signature, expired, or wrong purpose
4002	Read-only	Client sent any frame after upgrade
4003	Missing scope	Token lacks the `market` scope
4008	Too many	Per-user (5) or total (10k) connection cap reached

GET

market

live

Open live-market WebSocket

curl --request GET \
  --url https://api.skinshark.gg/market/live \
  --header 'api-key: <api-key>'

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.

Query Parameters

token

string

required

Minimum string length: 1

scope

enum<string>

default:all

Available options:

all,

watchlist

Response

Switching Protocols — WebSocket handshake completed.

WebSocket events (reference)