API para busca de cartões

Você precisa lançar uma funcionalidade de busca e precificação de cartões voltada para finanças esta semana—pense em busca enquanto digita para cartões esportivos, além de preços de vendas recentes que você pode chartar e usar para avaliação. Ao final deste post, você será capaz de buscar cartões colecionáveis e puxar preços em série temporal usando endpoints prontos para produção do Zyla API Hub, integrá-los à sua lógica de precificação ou portfólio, e até mesmo chamá-los de um agente de IA via MCP.

O que esta API entrega para fluxos de trabalho financeiros

A API de Cartões Esportivos e Cartões Colecionáveis retorna metadados de cartões pesquisáveis e dados de preços em série temporal. Desenvolvedores que constroem aplicativos de estilo financeiro para ativos alternativos—rastreador de portfólio, alertas de preço, painéis de avaliação ou análises—usam para:

• Resolver busca em texto livre (“Lebron topps chrome rc psa 10”) em identificadores limpos, incluindo um card_id estável e metadados do conjunto.
• Consultar preços recentes por cartão e grau para alimentar gráficos, pontuação de risco e cálculos de marcação a mercado.

Todas as chamadas são realizadas no Zyla API Hub, que fornece uma conta, uma chave de API e um modelo de assinatura + cota em mais de 10.000 APIs públicas. Para esta API, você pode iniciar um teste de 7 dias a partir da página do marketplace, e depois continuar sob assinatura e cota (sem pagamento por chamada).

Começando no Zyla API Hub

1. Abra a página do marketplace da API e inicie o teste: Iniciar teste de 7 dias na API de Cartões Esportivos e Cartões Colecionáveis.
2. Clique em Assinar ou Iniciar Teste Gratuito (quando disponível) para obter sua chave de API.
3. Envie solicitações com o cabeçalho Authorization: Bearer YOUR_API_KEY para os endpoints abaixo.

Se você é novo no Zyla, também pode navegar por categorias e gerenciar assinaturas em zylalabs.com. A assinatura utiliza cotas, não pagamento por chamada. Para opções de acesso e preços atuais, verifique a página da API.

Endpoint: Busca de Cartões

Busque cartões colecionáveis com correspondência difusa e receba uma lista JSON de candidatos mais metadados. Este é seu resolvedor de uma consulta em texto livre do usuário para um card_id canônico que você pode usar para buscas de preços.

• Método: GET
• URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
• Parâmetro de consulta:
  • search (string, obrigatório): Lebron James

Solicitação cURL

curl -s -X GET "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search?search=Lebron+James" \
-H "Authorization: Bearer YOUR_API_KEY"

Exemplo JSON oficial

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

Campos-chave que você usará em contextos financeiros:

• card_id: identificador estável para buscar preços e juntar em seu datastore.
• description, set, number, variant: rotulagem canônica para linhas de portfólio e relatórios de avaliação.
• image: renderizar uma miniatura ao lado de gráficos de preços e posições.

Exemplo em Python: buscar, escolher um cartão e preparar para precificação

import requests

API_KEY = "YOUR_API_KEY"
q = "Lebron James"

