HobbyCardIndex Card Prices

API de Preços de Cartas HobbyCardIndex

Preços de cartas em todas as graduações, ID de carta a partir de uma foto, consultas de certificado e relatórios de população, para o seu próprio negócio ou sob licença comercial para o seu aplicativo.

Mais de 16 milhões de cartas entre esportes e jogos de cartas colecionáveis. Novo aqui? Comece com o que a API cobre e depois a referência abaixo.

Qual plano eu preciso?

Seu próprio negócio

Precificar seu próprio inventário, suas próprias compras e vendas, ferramentas internas e relatórios usados apenas pela sua equipe.

Plano Enterprise. Ver preços

Seus usuários veem nossos dados

Aplicativos, sites, widgets e produtos pagos que mostram nossos preços, avaliações ou vendas aos seus clientes.

Plano Comercial, começando com um mês de configuração gratuito. Entre para ver os planos comerciais

Começando

Limites de Taxa

Nível Enterprise: 1 requisição por segundo por chave, até 100.000 requisições por dia (a contagem diária é redefinida à meia-noite UTC)
Planos comerciais: 10, 20 ou 50 consultas por segundo dependendo do plano, com uma cota mensal de requisições, digitalizações e consultas de vendas. O mês de configuração gratuito permite 10 consultas por segundo e 1.000 requisições por dia. Os números do seu plano estão em Configurações, depois Acesso à API.

Cabeçalhos de Limite de Taxa:

• X-RateLimit-Remaining: requisições restantes na janela atual de um segundo
• X-RateLimit-Reset: quando essa janela é redefinida. Os cabeçalhos padrão RateLimit-* também são enviados.

Formato dos Dados de Preços

Todos os preços são retornados em dólares americanos (USD) com 2 casas decimais. Exemplo: 12.50

Toda resposta bem-sucedida é encapsulada como {"success": true, "data": {...}}. Os exemplos abaixo mostram o que está dentro de data.

Graduações de cartas suportadas:

• loose: carta crua, sem graduação
• psa10, psa9, psa8: PSA 10, 9 e 8
• bgs10: BGS 9,5, ou BGS 10 quando não houver preço de 9,5. cgc10, sgc10: CGC 10 e SGC 10

Endpoints da API

GET /api/v1/prices/search

