PokeTrace
PokeTrace

WebSocket (Early access)

Subscribe to real-time price updates via WebSocket. Get instant notifications when card prices change. Perfect for building live dashboards, alerts, and trading tools. Available exclusively on the Scale plan.

Plans

  • ScaleIncluded

Events

  • price.card-updated

Limits

  • Max connections per user3
  • Max messages per minute30
  • Max message size1 KB

Connection

websocket_connect
# WebSocket URL
wss://api.poketrace.com/v1/ws
# Auth via X-API-Key header
Response 200 OK
// Connection established
{
  "event": "connected",
  "data": { "message": "Connected to PokeTrace real-time feed" }
}
 
// US card 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 card 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 card update (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 card 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" }