resp = requests.get(
"https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search",
params={"search": q},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
resp.raise_for_status()
cards = resp.json()

# Escolha um candidato com conjunto/número claro, mantenha seu card_id para precificação
for c in cards:
print(f"{c.get('description')} | #{c.get('number')} | id={c.get('card_id')}")
# Exemplo de seleção a jusante:
target = next((c for c in cards if c.get('card_id') == "1586412050491x786559417729941500"), None)
if target:
print("Selecionado:", target["description"], "->", target["card_id"])

Endpoint: Obter Preços de Cartões

Puxe pontos de preço recentes para um cartão e grau específicos. Use o card_id da Busca de Cartões para consultar. O resultado é uma série temporal adequada para gráficos, médias móveis, detecção de tendências e pipelines de avaliação de portfólio.

• Método: GET
• URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
• Parâmetros de consulta:
  • card_id (string, obrigatório): 1586412050491x786559417729941500
  • days (string, obrigatório): 90
  • grade (string, obrigatório): PSA 10

Solicitação cURL

Exemplo JSON

[
{
"closing_date": "2026-08-03T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "16150.00"
},
{
"closing_date": "2026-08-01T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "18250.00"
},
{
"closing_date": "2026-07-31T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17900.00"
},
{
"closing_date": "2026-07-27T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17303.00"
},
{
"closing_date": "2026-07-21T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17373.00"
},
{
"closing_date": "2026-07-17T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "15337.20"
},
{
"closing_date": "2026-07-15T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",…

Notas para implementações financeiras:

• closing_date é um timestamp ISO 8601 com sufixo Z (UTC). Alinhe sua chartagem e invalidação de cache em UTC para evitar problemas de um dia de diferença.
• price é um valor numérico em formato string. Analise para tipo decimal/número apropriado para sua pilha para evitar erros de arredondamento de ponto flutuante.
• Grade é uma string como “PSA 10”; use-a para rotulagem e para impor regras de avaliação específicas de grau.

Compor: da busca à série de preços

Fluxo típico:

1. Chame a Busca de Cartões com a entrada do usuário.
2. Deixe o usuário confirmar o cartão exato (conjunto, número, variante).
3. Use o card_id retornado com Obter Preços de Cartões para o grau desejado e janela de retrocesso.
4. Calcule métricas: médias de 7/30/90 dias, aproximações de volatilidade, quedas e mudanças percentuais.

Detalhes de integração prática que economizam tempo

• Autorização: passe Authorization: Bearer YOUR_API_KEY em cada solicitação.
• Cache: para endpoints de preço, uma janela de cache curta por card_id e grau (por exemplo, horária) é tipicamente suficiente para painéis enquanto reduz o uso de cotas.
• Fusos horários: trate closing_date como UTC. Normalize todos os cálculos a jusante para UTC antes de agrupar por dia/semana.
• UX de busca: emita a Busca de Cartões na mudança de entrada com um pequeno debounce (por exemplo, 200–300ms). Persista o card_id selecionado em suas posições.
• Tratamento de erros: apresente “sem resultados” de forma elegante; permita que usuários avançados refinem consultas adicionando conjunto, ano e número do cartão à string de busca.

Exemplo: construir um widget de avaliação de cartões

Abaixo está um fluxo mínimo, em duas etapas, que você pode integrar em um painel financeiro:

1. Busque “Lebron James” e liste candidatos com descrição, conjunto, número e card_id.
2. Quando o usuário selecionar o “2003 Topps Chrome Basketball #111” card_id 1586412050491x786559417729941500 e escolher o grau “PSA 10”, busque uma série de preços de 90 dias e plote-a. Persista o preço mais recente como a avaliação da sua posição.

Como a API retorna identificadores limpos e timestamps, você pode calcular médias móveis e P/L usando seus caminhos de código de portfólio existentes.

Chamando a API de agentes de IA via MCP

Se você preferir orquestrar as buscas e chamadas de preço de um agente de IA (por exemplo, Claude Code, Cursor, Windsurf), você pode direcioná-las através do endpoint MCP da Zyla. Aponte seu cliente compatível com MCP para:

MCP

Use sua chave de API Zyla e faça o agente invocar os dois endpoints HTTPS mostrados acima com o mesmo cabeçalho de Autorização e parâmetros de consulta. Isso permite que os agentes resolvam um card_id e busquem séries de preços dentro de uma única sequência de chamadas de ferramenta.

Casos de uso focados em finanças que você pode lançar esta semana

• Portfólio de marcação a mercado: armazene card_id e grau por posição; atualize via Obter Preços de Cartões e calcule P/L não realizado.
• Alertas de preço: acione notificações quando o preço mais recente cruzar um limite ou desviar X% de uma média móvel.
• Cartões de avaliação em listas de observação: busque uma vez, fixe o card_id e renderize preços atuais e anteriores ao lado de azulejos semelhantes a tickers.
• Painéis de risco: derive volatilidade móvel da série temporal para pontuação de risco específica de grau em ativos alternativos.

Solução de problemas e validação

• Busca vazia ou barulhenta: enriqueça a string de busca com ano, conjunto ou número do cartão para apertar correspondências difusas.
• Múltiplas variantes: apresente a variante e o tipo de conjunto em sua interface para que os usuários escolham o correto antes da precificação.
• Decimais: analise o preço como Decimal/BigNumber para evitar desvios de arredondamento nos totais do portfólio.
• Cadeia de atualização de dados: se você capturar NAVs diários, agrupe por closing_date (UTC) para manter barras diárias consistentes.

Onde gerenciar acesso e cotas

Todo acesso é provisionado através do Zyla API Hub sob um modelo de assinatura + cota (sem pagamento por chamada). O acesso pela primeira vez geralmente começa com um teste de 7 dias ou 50 solicitações. Para disponibilidade e detalhes exatos, use a página do item da API. Você pode visualizar e gerenciar suas assinaturas em categorias em zylalabs.com.

FAQ

Qual cabeçalho eu uso para autenticação?
Use Authorization: Bearer YOUR_API_KEY em cada solicitação.

Como eu obtenho preços para um cartão específico?
Primeiro resolva o cartão com a Busca de Cartões para obter card_id, depois chame Obter Preços de Cartões com card_id, days e grade.

Em que fuso horário estão os timestamps?
Os valores de closing_date estão em UTC (sufixo Z ISO 8601). Normalize suas análises para UTC para evitar problemas de limite.

Posso chartar preços diretamente da resposta?
Sim. Itere sobre o array, analise o preço para um tipo numérico e plote por closing_date em ordem crescente.

Há um plano gratuito?
O acesso é baseado em assinatura + cota. Verifique a página da API para opções de acesso atuais e preços; você pode iniciar um teste de 7 dias a partir da página do item.

Pronto para adicionar busca de cartões e precificação ao seu aplicativo financeiro? Inicie o teste, obtenha sua chave e implemente a integração hoje: API de Cartões Esportivos e Cartões Colecionáveis.

Resposta oficial da API

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

Resposta oficial da API

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…