Guía del Desarrollador de la API de PokeTrace

GET /v1/cards

Lista cartas con paginación y filtros. Devuelve información básica de cartas sin precios completos.

Params: limit (máx 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

Obtén detalles completos de la carta con precios por fuente y nivel. Las cartas de EE.UU. incluyen ebay (todos los niveles) + tcgplayer (solo raw). Las cartas de EU incluyen cardmarket (tendencia de precios con promedios históricos) + cardmarket_unsold (listados activos con desglose por nivel/país).

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

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

Lista todos los sets de cartas con metadatos. Usa los slugs de sets para filtrar cartas.

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

Obtén información de tu clave API y estadísticas de uso. Consulta peticiones restantes, tiempo de reinicio y detalles del 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

Obtén datos históricos de precios para un nivel específico. Útil para gráficos y análisis de tendencias.

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

¿Cuál es la diferencia entre cartas de EE.UU. y EU?

Las cartas son específicas por mercado. Las cartas de EE.UU. tienen precios de TCGPlayer y eBay en USD. Las cartas de EU tienen precios de CardMarket en EUR con desgloses por país (DE, FR, IT, etc.). Cada carta pertenece a un solo mercado.

¿Qué empresas de graduación están soportadas?

Soportamos 15 empresas de graduación incluyendo PSA, BGS, CGC, ACE, TAG y más. Los precios de cartas graduadas están disponibles en los planes Pro y Scale. El campo gradedOptions en cada carta muestra los grados disponibles.

¿Cómo obtengo actualizaciones de precios en tiempo real?

Las conexiones WebSocket están disponibles en el plan Scale. Conéctate a wss://api.poketrace.com/ws con tu clave API. Suscríbete a cartas específicas para recibir actualizaciones instantáneas de precios cuando ocurran nuevas ventas.

¿Puedo usar la API para proyectos comerciales?

Sí. El nivel gratuito permite uso no comercial. Los planes Pro y Scale incluyen licencias comerciales. Consulta nuestros términos de servicio para más detalles.

¿Qué tan precisos son los datos de precios?

Los precios se basan en ventas completadas verificadas de TCGPlayer, eBay y CardMarket. Actualizamos cada pocas horas. Cada nivel de precio incluye una puntuación de confianza (high, medium, low) y saleCount para que puedas evaluar la fiabilidad.