Guide Développeur API PokeTrace

GET /v1/cards

Liste les cartes avec pagination et filtres. Retourne les informations basiques des cartes sans prix complets.

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

Obtient les détails complets d'une carte avec les prix par source et niveau. Les cartes US incluent ebay (tous niveaux) + tcgplayer (brut uniquement). Les cartes EU incluent cardmarket (tendance des prix avec moyennes historiques) + cardmarket_unsold (annonces actives avec répartition par niveau/pays).

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

// Carte 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

Liste tous les sets de cartes avec métadonnées. Utilisez les slugs de set pour filtrer les cartes.

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

Obtient les informations de votre clé API et les statistiques d'utilisation. Vérifiez les requêtes restantes, l'heure de réinitialisation et les détails du plan.

{
  "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

Obtient les données historiques de prix pour un niveau spécifique. Utile pour les graphiques et l'analyse des tendances.

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

Quelle est la différence entre les cartes US et EU ?

Les cartes sont spécifiques au marché. Les cartes US ont les prix TCGPlayer et eBay en USD. Les cartes EU ont les prix CardMarket en EUR avec répartition par pays (DE, FR, IT, etc.). Chaque carte appartient à un seul marché.

Quelles sociétés de gradation sont supportées ?

Nous supportons 15 sociétés de gradation incluant PSA, BGS, CGC, ACE, TAG, et plus. Les prix gradés sont disponibles sur les plans Pro et Scale. Le champ gradedOptions sur chaque carte indique les grades disponibles.

Comment obtenir des mises à jour de prix en temps réel ?

Les connexions WebSocket sont disponibles sur le plan Scale. Connectez-vous à wss://api.poketrace.com/ws avec votre clé API. Abonnez-vous à des cartes spécifiques pour recevoir des mises à jour de prix instantanées lors de nouvelles ventes.

Puis-je utiliser l'API pour des projets commerciaux ?

Oui. L'offre gratuite permet une utilisation non-commerciale. Les plans Pro et Scale incluent des licences commerciales. Consultez nos conditions d'utilisation pour tous les détails.

Quelle est la précision des données de prix ?

Les prix sont basés sur des ventes complétées vérifiées de TCGPlayer, eBay et CardMarket. Nous mettons à jour toutes les quelques heures. Chaque niveau de prix inclut un score de confiance (élevé, moyen, faible) et un saleCount pour évaluer la fiabilité.