PokeTrace API Entwickler-Anleitung

GET /v1/cards

Karten mit Paginierung und Filtern auflisten. Gibt grundlegende Karteninfos ohne vollständige Preise zurück.

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

Vollständige Kartendetails mit Preisen nach Quelle und Stufe abrufen. US-Karten beinhalten ebay (alle Stufen) + tcgplayer (nur roh). EU-Karten beinhalten cardmarket (Preistrend mit historischen Durchschnitten) + cardmarket_unsold (aktive Angebote mit Stufen-/Länderaufschlüsselung).

// US-Karte
{
  "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 }
      }
    }
  }
}

// EU-Karte
{
  "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

Alle Karten-Sets mit Metadaten auflisten. Verwenden Sie Set-Slugs zum Filtern von Karten.

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

Ihre API-Schlüssel-Informationen und Nutzungsstatistiken abrufen. Prüfen Sie verbleibende Anfragen, Reset-Zeit und Plan-Details.

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

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

Historische Preisdaten für eine bestimmte Stufe abrufen. Nützlich für Diagramme und Trendanalysen.

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 }
}

Was ist der Unterschied zwischen US- und EU-Karten?

Karten sind marktspezifisch. US-Karten haben TCGPlayer- und eBay-Preise in USD. EU-Karten haben CardMarket-Preise in EUR mit Aufschlüsselung nach Ländern (DE, FR, IT, etc.). Jede Karte gehört nur zu einem Markt.

Welche Bewertungsunternehmen werden unterstützt?

Wir unterstützen 15 Bewertungsunternehmen, darunter PSA, BGS, CGC, ACE, TAG und mehr. Bewertete Preise sind in Pro- und Scale-Plänen verfügbar. Das gradedOptions-Feld bei jeder Karte zeigt verfügbare Bewertungen.

Wie bekomme ich Echtzeit-Preis-Updates?

WebSocket-Verbindungen sind im Scale-Plan verfügbar. Verbinden Sie sich mit wss://api.poketrace.com/ws mit Ihrem API-Schlüssel. Abonnieren Sie bestimmte Karten, um sofortige Preis-Updates zu erhalten, wenn neue Verkäufe stattfinden.

Kann ich die API für kommerzielle Projekte nutzen?

Ja. Die kostenlose Stufe erlaubt nicht-kommerzielle Nutzung. Pro- und Scale-Pläne beinhalten kommerzielle Lizenzen. Lesen Sie unsere Nutzungsbedingungen für vollständige Details.

Wie genau sind die Preisdaten?

Preise basieren auf verifizierten abgeschlossenen Verkäufen von TCGPlayer, eBay und CardMarket. Wir aktualisieren alle paar Stunden. Jede Preisstufe enthält einen Konfidenzwert (high, medium, low) und saleCount, damit Sie die Zuverlässigkeit einschätzen können.