Você precisa de acesso confiável e programável ao histórico de preços de cartas de negociação para que possa avaliar um portfólio, executar P&L ou acionar alertas de compra/venda esta semana. Ao final deste guia, você buscará uma carta específica e puxará seus preços de venda graduados recentes—pronto para ser inserido em seus fluxos de trabalho financeiros, painéis e trabalhos automatizados.
O que esta API entrega
A API de Cartas Esportivas e Cartas de Negociação expõe duas capacidades principais que importam para o trabalho financeiro e de precificação:
- Pesquisa de Cartas: pesquisa rápida e difusa para resolver uma consulta humana em uma identidade de carta específica e obter um card_id mais metadados básicos.
- Obter Preços de Cartas: dados de preços em série temporal para um dado card_id e grau ao longo de uma janela de retrocesso solicitada (em dias).
Você usará a Pesquisa de Cartas para mapear uma consulta como “LeBron James Topps Chrome 2003” para um card_id exato, depois Obter Preços de Cartas para buscar a série temporal de vendas recentes para um grau específico (por exemplo, PSA 10). O resultado é um pipeline leve, mas pronto para finanças que você pode conectar à avaliação, instantâneas de NAV, alertas e relatórios.
Começando no Zyla API Hub
Abra a página da API, inscreva-se e obtenha sua chave. O Zyla API Hub centraliza mais de 10.000 APIs públicas com uma conta, uma chave de API e um modelo de assinatura + cota (não pago por chamada). Para esta API, você pode começar com um teste de 7 dias ou 50 solicitações—verifique a listagem para opções de acesso e preços atuais.
Comece o teste de 7 dias na API de Cartas Esportivas e Cartas de Negociação
Autenticação: envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
Endpoints que você usará
1) Pesquisa de Cartas
Método: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
Propósito: Resolver uma consulta de texto livre em uma ou mais cartas correspondentes, cada uma com um card_id e metadados que você precisará para solicitar preços.
Parâmetro de consulta obrigatório:
- search (string): sua consulta de texto livre, por exemplo, Lebron James
Exemplo oficial de 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 oficial de resposta JSON:
[
{
"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:
- description, player, set, number, variant: identidade legível por humanos para UI e logs.
- card_id: o identificador que você deve usar com Obter Preços de Cartas.
- image: caminho relativo para uma imagem da carta.
2) Obter Preços de Cartas
Método: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
Propósito: Recuperar uma série temporal de preços recentes para uma carta e grau específicos ao longo de uma janela solicitada.
Parâmetros de consulta obrigatórios:
- card_id (string): por exemplo, 1586412050491x786559417729941500
- days (string): período de retrocesso (por exemplo, 90)
- grade (string): rótulo de classificação (por exemplo, PSA 10)
Exemplo oficial de cURL:
Exemplo oficial de resposta 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",…Campos que você realmente usará:
- closing_date: timestamps UTC ISO 8601 marcando os horários de fechamento de preços (o sufixo Z indica UTC).
- price: uma string representando o valor do preço de venda. A moeda não é especificada na resposta—armazenar e apresentar de acordo.
- Grade: o rótulo de classificação da série de preços que você solicitou.
- card_id: ecoa a carta que você consultou; útil para junções e pipelines de múltiplas cartas.
Copie e cole Python: busque preços e calcule uma métrica rápida
O trecho abaixo solicita uma série de 90 dias para um card_id específico na classificação PSA 10 e calcula um preço final simples e uma média. Você pode adaptar a agregação para NAVs, quedas ou limites de risco.
import os
import requests
from decimal import Decimal
from statistics import mean
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices"
params = {
"card_id": "1586412050491x786559417729941500",
"days": "90",
"grade": "PSA 10",
}
headers = {
"Authorization": f"Bearer {API_KEY}",
}
resp = requests.get(url, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json() # array of { closing_date, Grade, card_id, price }
# Parse price strings into Decimal for finance-safe arithmetic
prices = [Decimal(entry["price"]) for entry in data]
dates = [entry["closing_date"] for entry in data]
last_price = prices[0] if prices else None # most recent appears first in the sample
avg_price = (mean(prices) if prices else None)
print("observações:", len(prices))
print("data_mais_recente:", dates[0] if dates else None)
print("preco_mais_recente:", str(last_price) if last_price is not None else None)
print("preco_medio_retrocesso:", str(Decimal(avg_price)) if avg_price is not None else None)Fluxos de trabalho financeiros que você pode enviar esta semana
- Avaliação de portfólio: Armazene uma lista de vigilância de pares card_id + grau; execute um trabalho diário para puxar o preço mais recente e calcular NAV e P&L. Mantenha tudo em UTC, uma vez que os timestamps closing_date são UTC.
- Monitoramento de risco e exposição: Defina limites em médias móveis ou máxima queda ao longo de uma janela de retrocesso (por exemplo, 30–90 dias) e alerte quando violados.
- Roteamento de pedidos e faixas de preço: Para marketplaces que exigem verificações pré-negociação, compare o pedido de entrada a uma média móvel ou a impressão mais recente para rejeitar outliers.
- Relatórios de desempenho: Capture preços de fim de semana e produza retornos ponderados pelo tempo para sleeves de ativos alternativos que incluem cartas de negociação.
Notas de implementação que economizam tempo
- Autenticação: Cada solicitação deve incluir Authorization: Bearer YOUR_API_KEY.
- Fuso horário: os valores closing_date são UTC (note o Z). Faça toda a matemática de data em UTC para evitar problemas de um ao redor dos limites da meia-noite.
- Ordenação: Se você confiar em “mais recente primeiro”, verifique a ordenação do seu lado. Persista visualizações ordenadas por data antes de calcular métricas móveis.
- Análise: Trate o preço como uma string e converta para Decimal (ou o tipo decimal exato da sua linguagem) antes da aritmética para evitar deriva de ponto flutuante.
- Cache: Para painéis, considere armazenar em cache a última resposta para um card_id/grau/dias tupla para evitar chamadas redundantes dentro do mesmo intervalo de atualização.
- Cotas: A Zyla usa assinatura + cota. Para integração inicial, você pode começar com um teste de 7 dias ou 50 solicitações; verifique a listagem para detalhes, pois podem mudar.
Passo a passo: resolva uma carta e busque seus preços
1) Resolva a carta
Use a Pesquisa de Cartas com uma string de consulta específica que inclua jogador, conjunto, ano e variante quando possível. Da resposta, escolha a correspondência pretendida e copie seu card_id.
2) Puxe séries temporais graduadas
Chame Obter Preços de Cartas com o card_id escolhido, sua janela de dias desejada e o grau (por exemplo, PSA 10). Armazene a série em seu armazenamento de dados e realize análises a montante.
Usando a API de agentes de IA via MCP
Se você preferir orquestrar chamadas através de um agente de IA que fala o Protocolo de Contexto do Modelo (MCP), aponte seu cliente para o endpoint MCP e forneça sua chave de API. Consulte a documentação aqui: MCP. Com o MCP configurado, seu agente pode chamar os mesmos endpoints de marketplace mostrados acima, usando o mesmo cabeçalho de Autorização e caminhos de URL.
Exemplo de ponta a ponta em cURL
A maneira mais rápida de validar seu pipeline é copiar essas duas chamadas:
- Pesquise pela carta (substitua YOUR_API_KEY):
- Da resposta, escolha um card_id (por exemplo, 1586412050491x786559417729941500), depois busque seus preços:
Onde isso se encaixa em uma pilha financeira
Cartas de negociação são uma crescente sleeve de ativos alternativos para colecionadores, fundos e marketplaces. A combinação de Pesquisa de Cartas e Obter Preços de Cartas permite que você:
- Normalize identidades usando card_id para que você possa deduplicar listas de vigilância e participações.
- Construa uma série de preços limpa por grau para calcular retornos, volatilidade móvel e z-scores.
- Alimente ferramentas de portfólio, sistemas contábeis e verificações de risco com impressões estruturadas e com timestamp.
Como a API retorna timestamps ISO 8601 e preços em string, você pode armazenar valores brutos como estão, e depois analisar de forma determinística ao calcular métricas.
Inscreva-se e envie
Para integrar agora, inscreva-se na página do item do marketplace, obtenha sua chave e execute o cURL acima. O Zyla API Hub mantém todas as suas APIs sob uma chave e assinatura, para que você não precise gerenciar várias contas de fornecedores. Comece aqui: Comece o teste de 7 dias na API de Cartas Esportivas e Cartas de Negociação
FAQ
Como eu encontro o card_id correto?
Use o endpoint de Pesquisa de Cartas com uma consulta detalhada, depois selecione o item pretendido da resposta e copie seu card_id. Alimente isso em Obter Preços de Cartas.
Qual fuso horário são os timestamps closing_date?
Eles são ISO 8601 com um sufixo Z, que indica UTC. Realize a matemática de data em UTC para evitar problemas de limite.
Em que moeda estão os preços?
A resposta inclui um campo de preço como um valor string. A moeda não é especificada na resposta; trate a apresentação de forma consistente em seu aplicativo.
Há um plano gratuito?
O acesso segue um modelo de assinatura + cota (não pago por chamada). A listagem oferece um teste de 7 dias ou 50 solicitações para começar; verifique a página da API para opções de acesso e preços atuais.
Posso chamar esses endpoints através de um agente de IA?
Sim. Configure seu cliente compatível com MCP para usar o endpoint MCP e inclua sua chave de API. Veja: MCP.
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",…
