Necesitas acceso confiable y programable a la historia de precios de cartas coleccionables para poder valorar un portafolio, ejecutar P&L o activar alertas de compra/venta esta semana. Al final de esta guía, buscarás una carta específica y obtendrás sus precios de venta recientes con calificación, listos para integrarse en tus flujos de trabajo financieros, paneles de control y trabajos automatizados.
Lo que esta API ofrece
La API de Cartas Deportivas y Cartas Coleccionables expone dos capacidades centrales que son importantes para el trabajo financiero y de precios:
- Búsqueda de Cartas: búsqueda difusa rápida para resolver una consulta humana en una identidad de carta específica y obtener un card_id más metadatos básicos.
- Obtener Precios de Cartas: datos de precios en serie temporal para un card_id y grado dados durante una ventana de retroceso solicitada (en días).
Utilizarás la Búsqueda de Cartas para mapear una consulta como “LeBron James Topps Chrome 2003” a un card_id exacto, luego Obtener Precios de Cartas para obtener la serie temporal de ventas recientes para un grado específico (por ejemplo, PSA 10). El resultado es un pipeline ligero pero listo para finanzas que puedes integrar en valoración, instantáneas de NAV, alertas e informes.
Comenzando en Zyla API Hub
Abre la página de la API, suscríbete y obtén tu clave. Zyla API Hub centraliza más de 10,000 APIs públicas con una cuenta, una clave API y un modelo de suscripción + cuota (no es por llamada). Para esta API, puedes comenzar con una prueba de 7 días o 50 solicitudes; consulta la lista para las opciones de acceso y precios actuales.
Comienza la prueba de 7 días en la API de Cartas Deportivas y Cartas Coleccionables
Autenticación: envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
Puntos finales que utilizarás
1) Búsqueda de Cartas
Método: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
Propósito: Resolver una consulta de texto libre a una o más cartas coincidentes, cada una con un card_id y metadatos que necesitarás para solicitar precios.
Parámetro de consulta requerido:
- search (string): tu consulta de texto libre, por ejemplo, Lebron James
Ejemplo 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"Ejemplo de respuesta 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 clave:
- description, player, set, number, variant: identidad legible por humanos para UI y registros.
- card_id: el identificador que debes usar con Obtener Precios de Cartas.
- image: ruta relativa a una imagen de la carta.
2) Obtener Precios de Cartas
Método: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
Propósito: Recuperar una serie temporal de precios recientes para una carta y grado específicos durante una ventana solicitada.
Parámetros de consulta requeridos:
- card_id (string): por ejemplo, 1586412050491x786559417729941500
- days (string): período de retroceso (por ejemplo, 90)
- grade (string): etiqueta de calificación (por ejemplo, PSA 10)
Ejemplo oficial de cURL:
Ejemplo de respuesta JSON oficial:
[
{
"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 realmente utilizarás:
- closing_date: marcas de tiempo ISO 8601 UTC que indican los tiempos de cierre de precios (el sufijo Z indica UTC).
- price: una cadena que representa el monto del precio de venta. La moneda no se especifica en la respuesta; almacénalo y preséntalo de acuerdo a ello.
- Grade: la etiqueta de calificación de la serie de precios que solicitaste.
- card_id: repite la carta que consultaste; útil para uniones y pipelines de múltiples cartas.
Copia y pega Python: obtener precios y calcular una métrica rápida
El fragmento a continuación solicita una serie de 90 días para un card_id específico en grado PSA 10 y calcula un precio final simple y un promedio. Puedes adaptar la agregación para NAVs, caídas o límites de riesgo.
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("observations:", len(prices))
print("most_recent_date:", dates[0] if dates else None)
print("most_recent_price:", str(last_price) if last_price is not None else None)
print("average_price_lookback:", str(Decimal(avg_price)) if avg_price is not None else None)Flujos de trabajo financieros que puedes implementar esta semana
- Valoración de portafolios: Almacena una lista de seguimiento de pares de card_id + grado; ejecuta un trabajo diario para obtener el último precio y calcular NAV y P&L. Mantén todo en UTC ya que las marcas de tiempo de closing_date son UTC.
- Monitoreo de riesgo y exposición: Establece umbrales en promedios móviles o máxima caída durante una ventana de retroceso (por ejemplo, 30–90 días) y alerta cuando se superen.
- Enrutamiento de órdenes y bandas de precios: Para los mercados que requieren verificaciones previas a la negociación, compara la oferta entrante con un promedio móvil o la impresión más reciente para rechazar valores atípicos.
- Informes de rendimiento: Captura los precios de fin de semana y produce retornos ponderados por tiempo para las carteras de activos alternativos que incluyen cartas coleccionables.
Notas de implementación que ahorran tiempo
- Autenticación: Cada solicitud debe incluir Authorization: Bearer YOUR_API_KEY.
- Zona horaria: los valores de closing_date son UTC (nota el sufijo Z). Realiza todas las operaciones de fecha en UTC para evitar problemas de límite alrededor de la medianoche.
- Ordenamiento: Si dependes de “más reciente primero”, verifica el orden en tu lado. Persiste vistas ordenadas por fecha antes de calcular métricas móviles.
- Análisis: Trata el precio como una cadena y conviértelo a Decimal (o el tipo decimal exacto de tu lenguaje) antes de realizar operaciones aritméticas para evitar desviaciones de punto flotante.
- Cacheo: Para paneles de control, considera almacenar en caché la última respuesta para una tupla de card_id/grado/días para evitar llamadas redundantes dentro del mismo intervalo de actualización.
- Cuotas: Zyla utiliza suscripción + cuota. Para la integración inicial, puedes comenzar con una prueba de 7 días o 50 solicitudes; consulta la lista para detalles específicos ya que pueden cambiar.
Paso a paso: resolver una carta y obtener sus precios
1) Resolver la carta
Utiliza la Búsqueda de Cartas con una cadena de consulta específica que incluya jugador, set, año y variante cuando sea posible. Desde la respuesta, selecciona la coincidencia deseada y copia su card_id.
2) Obtener series temporales calificadas
Invoca Obtener Precios de Cartas con el card_id elegido, tu ventana de días deseada y el grado (por ejemplo, PSA 10). Almacena la serie en tu almacén de datos y realiza análisis posteriores.
Usando la API desde agentes de IA a través de MCP
Si prefieres orquestar llamadas a través de un agente de IA que hable el Protocolo de Contexto del Modelo (MCP), apunta tu cliente al punto final de MCP y proporciona tu clave API. Consulta la documentación aquí: MCP. Con MCP configurado, tu agente puede llamar a los mismos puntos finales de mercado mostrados arriba, utilizando el mismo encabezado de Autorización y rutas URL.
Ejemplo de extremo a extremo en cURL
La forma más rápida de validar tu pipeline es copiar estas dos llamadas:
- Buscar la carta (reemplaza YOUR_API_KEY):
- Desde la respuesta, elige un card_id (por ejemplo, 1586412050491x786559417729941500), luego obtén sus precios:
Dónde encaja esto en un stack financiero
Las cartas coleccionables son una creciente cartera de activos alternativos para coleccionistas, fondos y mercados. La combinación de Búsqueda de Cartas y Obtener Precios de Cartas te permite:
- Normalizar identidades usando card_id para que puedas eliminar duplicados en listas de seguimiento y tenencias.
- Construir una serie de precios limpia por grado para calcular retornos, volatilidad móvil y puntuaciones z.
- Alimentar herramientas de portafolio, sistemas contables y verificaciones de riesgo con impresiones estructuradas y con marcas de tiempo.
Debido a que la API devuelve marcas de tiempo ISO 8601 y precios en forma de cadena, puedes almacenar valores en bruto tal como están, y luego analizarlos de manera determinista al calcular métricas.
Suscríbete y envía
Para integrar ahora, suscríbete en la página del artículo del mercado, obtén tu clave y ejecuta el cURL anterior. Zyla API Hub mantiene todas tus APIs bajo una clave y suscripción, por lo que no tienes que gestionar múltiples cuentas de proveedores. Comienza aquí: Comienza la prueba de 7 días en la API de Cartas Deportivas y Cartas Coleccionables
FAQ
¿Cómo encuentro el card_id correcto?
Utiliza el punto final de Búsqueda de Cartas con una consulta detallada, luego selecciona el elemento deseado de la respuesta y copia su card_id. Aliméntalo en Obtener Precios de Cartas.
¿Qué zona horaria tienen las marcas de tiempo de closing_date?
Son ISO 8601 con un sufijo Z, que indica UTC. Realiza operaciones de fecha en UTC para evitar problemas de límite.
¿En qué moneda están los precios?
La respuesta incluye un campo de precio como un monto en cadena. La moneda no se especifica en la respuesta; maneja la presentación de manera consistente en tu aplicación.
¿Hay un plan gratuito?
El acceso sigue un modelo de suscripción + cuota (no es por llamada). La lista ofrece una prueba de 7 días o 50 solicitudes para comenzar; consulta la página de la API para las opciones de acceso y precios actuales.
¿Puedo llamar a estos puntos finales a través de un agente de IA?
Sí. Configura tu cliente compatible con MCP para usar el punto final de MCP e incluye tu clave API. Ver: MCP.
Respuesta oficial de la 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",…Respuesta oficial de la 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",…
