Endpoints · Early access

WebSocket

Subscribe to real-time price updates over WebSocket and get notified as soon as card prices change. Useful for live dashboards, alerts and trading tools. Available on the Scale and Business plans.

URL	`wss://api.poketrace.com/v2/ws`
Authentication	`X-API-Key` header
Plan	Scale or Business
Events	`price.card-updated`

Limits

Limit	Value
Connections per user	3
Messages per minute	30
Message size	1 KB

Connecting

Connect with your API key, listen for price.card-updated events and send a ping every 30 seconds to keep the connection alive. The response panel shows every message shape the feed sends.

Events are sent per market record: data.id is the US id or the EU id whose price changed, and the price is in that market's currency. A card linked across markets can therefore send events under two ids. To map them to one card, read markets.US.cardId and markets.EU.cardId from GET /cards/:id once and store both ids.

websocket_connect

# WebSocket URL
wss://api.poketrace.com/v2/ws
# Auth via X-API-Key header

Response · 200 OK

// Connection established
{
  "event": "connected",
  "data": { "message": "Connected to PokeTrace real-time feed" }
}
 
// US record update (eBay graded)
{
  "event": "price.card-updated",
  "data": {
    "id": "019bff77-befa-771d-bab0-f5909f0a78c9",
    "source": "ebay",
    "tier": "PSA_10",
    "price": 5200.00,
    "currency": "USD"
  },
  "timestamp": "2026-01-27T14:30:00.000Z"
}
 
// US record update (TCGPlayer raw with historical averages)
{
  "event": "price.card-updated",
  "data": {
    "id": "019bff77-befa-771d-bab0-f5909f0a78c9",
    "source": "tcgplayer",
    "tier": "NEAR_MINT",
    "price": 89.99,
    "avg1d": 88.50,
    "avg7d": 87.00,
    "avg30d": 85.00,
    "currency": "USD"
  },
  "timestamp": "2026-01-27T14:30:00.000Z"
}
 
// EU record update of the same card (cardmarket_unsold = active listings with tier/country)
{
  "event": "price.card-updated",
  "data": {
    "id": "eu_273927",
    "source": "cardmarket_unsold",
    "tier": "NEAR_MINT",
    "price": 78.50,
    "currency": "EUR",
    "country": "DE"
  },
  "timestamp": "2026-01-27T14:30:00.000Z"
}
 
// EU record update (cardmarket = Price Trend, no tier)
{
  "event": "price.card-updated",
  "data": {
    "id": "eu_273927",
    "source": "cardmarket",
    "price": 75.00,
    "avg1d": 74.50,
    "avg7d": 73.00,
    "avg30d": 72.00,
    "currency": "EUR"
  },
  "timestamp": "2026-01-27T14:30:00.000Z"
}
 
// Ping/pong for keepalive
{ "type": "ping" }
{ "type": "pong" }