Pesquise preços de cartas por nome. Uma pesquisa simples q retorna as 10 melhores correspondências com todos os preços por graduação. Cartas base vêm primeiro, depois paralelas (o nome de uma paralela aparece entre colchetes, por exemplo Mike Trout [Gold] #US175), e as cartas mais negociadas primeiro dentro de cada grupo. Adicione qualquer filtro abaixo para restringir a pesquisa ou paginar por ela; pesquisas filtradas retornam 25 por página por padrão, com hasMore informando quando há outra página. Para listar todas as cartas de um conjunto, passe category e set (um id de conjunto de GET /api/v1/sets) sem q. Passe o id de um resultado para os endpoints de carta e vendas abaixo. Todos os planos.

Parâmetros de Consulta

Parâmetro	Tipo	Obrigatório	Descrição
q	string	Sim, a menos que set ou added_since seja fornecido	Consulta de pesquisa (2 a 200 caracteres). Exemplo: "Mike Trout 2011"
category	string	Não	Uma categoria de /market/categories, por exemplo pokemon ou baseball
set	string	Não	Um id de conjunto de /sets, por exemplo pokemon-scarlet-violet-151. Requer category. Os resultados vêm em ordem de número da carta.
language	string	Não	O idioma impresso na carta: english, japanese, chinese, korean, german, french, spanish, italian, portuguese, dutch, thai, indonesian, russian ou polish
year	integer	Não	Ano da carta, por exemplo 2023
added_since	date	Não	Apenas cartas adicionadas ao nosso catálogo desde então (UTC): uma data como 2026-10-01 ou um horário como 2026-10-01T12:00:00Z. Os resultados vêm na ordem em que foram adicionados, e o addedAt de cada resultado informa quando. Para uma lista longa, definir added_since como o último addedAt que você recebeu é mais rápido do que um offset grande.
min_price / max_price	number	Não	Faixa de preço cru (sem graduação) em dólares americanos
sort	string	Não	price_asc, price_desc, volume_desc, name_asc, added_asc ou added_desc (preço cru, volume de negociação, nome ou quando a carta foi adicionada)
limit / offset	integer	Não	Tamanho da página de 1 a 100 (padrão 25) e quantos pular. Uma pesquisa q pagina pelas suas 2.000 melhores correspondências; um conjunto, ou added_since sem q, pagina por todas as cartas nele.

Exemplo: todas as cartas em inglês de um conjunto Pokemon, 100 por vez

curl 'https://hobbycardindex.com/api/v1/prices/search?category=pokemon&set=pokemon-scarlet-violet-151&limit=100&offset=0' -H 'X-API-Key: hci_live_...'

Exemplo: cartas Pokemon em inglês adicionadas desde 1º de outubro

curl 'https://hobbycardindex.com/api/v1/prices/search?category=pokemon&language=english&added\_since=2026-10-01&limit=100&offset=0' -H 'X-API-Key: hci_live_...'

Uma pesquisa que corresponde a muitas cartas para ordenar ou filtrar por preço retorna 400 SEARCH_TOO_BROAD; adicione uma categoria, conjunto ou ano (ou um added_since posterior).

Exemplo de Requisição (cURL)

curl 'https://hobbycardindex.com/api/v1/prices/search?q=Mike%20Trout%202011' \ -H 'X-API-Key: hci_live_...'

Exemplo de Requisição (JavaScript)

fetch('https://hobbycardindex.com/api/v1/prices/search?q=Mike%20Trout%202011', { headers: { 'X-API-Key': 'hci_live_...' } }).then(r => r.json()).then(d => console.log(d));

Exemplo de Requisição (Python)

import requests response = requests.get( 'https://hobbycardindex.com/api/v1/prices/search?q=Mike%20Trout', headers={'X-API-Key': 'hci_live_...'} ) print(response.json())

Exemplo de Resposta

{ "results": [ { "id": 12345, "externalId": "67890", "name": "2011 Topps Mike Trout RC #175", "year": 2011, "setName": "Topps", "category": "Baseball", "playerName": "Mike Trout", "prices": { "loose": 4500.00, "psa10": 15000.00, "psa9": 8500.00, "psa8": 4200.00, "bgs10": 12000.00, "cgc10": null, "sgc10": null } } ], "count": 1 }

GET /api/v1/prices/:cardId

Obtenha informações detalhadas de preço para uma carta específica em todas as graduações e empresas de graduação.

Parâmetros de Caminho

Parâmetro	Tipo	Descrição
cardId	integer ou string	O id da carta a partir de resultados de pesquisa ou digitalização. Para consultar uma carta pelo seu externalId em vez disso, coloque ext- na frente dele, por exemplo ext-67890.

Exemplo de Requisição (cURL)

curl 'https://hobbycardindex.com/api/v1/prices/12345' \ -H 'X-API-Key: hci_live_...'

Exemplo de Resposta

{ "card": { "id": 12345, "externalId": "67890", "name": "2011 Topps Mike Trout RC #175", "year": 2011, "setName": "Topps", "category": "Baseball", "playerName": "Mike Trout", "imageUrl": "https://..." }, "prices": { "loose": 4500.00, "psa10": 15000.00, "psa9": 8500.00, "psa8": 4200.00, "bgs10": 12000.00, "cgc10": null, "sgc10": null, "volume": 34, "updated": "2026-03-20T12:00:00Z" } }

GET /api/v1/prices/:cardId/sales

Liste vendas confirmadas para uma carta específica: registros individuais de venda com preço, data, graduação e marketplace, além de estatísticas resumidas para o período. Planos Growth e Platform (o mês de configuração gratuito inclui 500 consultas para testar); outras chaves recebem REQUIRES_COMMERCIAL_LICENSE. Qual plano eu preciso?

Parâmetros

Parâmetro	Tipo	Descrição
cardId	integer ou string	O id da carta a partir de resultados de pesquisa ou digitalização, ou ext- mais seu externalId.
days	integer	Janela de retrospectiva em dias, 1–365. Padrão 90. Cada chamada retorna as 100 vendas mais recentes na janela e conta como uma consulta de venda. Precisa de mais vendas por chamada? Isso está disponível em um acordo comercial escrito: envie e-mail para [email protected].

Exemplo de Requisição (cURL)

curl 'https://hobbycardindex.com/api/v1/prices/12345/sales?days=90' \ -H 'X-API-Key: hci_live_...'

Exemplo de Resposta

{ "card": { "id": 12345, "name": "2011 Topps Mike Trout RC #175", "playerName": "Mike Trout" }, "periodDays": 90, "summary": { "count": 14, "average": 2350.75, "low": 1900.00, "high": 2800.00 }, "sales": [ { "soldAt": "2026-06-28T17:04:00Z", "price": 2500.00, "grade": "PSA 10", "gradingCompany": "PSA", "title": "2011 Topps Update Mike Trout RC #US175 PSA 10", "auction": true, "source": "ebay" } ] }

GET /api/v1/certs/:grader/:certNumber

Consulte uma carta graduada pelo seu número de certificado: o registro da empresa de graduação (graduação, graduação de autógrafo, jogador, ano, conjunto, número da carta, população quando a graduadora a reporta), a carta correspondente em nosso catálogo, seus preços em todas as graduações e o preço naquela graduação. O bloco slab também vincula o certificado no site da própria empresa de graduação (verifyUrl: PSA, CGC e TGA abrem o próprio certificado, Beckett e SGC abrem sua página de consulta, onde o número é inserido) e carrega as fotos do slab da graduadora quando ela as possui (frontImageUrl, backImageUrl). Growth e Platform, com um número mensal de consultas de certificado (Growth 3.000, Platform 50.000, o mês de configuração gratuito 100; o complemento pop + cert aumenta o número do Growth). Uma consulta por segundo por chave.

Parâmetros de Caminho

Parâmetro	Tipo	Descrição
grader	string	psa, bgs, cgc ou sgc
certNumber	string	O número do certificado no rótulo do slab, por exemplo 12345678

Exemplo de Requisição (cURL)

curl 'https://hobbycardindex.com/api/v1/certs/psa/12345678' \ -H 'X-API-Key: hci_live_...'

Exemplo de Resposta

{ "cert": { "grader": "PSA", "certNumber": "12345678", "grade": "10", "player": "Mike Trout", "year": "2011", "cardNumber": "US175" }, "card": { "id": 12345, "name": "Mike Trout #US175", "prices": { "loose": 293.00, "psa10": 4500.00 } }, "slab": { "grader": "PSA", "grade": 10, "certVerified": true, "priceAtGrade": 4500.00, "verifyUrl": "https://www.psacard.com/cert/12345678", "frontImageUrl": "https://...", "backImageUrl": "https://..." } }

GET /api/v1/prices/:cardId/history

O preço diário da carta em todas as graduações ao longo do tempo, para gráficos. Planos Growth e Platform. ?days= de 1 a 3650, padrão 365. Vendas individuais estão em /sales.

Exemplo de Resposta

{ "card": { "id": 12345, "name": "Mike Trout #US175" }, "days": 365, "history": [ { "date": "2026-10-13", "loose": 293.00, "psa10": 4500.00, "psa9": 1250.00, "volume": 1400 } ] }

GET /api/v1/prices/:cardId/population

Relatório de população da carta: quantas cópias PSA, BGS, SGC e CGC graduaram, graduação por graduação, com contagens de gem e taxa de gem. Platform, ou Growth com o complemento pop + cert. population é null quando ainda não temos um relatório para essa carta.

Exemplo de Resposta

{ "card": { "id": 12345, "name": "Mike Trout #US175" }, "population": { "totalPopulation": 41000, "totalGems": 9800, "graders": { "PSA": { "totalGraded": 35000, "gems": 8200, "gemRate": 23.4 } } } }

GET /api/v1/sets

Todos os conjuntos em uma categoria, com o id do conjunto que a pesquisa (set=) e a lista de observação usam, o idioma impresso nas cartas, o ano e quantas cartas tem. Consulta: category (obrigatório), language, q (parte do nome do conjunto), limit (até 5.000, padrão 1.000), offset. Todos os planos.

Exemplo de Requisição

curl 'https://hobbycardindex.com/api/v1/sets?category=pokemon&language=english&q=151' -H 'X-API-Key: hci_live_...'

Exemplo de Resposta

{ "category": "pokemon", "language": "english", "total": 1, "sets": [ { "id": "pokemon-scarlet-violet-151", "name": "Pokemon Scarlet & Violet 151", "language": "english", "year": 2023, "cards": 409 } ] }

POST /api/v1/watchlist

Escolha as cartas para as quais você quer atualizações de preço. Growth (até 100.000 cartas) e Platform (até 500.000); o mês de configuração gratuito pode observar 1.000. Envie {"cardIds": [12345, 67890]} (até 1.000 ids por chamada; uma pesquisa id, ou ext- mais um externalId), ou um conjunto inteiro: {"category": "pokemon", "set": "pokemon-scarlet-violet-151", "language": "english"}, ou uma categoria inteira: {"category": "pokemon", "language": "english"}. Um conjunto ou categoria adicionado dessa forma permanece seguido: cartas que adicionarmos a ele depois entram na sua lista automaticamente e vêm no webhook diário como cards.added. A resposta informa quantas foram adicionadas, quantas já estavam na lista, quaisquer ids que não encontramos e seu total.

GET /api/v1/watchlist lista as cartas observadas (limit até 5.000, offset) e os conjuntos que você segue (following). POST /api/v1/watchlist/remove com {"cardIds": [...]} remove cartas, {"category": "pokemon", "set": "pokemon-scarlet-violet-151", "language": "english"} remove as cartas daquele conjunto e para de segui-lo (envie os mesmos campos com os quais você o adicionou), ou {"all": true} limpa a lista. GET /api/v1/watchlist/prices baixa os preços atuais de cada carta monitorada em uma única chamada (JSON, ou ?format=csv). Os preços mudam uma vez por dia, então uma vez por dia é suficiente; no máximo um download por minuto.

PUT /api/v1/webhook

Receba uma chamada no seu próprio servidor uma vez por dia com todas as cartas monitoradas cujo preço mudou. Envie {"url": "https://your-server.example/hci-prices", "hour": 14}: um endereço https e a hora (UTC, 0 a 23) em que deseja recebê-la. Na primeira vez, a resposta inclui seu secret de assinatura; ele só é exibido nesse momento, então salve-o (envie "rotateSecret": true para gerar um novo). As entregas do webhook não contam contra suas solicitações.

Uma vez por dia, nesse horário, comparamos cada carta monitorada com os preços que enviamos a você por último e fazemos o POST das alterações, até 1.000 cartas por solicitação. Cada carta lista as graduações que mudaram com o preço anterior e o novo (null significa sem preço), além dos preços atuais. Responda com qualquer 2xx. Se o seu servidor não responder, tentamos novamente após 5 minutos, 30 minutos, 2, 6 e 12 horas; após 3 entregas falharem, cada nova tentativa pausa o webhook, e definir a URL novamente o reativa. GET /api/v1/webhook mostra a URL, a hora e a última entrega; DELETE /api/v1/webhook interrompe; POST /api/v1/webhook/test envia um ping assinado imediatamente.

Exemplo de entrega

POST https://your-server.example/hci-prices HCI-Event-Type: prices.changed HCI-Signature: t=1792065604,v1=5f2c... { "id": "evt_8c1f...", "type": "prices.changed", "created": "2026-10-16T14:07:12Z", "data": { "day": "2026-10-16", "cards": [ { "id": 12345, "name": "Charizard ex #199", "setName": "Pokemon Scarlet & Violet 151", "cardNumber": "199", "changes": [ { "grade": "psa10", "previous": 410.00, "price": 435.00 } ], "prices": { "loose": 92.50, "psa10": 435.00, "psa9": 140.00 }, "updated": "2026-10-16T09:12:44Z" } ] } }

Verificando a assinatura

HCI-Signature é t=<unix time>,v1=<hex>, onde o hex é o HMAC-SHA256 de <t>.<raw request body> com seu segredo. Calcule-o sobre o corpo bruto e compare; rejeite valores antigos de t para impedir repetições. As graduações são loose (cru), psa10, psa9, psa8, psa7, bgs10 (BGS 9.5), cgc10 e sgc10.

Novas cartas nos conjuntos que você segue

Um conjunto ou categoria inteiro adicionado à lista de monitoramento permanece seguido. Todos os dias, antes das mudanças de preço, qualquer carta que adicionamos desde o dia anterior entra na sua lista e chega em seu próprio evento cards.added, até 1.000 cartas por solicitação, com o conjunto ao qual foi adicionada (following), seus preços, se já tiver, e quando foi adicionada. Novas cartas contam para o seu limite de monitoramento; as que não couberem são contadas em notAdded. Sem webhook configurado, elas ainda entram na lista.

HCI-Event-Type: cards.added { "id": "evt_41d0...", "type": "cards.added", "created": "2026-10-20T14:07:03Z", "data": { "day": "2026-10-20", "following": { "category": "pokemon", "set": "pokemon-scarlet-violet-151", "language": "english" }, "cards": [ { "id": 12345, "name": "Charizard ex #199", "setName": "Pokemon Scarlet & Violet 151", "setId": "pokemon-scarlet-violet-151", "cardNumber": "199", "language": "english", "prices": { "loose": 92.50, "psa10": 435.00 }, "addedAt": "2026-10-19T14:02:11Z" } ] } }

GET /api/v1/collection

Recupere sua coleção de portfólio com valores atuais e métricas de desempenho.

Exemplo de solicitação (cURL)

curl 'https://hobbycardindex.com/api/v1/collection' \ -H 'X-API-Key: hci_live_...'

Exemplo de resposta

{ "items": [ { "id": 1, "cardId": 12345, "name": "2011 Topps Mike Trout RC #175", "grade": "PSA 9", "quantity": 1, "purchasePrice": 1200.00, "notes": "Great condition", "addedAt": "2025-06-15T10:30:00Z" } ], "total": 1 }

GET /api/v1/market/movers

Obtenha os principais movimentadores de mercado por categoria. Mostra as cartas com os maiores preços médios de venda no período recente.

Parâmetros de consulta

Parâmetro	Tipo	Padrão	Descrição
category	string	baseball	Categoria da carta: baseball, football, basketball, hockey, pokemon, etc.
period	integer	7	Dias de histórico para analisar (1-90)

Exemplo de solicitação (cURL)

curl 'https://hobbycardindex.com/api/v1/market/movers?category=baseball&period=7' \ -H 'X-API-Key: hci_live_...'

Exemplo de resposta

{ "movers": [ { "id": 54321, "name": "1989 Upper Deck Ken Griffey Jr RC", "playerName": "Ken Griffey Jr", "category": "Baseball", "recentSales": 12, "averagePrice": 2300.00, "period": "7 days" } ], "period": "7 days", "category": "baseball" }

GET /api/v1/market/categories

Obtenha estatísticas para todas as categorias de cartas. Útil para análise de mercado e segmentação de portfólio.

Exemplo de solicitação (cURL)

curl 'https://hobbycardindex.com/api/v1/market/categories' \ -H 'X-API-Key: hci_live_...'

Exemplo de resposta

{ "categories": [ { "category": "Baseball", "cardCount": 2100000, "averagePriceLoose": 45.50, "averagePricePsa10": 320.75, "lastSaleAt": "2026-03-20T14:32:00Z" } ], "total": 8 }

Use com um assistente de IA (MCP)

O HobbyCardIndex executa um servidor MCP, para que assistentes de IA que falam o Model Context Protocol, como Claude Code e Cursor, possam consultar preços de cartas com sua chave de API. Ele está listado no Registro MCP oficial como com.hobbycardindex/card-prices.

URL do servidor: https://hobbycardindex.com/api/v1/mcp (Streamable HTTP). Envie sua chave como cabeçalho X-API-Key, ou como Authorization: Bearer. É a mesma chave da API REST, com o mesmo plano e os mesmos limites, e cada consulta conta para seu uso.

Ferramentas:

• search_cards: encontra uma carta da forma como um colecionador a descreve (ano, conjunto, jogador ou personagem, número da carta). Até 5 correspondências, cada uma com seu preço cru e PSA 10 e um link para a página da carta.
• get_card_prices: uma carta em todas as graduações: cru, PSA 7 a PSA 10, BGS 9.5, CGC 10 e SGC 10.

Claude Code

claude mcp add --transport http hobbycardindex https://hobbycardindex.com/api/v1/mcp --header "X-API-Key: hci_live_..."

Cursor (.cursor/mcp.json)

{ "mcpServers": { "hobbycardindex": { "url": "https://hobbycardindex.com/api/v1/mcp", "headers": { "X-API-Key": "hci_live_..." } } } }

No VS Code, a mesma entrada vai em .vscode/mcp.json sob "servers", com "type": "http" adicionado.

Sem uma chave, um assistente pode se conectar e ver as duas ferramentas, mas toda consulta responde com uma nota para obter uma chave. Para obter uma, veja qual plano eu preciso.

Tratamento de erros

Todas as respostas de erro seguem uma estrutura JSON consistente:

{ "error": { "code": "ERROR_CODE", "message": "Descrição do erro legível por humanos" } }

Códigos de erro comuns

Código	Status HTTP	Descrição
MISSING_API_KEY	401	Chave de API não fornecida no cabeçalho X-API-Key ou no cabeçalho Authorization
INVALID_API_KEY	401	Chave de API inválida ou malformada
KEY_REVOKED	401	Chave de API foi revogada
PLAN_REQUIRED	403	O plano Dealer ou Enterprise da conta terminou; a chave volta a funcionar quando o plano é renovado
REQUIRES_COMMERCIAL_LICENSE	403	O endpoint (registros individuais de vendas realizadas) está disponível apenas sob uma Licença de Dados Comerciais. Veja Uso de dados abaixo.
RATE_LIMITED	429	Mais de 1 solicitação por segundo em uma chave. Aguarde um segundo e tente novamente.
RATE_LIMIT_EXCEEDED	429	A chave atingiu seu limite diário de 100.000 solicitações. Reinicia à meia-noite UTC.
VALIDATION_ERROR	400	Um parâmetro de consulta obrigatório está ausente ou inválido, por exemplo q em search
NOT_FOUND	404	Nenhuma carta com esse ID
SERVER_ERROR	500	Erro interno do servidor. Tente novamente mais tarde.

Preços e níveis

Enterprise, para seu próprio negócio

O acesso à API para uso interno está incluído no plano Enterprise, US$ 49,99 por mês ou US$ 499,99 por ano, que também inclui 30.000 digitalizações de cartas por mês. Cada chave pode fazer 1 solicitação por segundo, até 100.000 solicitações por dia.

Incluído no Enterprise:

• Uma chave de API por conta
• 1 solicitação por segundo, até 100.000 por dia
• Acesso a todos os dados de preços (mais de 16 milhões de cartas)
• Movimentadores de mercado e análises de categoria
• Endpoints de API de portfólio
• Suporte prioritário
• Licenciado para seu próprio uso interno (veja Uso de dados abaixo)

Não tem Enterprise? Ver planos de preços →

Planos comerciais, para aplicativos e sites

Se seus clientes ou o público verão nossos dados, você precisa de um plano Comercial. Uma nova conta pode começar com um mês de configuração gratuito para construir e testar com dados reais, e um pagamento Enterprise já feito é descontado da primeira fatura comercial.

Entre para ver planos comerciais e iniciar um mês de configuração →

Uso de dados e licença comercial

O que seu plano Enterprise cobre

Sua chave de API licencia os dados do HobbyCardIndex para uso interno do seu próprio negócio: precificar seu próprio estoque, suas próprias decisões de compra e venda, relatórios internos e ferramentas usadas apenas pela sua equipe. Definir seu próprio preço em uma carta usando nossos dados conta como uso interno.

O que precisa de uma Licença de Dados Comerciais

• Mostrar nossos preços, vendas realizadas ou dados de mercado aos seus clientes ou ao público: um site, aplicativo, marketplace, widget, overlay de transmissão, tela de ponto de venda ou lista de preços impressa
• Revender, sublicenciar ou redistribuir os dados, incluindo respostas de API e arquivos de preços em massa
• Construir ou treinar um guia de preços, banco de dados ou modelo de IA a partir dos dados que você vende ou oferece a outros
• Incluir os dados em um produto ou serviço pelo qual você cobra
• Compartilhar sua chave de API, exportações ou arquivos em massa com outra empresa
• Registros individuais de vendas realizadas de /prices/:cardId/sales: este endpoint só é ativado para planos comerciais que o incluem, uma carta por chamada com um limite mensal. Nenhum plano inclui download em massa de vendas realizadas.

Como começar

Entre e abra Configurações, Acesso à API para ver os planos comerciais, iniciar um mês de configuração gratuito ou comprar Starter ou Growth por carta. Perguntas ou um acordo maior em mente? Envie um e-mail para [email protected] com o assunto "Commercial Data License". Os planos comerciais pedem um crédito ao Hobby Card Index com um link, seja ao lado dos preços ou no seu site. Até você estar em um, um plano Enterprise cobre apenas uso interno.

Quando seu plano termina

Pare de usar os dados e exclua cópias armazenadas, incluindo respostas de API em cache, registros de vendas realizadas e arquivos em massa, dentro de 30 dias.

Termos completos: Termos de Serviço, seção 8.

Perguntas frequentes

Existe uma API para preços de cartas esportivas?

Sim. A API REST do HobbyCardIndex retorna preços atuais por graduação: cru, PSA 10, 9 e 8, BGS 9.5, CGC 10 e SGC 10. Ela também retorna histórico real de vendas realizadas e dados de mercado, para baseball, football, basketball, hockey, futebol, Pokémon, Magic: The Gathering, Yu-Gi-Oh, One Piece e mais de 25 categorias no total.

Quanto custa a API do HobbyCardIndex?

Para uso interno do seu próprio negócio, o acesso à API está incluído no plano Enterprise: US$ 49,99 por mês ou US$ 499,99 por ano, que também inclui 30.000 digitalizações de cartas por mês, a 1 solicitação por segundo até 100.000 solicitações por dia. Aplicativos e sites que mostram nossos dados aos seus usuários precisam de um plano Comercial, que começa com um mês de configuração gratuito. Entre para ver planos comerciais.

Quantas cartas a API cobre?

O catálogo contém mais de 16 milhões de registros de cartas, com mais de 22 milhões de preços entre graduações e mais de 8 milhões de imagens de cartas.

Posso identificar uma carta a partir de uma foto com a API?

A identificação por foto usa nosso próprio scanner, que compara uma foto de carta com mais de 8 milhões de imagens de cartas. Ela ainda não está na documentação pública da API. Para usá-la em seu produto, envie um e-mail para [email protected].

Quão atuais são os preços?

Os preços são baseados em preços reais de venda, e o registro de preços de cada carta inclui o horário da última atualização.

Posso mostrar os preços do HobbyCardIndex no meu próprio site ou aplicativo?

Sim, com um plano Comercial. Uma chave Enterprise licencia os dados para uso interno do seu próprio negócio, como precificar seu próprio estoque. Mostrar nossos preços aos seus clientes ou ao público, ou incorporá-los em um produto que você oferece a outros, precisa de um plano Comercial, que começa com um mês de configuração gratuito. Entre para ver planos comerciais, ou leia uso de dados.

Como obtenho uma chave de API?

Assine o plano Enterprise e, em seguida, gere uma chave em Configurações, na seção Acesso à API. Cada conta possui uma chave ativa, e gerar uma nova substitui a anterior.

O HobbyCardIndex possui um servidor MCP?

Sim. Assistentes de IA que falam o Model Context Protocol, como Claude Code e Cursor, podem se conectar ao https://hobbycardindex.com/api/v1/mcp e consultar preços de cartas com uma chave de API do HobbyCardIndex, enviada como cabeçalho X-API-Key. Ele possui duas ferramentas, search_cards e get_card_prices, e está listado no Registro MCP oficial como com.hobbycardindex/card-prices. Como conectar.