PokeTrace
←Voltar ao Blog
Recursos para Desenvolvedores/28 de janeiro de 2026/15 min de leitura

Guia do Desenvolvedor da API PokeTrace

A API PokeTrace fornece dados de preços em tempo real para mais de 60.000 cartas Pokemon.

Editor de código mostrando integração da API PokeTrace
Construa aplicações de cartas Pokemon com dados de preços reais

Acesse preços graduados PSA, BGS e CGC junto com valores raw.

01

Início Rápido

Comece em três passos: (1) Crie uma conta em poketrace.com/dashboard, (2) Gere uma chave API, (3) Adicione o header X-API-Key às suas requisições.

A URL base para todas as requisições é https://api.poketrace.com/v1.

Verifique o status da API em status.poketrace.com.

02

Autenticação

Todas as requisições requerem uma chave API passada no header X-API-Key.

Steps

  1. 1.Cadastre-se em poketrace.com/dashboard
  2. 2.Clique em 'Criar' para gerar uma nova chave API
  3. 3.Copie sua chave (formato: pc_xxxxxxxx)
  4. 4.Inclua X-API-Key: SUA_CHAVE nos headers
cURL
curl -H "X-API-Key: pc_sua_chave" https://api.poketrace.com/v1/cards
JavaScript
fetch('https://api.poketrace.com/v1/cards', {
  headers: { 'X-API-Key': 'pc_sua_chave' }
})
Python
Nunca commite chaves API em repositórios públicos.
03
Endpoints da API
A API fornece quatro endpoints principais.
GET /v1/cards
Lista cartas com paginação e filtros.
Params: limit (max 100), cursor, set, search, card_number, variant, market (US/EU), has_graded
GET /v1/cards?market=US&set=base-set&limit=20
Response:
{
  "data": [...],
  "pagination": { "hasMore": true, "nextCursor": "..." }
}
GET /v1/cards/:id
Obtém detalhes completos da carta com preços por fonte e tier.
GET /v1/cards/019bff77-befa-771d-bab0-f5909f0a78c9
Response:
{
  "data": { "id": "...", "name": "Charizard", "prices": {...} }
}
GET /v1/sets
Lista todas as coleções de cartas com metadados.
Params: search, game (pokemon, pokemon-japanese), limit, cursor
GET /v1/sets?search=base&limit=5
Response:
{
  "data": [...],
  "pagination": {...}
}
GET /v1/auth/info
Obtém info da chave API e estatísticas de uso.
GET /v1/auth/info
Response:
{
  "data": { "key": "pc_...", "user": { "plan": "Free", "remaining": 458 } }
}
GET /v1/cards/:id/prices/:tier/history
Obtém dados históricos de preço para um tier específico.
Params: period (7d, 30d, 90d, 1y, all), limit, cursor
GET /v1/cards/019bff77.../prices/PSA_10/history?period=30d
Response:
{
  "data": [...],
  "pagination": {...}
}
04
Limites de Requisições
Limites são aplicados por conta, não por chave.
Grátis
250 / day
Apenas US
Apenas condições raw
Pro
10.000 / day
US + EU
Raw + Graduadas (PSA, BGS, CGC)
Scale
100.000 / day
US + EU
Raw + Graduadas + WebSocket
Response Headers
  • X-RateLimit-Limit — Seu limite diário de requisições
  • X-RateLimit-Remaining — Requisições restantes hoje
  • X-RateLimit-Reset — Timestamp ISO8601 quando o limite reseta
  • X-Plan — Seu plano atual (Free, Pro, Scale)
Cache respostas agressivamente.
05
Exemplos Completos de Código
Copie e cole estes exemplos para começar.
JavaScript / Node.js
const API_KEY = process.env.POKETRACE_API_KEY;
// ... exemplo de código ...
Python
import os
import requests
# ... exemplo de código ...
cURL
# Obter uma carta única
curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.poketrace.com/v1/cards/..."
06
Tratamento de Erros
A API usa códigos de status HTTP padrão.
400
Bad Request
Parâmetros inválidos
{ "error": "Parâmetro limit inválido" }
401
Unauthorized
Chave API ausente ou inválida
{ "error": "Chave API necessária" }
403
Forbidden
Upgrade de plano necessário
{ "error": "Plano Pro necessário" }
404
Not Found
Recurso não existe
{ "error": "Carta não encontrada" }
429
Rate Limited
Muitas requisições
{ "error": "Limite de requisições excedido" }
Para erros 429, use o campo retryAfter. Implemente backoff exponencial.
07
Perguntas Frequentes
Qual a diferença entre cartas US e EU?
Cartas são específicas de mercado. Cartas US têm preços TCGPlayer e eBay em USD. Cartas EU têm preços CardMarket em EUR.
Quais empresas de graduação são suportadas?
Suportamos 15 empresas de graduação incluindo PSA, BGS, CGC, ACE, TAG e mais.
Como obtenho atualizações de preço em tempo real?
Conexões WebSocket estão disponíveis no plano Scale.
Posso usar a API para projetos comerciais?
Sim. Plano gratuito permite uso não-comercial. Planos Pro e Scale incluem licenças comerciais.
Quão precisos são os dados de preços?
Preços são baseados em vendas verificadas do TCGPlayer, eBay e CardMarket.
Comece a Construir Hoje
Obtenha sua chave API gratuita e comece a construir aplicações de cartas Pokemon.
Obter Chave API Gratuita→