Przewodnik Dewelopera PokeTrace API

GET /v1/cards

Listuj karty z paginacją i filtrami. Zwraca podstawowe informacje o kartach bez pełnych cen.

Params: limit (max 100), cursor, set, search, card_number, variant, market (US/EU), has_graded

{
  "data": [{
    "id": "019bff77-befa-771d-bab0-f5909f0a78c9",
    "name": "Charizard",
    "cardNumber": "4/102",
    "set": { "slug": "base-set", "name": "Base Set" },
    "variant": "Holofoil",
    "rarity": "Rare Holo",
    "market": "US",
    "currency": "USD"
  }],
  "pagination": { "hasMore": true, "nextCursor": "YnNfNQ==", "count": 1 }
}

GET /v1/cards/:id

Pobierz pełne szczegóły karty z cenami według źródła i poziomu. Karty US obejmują ebay (wszystkie poziomy) + tcgplayer (tylko surowe). Karty EU obejmują cardmarket (Price Trend z historycznymi średnimi) + cardmarket_unsold (aktywne oferty z podziałem na poziom/kraj).

// Karta US
{
  "data": {
    "id": "019bff77-befa-771d-bab0-f5909f0a78c9",
    "name": "Charizard",
    "market": "US",
    "currency": "USD",
    "prices": {
      "ebay": {
        "PSA_10": { "avg": 5200, "low": 4800, "high": 5600, "saleCount": 47 },
        "NEAR_MINT": { "avg": 890, "low": 750, "high": 1050, "saleCount": 156 }
      },
      "tcgplayer": {
        "NEAR_MINT": { "avg": 420, "low": 380, "high": 480, "saleCount": 89 }
      }
    }
  }
}

// Karta EU
{
  "data": {
    "id": "eu_273550",
    "name": "Charizard",
    "market": "EU",
    "currency": "EUR",
    "prices": {
      "cardmarket": { "avg": 385, "avg1d": 380, "avg7d": 375, "avg30d": 370 },
      "cardmarket_unsold": {
        "NEAR_MINT": { "avg": 420, "low": 350, "high": 890, "saleCount": 125, "country": { "DE": { "avg": 410 }, "FR": { "avg": 450 } } }
      }
    }
  }
}

GET /v1/sets

Listuj wszystkie zestawy kart z metadanymi. Używaj slugów zestawów do filtrowania kart.

Params: search, game (pokemon, pokemon-japanese), limit, cursor

{
  "data": [
    { "slug": "base-set", "name": "Base Set", "releaseDate": "1999-01-09", "cardCount": 102 },
    { "slug": "base-set-2", "name": "Base Set 2", "releaseDate": "2000-02-24", "cardCount": 130 }
  ],
  "pagination": { "hasMore": true, "nextCursor": "YmFzZS1zZXQtMg==", "count": 2 }
}

GET /v1/auth/info

Pobierz informacje o swoim kluczu API i statystyki użycia. Sprawdź pozostałe zapytania, czas resetu i szczegóły planu.

{
  "data": {
    "key": "pc_a1b2c3d4...",
    "name": "Production",
    "active": true,
    "createdAt": "2026-01-17T10:00:00Z",
    "lastUsedAt": "2026-01-17T12:30:00Z",
    "user": {
      "plan": "Free",
      "remaining": 208,
      "limit": 250,
      "resetsAt": "2026-01-18T00:00:00Z"
    }
  }
}

GET /v1/cards/:id/prices/:tier/history

Pobierz historyczne dane cenowe dla konkretnego poziomu. Przydatne do wykresów i analizy trendów.

Params: period (7d, 30d, 90d, 1y, all), limit, cursor

{
  "data": [
    { "date": "2026-01-27", "source": "ebay", "avg": 5200, "low": 4800, "high": 5600, "saleCount": 3 },
    { "date": "2026-01-26", "source": "ebay", "avg": 5150, "low": 4750, "high": 5500, "saleCount": 5 }
  ],
  "pagination": { "hasMore": true, "nextCursor": "MjAyNi0wMS0yNQ==", "count": 2 }
}

Jaka jest różnica między kartami US i EU?

Karty są specyficzne dla rynku. Karty US mają ceny TCGPlayer i eBay w USD. Karty EU mają ceny CardMarket w EUR z podziałem na kraje (DE, FR, IT itp.). Każda karta należy tylko do jednego rynku.

Które firmy gradingowe są wspierane?

Wspieramy 15 firm gradingowych włącznie z PSA, BGS, CGC, ACE, TAG i więcej. Ceny ocenionych kart są dostępne na planach Pro i Scale. Pole gradedOptions na każdej karcie pokazuje dostępne oceny.

Jak uzyskać aktualizacje cen w czasie rzeczywistym?

Połączenia WebSocket są dostępne na planie Scale. Połącz się z wss://api.poketrace.com/ws ze swoim kluczem API. Subskrybuj konkretne karty, by otrzymywać natychmiastowe aktualizacje cen gdy występują nowe sprzedaże.

Czy mogę używać API dla projektów komercyjnych?

Tak. Darmowy poziom pozwala na użycie niekomercyjne. Plany Pro i Scale obejmują licencje komercyjne. Sprawdź nasze warunki użytkowania dla pełnych szczegółów.

Jak dokładne są dane cenowe?

Ceny są oparte na zweryfikowanych zakończonych sprzedażach z TCGPlayer, eBay i CardMarket. Aktualizujemy co kilka godzin. Każdy poziom cenowy zawiera wskaźnik pewności (high, medium, low) i saleCount, byś mógł ocenić wiarygodność.