HobbyCardIndex Card Prices

API de Precios de Tarjetas HobbyCardIndex

Precios de tarjetas en cada grado, ID de tarjeta desde una foto, consultas de certificados e informes de población, para tu propio negocio o bajo una licencia comercial para tu aplicación.

Más de 16 millones de tarjetas en deportes y juegos de cartas coleccionables. ¿Nuevo aquí? Comienza con lo que cubre la API y luego la referencia a continuación.

¿Qué plan necesito?

Tu propio negocio

Valorar tu propio inventario, tus propias compras y ventas, herramientas internas e informes que solo usa tu equipo.

Plan Enterprise. Ver precios

Tus usuarios ven nuestros datos

Aplicaciones, sitios web, widgets y productos de pago que muestran nuestros precios, valoraciones o ventas a tus clientes.

Plan Comercial, comenzando con un mes de configuración gratuito. Inicia sesión para ver los planes comerciales

Primeros Pasos

Límites de Velocidad

Nivel Enterprise: 1 solicitud por segundo por clave, hasta 100,000 solicitudes al día (el conteo diario se restablece a la medianoche UTC)
Planes comerciales: 10, 20 o 50 consultas por segundo según el plan, con una asignación mensual de solicitudes, escaneos y consultas de ventas. El mes de configuración gratuito permite 10 consultas por segundo y 1,000 solicitudes al día. Los números de tu plan están en Configuración, luego Acceso a la API.

Encabezados de Límite de Velocidad:

• X-RateLimit-Remaining: solicitudes restantes en la ventana actual de un segundo
• X-RateLimit-Reset: cuándo se restablece esa ventana. También se envían los encabezados estándar RateLimit-*.

Formato de Datos de Precios

Todos los precios se devuelven en dólares estadounidenses (USD) con 2 decimales. Ejemplo: 12.50

Cada respuesta exitosa se envuelve como {"success": true, "data": {...}}. Los ejemplos a continuación muestran lo que está dentro de data.

Grados de tarjetas admitidos:

• loose: tarjeta cruda, sin calificar
• psa10, psa9, psa8: PSA 10, 9 y 8
• bgs10: BGS 9.5, o BGS 10 cuando no hay precio de 9.5. cgc10, sgc10: CGC 10 y SGC 10

Endpoints de la API

GET /api/v1/prices/search

Busca precios de tarjetas por nombre. Una búsqueda simple de q devuelve las 10 mejores coincidencias con todos los precios por grado. Las tarjetas base aparecen primero, luego las paralelas (el nombre de una paralela se muestra entre corchetes, por ejemplo Mike Trout [Gold] #US175), y las tarjetas más negociadas primero dentro de cada grupo. Agrega cualquier filtro a continuación para acotar la búsqueda o paginar a través de ella; las búsquedas filtradas devuelven 25 por página de forma predeterminada, con hasMore indicándote cuándo hay otra página. Para listar cada tarjeta en un conjunto, pasa category y set (un id de conjunto de GET /api/v1/sets) sin q. Pasa el id de un resultado a los endpoints de tarjetas y ventas a continuación. Todos los planes.

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
q	string	Sí, a menos que se proporcione set o added_since	Consulta de búsqueda (2 a 200 caracteres). Ejemplo: "Mike Trout 2011"
category	string	No	Una categoría de /market/categories, por ejemplo pokemon o baseball
set	string	No	Un id de conjunto de /sets, por ejemplo pokemon-scarlet-violet-151. Requiere category. Los resultados vienen en orden de número de tarjeta.
language	string	No	El idioma impreso en la tarjeta: english, japanese, chinese, korean, german, french, spanish, italian, portuguese, dutch, thai, indonesian, russian o polish
year	integer	No	Año de la tarjeta, por ejemplo 2023
added_since	date	No	Solo tarjetas agregadas a nuestro catálogo desde entonces (UTC): una fecha como 2026-10-01 o una hora como 2026-10-01T12:00:00Z. Los resultados vienen en el orden en que se agregaron, y el addedAt de cada resultado indica cuándo. Para una lista larga, establecer added_since al último addedAt que recibiste es más rápido que un offset grande.
min_price / max_price	number	No	Rango de precio crudo (sin calificar) en dólares estadounidenses
sort	string	No	price_asc, price_desc, volume_desc, name_asc, added_asc o added_desc (precio crudo, volumen de negociación, nombre o cuándo se agregó la tarjeta)
limit / offset	integer	No	Tamaño de página de 1 a 100 (predeterminado 25) y cuántas omitir. Una búsqueda de q pagina a través de sus mejores 2,000 coincidencias; un conjunto, o added_since sin q, pagina a través de cada tarjeta en él.

Ejemplo: cada tarjeta en inglés en un conjunto de Pokemon, 100 a la 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_...'

Ejemplo: tarjetas Pokemon en inglés agregadas desde el 1 de octubre

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_...'

Una búsqueda que coincide con demasiadas tarjetas para ordenar o filtrar por precio devuelve 400 SEARCH_TOO_BROAD; agrega una categoría, conjunto o año (o un added_since posterior).

Ejemplo de Solicitud (cURL)

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

Ejemplo de Solicitud (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));

Ejemplo de Solicitud (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())

Ejemplo de Respuesta

{ "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

Obtén información detallada de precios para una tarjeta específica en todos los grados y empresas de calificación.

Parámetros de Ruta

Parámetro	Tipo	Descripción
cardId	integer o string	El id de la tarjeta de resultados de búsqueda o escaneo. Para buscar una tarjeta por su externalId en su lugar, pon ext- delante, por ejemplo ext-67890.

Ejemplo de Solicitud (cURL)

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

Ejemplo de Respuesta

{ "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

Lista ventas verificadas para una tarjeta específica: registros de venta individuales con precio, fecha, grado y mercado, más estadísticas resumidas para el período. Planes Growth y Platform (el mes de configuración gratuito incluye 500 consultas para probar); otras claves reciben REQUIRES_COMMERCIAL_LICENSE. ¿Qué plan necesito?

Parámetros

Parámetro	Tipo	Descripción
cardId	integer o string	El id de la tarjeta de resultados de búsqueda o escaneo, o ext- más su externalId.
days	integer	Ventana de retroceso en días, 1–365. Predeterminado 90. Cada llamada devuelve las 100 ventas más recientes en la ventana y cuenta como una consulta de venta. ¿Necesitas más ventas por llamada? Eso está disponible bajo un acuerdo comercial por escrito: envía un correo a [email protected].

Ejemplo de Solicitud (cURL)

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

Ejemplo de Respuesta

{ "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

Busca una tarjeta calificada por su número de certificado: el registro de la empresa de calificación (grado, grado de autógrafo, jugador, año, conjunto, número de tarjeta, población cuando el calificador lo informa), la tarjeta correspondiente en nuestro catálogo, sus precios en cada grado y el precio en ese grado. El bloque slab también enlaza el certificado en el sitio propio de la empresa de calificación (verifyUrl: PSA, CGC y TGA abren el certificado en sí, Beckett y SGC abren su página de búsqueda, donde se ingresa el número) y lleva las fotos de la losa del calificador cuando el calificador las tiene (frontImageUrl, backImageUrl). Growth y Platform, con un número mensual de consultas de certificados (Growth 3,000, Platform 50,000, el mes de configuración gratuito 100; el complemento de población + certificado aumenta el número de Growth). Una consulta por segundo por clave.

Parámetros de Ruta

Parámetro	Tipo	Descripción
grader	string	psa, bgs, cgc o sgc
certNumber	string	El número de certificado en la etiqueta de la losa, por ejemplo 12345678

Ejemplo de Solicitud (cURL)

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

Ejemplo de Respuesta

{ "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

El precio diario de la tarjeta en cada grado a lo largo del tiempo, para gráficos. Planes Growth y Platform. ?days= de 1 a 3650, predeterminado 365. Las ventas individuales están en /sales.

Ejemplo de Respuesta

{ "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

Informe de población de la tarjeta: cuántas copias han calificado PSA, BGS, SGC y CGC, grado por grado, con recuentos de gemas y tasa de gemas. Platform, o Growth con el complemento de población + certificado. population es null cuando aún no tenemos un informe para esa tarjeta.

Ejemplo de Respuesta

{ "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

Cada conjunto en una categoría, con el id de conjunto que toman la búsqueda (set=) y la lista de seguimiento, el idioma impreso en sus tarjetas, su año y cuántas tarjetas tiene. Consulta: category (obligatorio), language, q (parte del nombre del conjunto), limit (hasta 5,000, predeterminado 1,000), offset. Todos los planes.

Ejemplo de Solicitud

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

Ejemplo de Respuesta

{ "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

Elige las tarjetas para las que quieres actualizaciones de precios. Growth (hasta 100,000 tarjetas) y Platform (hasta 500,000); el mes de configuración gratuito puede seguir 1,000. Envía {"cardIds": [12345, 67890]} (hasta 1,000 ids por llamada; una búsqueda id, o ext- más un externalId), o un conjunto completo: {"category": "pokemon", "set": "pokemon-scarlet-violet-151", "language": "english"}, o una categoría completa: {"category": "pokemon", "language": "english"}. Un conjunto o categoría agregado de esta manera permanece seguido: las tarjetas que agreguemos más tarde se unen a tu lista automáticamente y llegan en el webhook diario como cards.added. La respuesta indica cuántas se agregaron, cuántas ya estaban en la lista, cualquier id que no pudimos encontrar y tu total.

GET /api/v1/watchlist lista las tarjetas seguidas (limit hasta 5,000, offset) y los conjuntos que sigues (following). POST /api/v1/watchlist/remove con {"cardIds": [...]} quita tarjetas, {"category": "pokemon", "set": "pokemon-scarlet-violet-151", "language": "english"} quita las tarjetas de ese conjunto y deja de seguirlo (envía los mismos campos con los que lo agregaste), o {"all": true} limpia la lista. GET /api/v1/watchlist/prices descarga los precios actuales de cada carta vigilada en una sola llamada (JSON, o ?format=csv). Los precios cambian una vez al día, así que una vez al día es suficiente; como máximo una descarga por minuto.

PUT /api/v1/webhook

Recibe una llamada en tu propio servidor una vez al día con cada carta vigilada cuyo precio haya cambiado. Envía {"url": "https://your-server.example/hci-prices", "hour": 14}: una dirección https y la hora (UTC, de 0 a 23) a la que quieres que se envíe. La primera vez, la respuesta incluye tu secret de firma; solo se muestra entonces, así que guárdalo (envía "rotateSecret": true para obtener uno nuevo). Las entregas del webhook no cuentan para tus solicitudes.

Una vez al día a esa hora comparamos cada carta vigilada con los precios que te enviamos por última vez y hacemos un POST de los cambios, hasta 1,000 cartas por solicitud. Cada carta lista los grados que cambiaron con el precio anterior y el nuevo (null significa sin precio), además de sus precios actuales. Responde con cualquier 2xx. Si tu servidor no lo hace, reintentamos después de 5 minutos, 30 minutos, 2, 6 y 12 horas; después de 3 entregas fallidas, cada reintento pausa el webhook, y volver a configurar la URL lo reactiva. GET /api/v1/webhook muestra la URL, la hora y la última entrega; DELETE /api/v1/webhook lo detiene; POST /api/v1/webhook/test envía un ping firmado de inmediato.

Ejemplo 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" } ] } }

Verificación de la firma

HCI-Signature es t=<unix time>,v1=<hex>, donde el hex es el HMAC-SHA256 de <t>.<raw request body> con tu secreto. Calcúlalo sobre el cuerpo sin procesar y compáralo; rechaza los valores antiguos de t para evitar reproducciones. Los grados son loose (sin procesar), psa10, psa9, psa8, psa7, bgs10 (BGS 9.5), cgc10 y sgc10.

Cartas nuevas en las colecciones que sigues

Una colección o categoría completa añadida a la lista de seguimiento permanece seguida. Cada día, antes de los cambios de precios, cualquier carta que hayamos añadido desde el día anterior se agrega a tu lista y llega en su propio evento cards.added, hasta 1,000 cartas por solicitud, con la colección a la que se unió (following), sus precios si ya tiene alguno, y cuándo se añadió. Las cartas nuevas cuentan para tu límite de vigilancia; las que no caben se cuentan en notAdded. Sin webhook configurado, igualmente se unen a la 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

Recupera tu colección de portafolio con valores actuales y métricas de rendimiento.

Solicitud de ejemplo (cURL)

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

Respuesta de ejemplo

{ "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

Obtén los principales movimientos del mercado por categoría. Muestra las cartas con los precios de venta promedio más altos en el período reciente.

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
category	string	baseball	Categoría de carta: baseball, football, basketball, hockey, pokemon, etc.
period	integer	7	Días de historial para analizar (1-90)

Solicitud de ejemplo (cURL)

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

Respuesta de ejemplo

{ "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

Obtén estadísticas para todas las categorías de cartas. Útil para análisis de mercado y segmentación de portafolio.

Solicitud de ejemplo (cURL)

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

Respuesta de ejemplo

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

Úsalo desde un asistente de IA (MCP)

HobbyCardIndex ejecuta un servidor MCP, por lo que los asistentes de IA que hablan el Protocolo de Contexto de Modelo, como Claude Code y Cursor, pueden consultar precios de cartas con tu clave de API. Está listado en el Registro MCP oficial como com.hobbycardindex/card-prices.

URL del servidor: https://hobbycardindex.com/api/v1/mcp (HTTP transmisible). Envía tu clave como encabezado X-API-Key, o como Authorization: Bearer. Es la misma clave que la API REST, con el mismo plan y los mismos límites, y cada consulta cuenta para tu uso.

Herramientas:

• search_cards: encuentra una carta de la manera en que un coleccionista la describe (año, colección, jugador o personaje, número de carta). Hasta 5 coincidencias, cada una con su precio sin procesar y PSA 10, y un enlace a la página de la carta.
• get_card_prices: una carta en cada grado: sin procesar, PSA 7 a PSA 10, BGS 9.5, CGC 10 y 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_..." } } } }

En VS Code, la misma entrada va en .vscode/mcp.json bajo "servers", con "type": "http" añadido.

Sin una clave, un asistente puede conectarse y ver las dos herramientas, pero cada consulta responde con una nota para obtener una clave. Para obtener una, consulta qué plan necesito.

Manejo de errores

Todas las respuestas de error siguen una estructura JSON consistente:

{ "error": { "code": "ERROR_CODE", "message": "Descripción del error legible para humanos" } }

Códigos de error comunes

Código	Estado HTTP	Descripción
MISSING_API_KEY	401	Clave de API no proporcionada en el encabezado X-API-Key o en el encabezado Authorization
INVALID_API_KEY	401	La clave de API es inválida o está mal formada
KEY_REVOKED	401	La clave de API ha sido revocada
PLAN_REQUIRED	403	El plan Dealer o Enterprise de la cuenta ha terminado; la clave vuelve a funcionar una vez que el plan se renueva
REQUIRES_COMMERCIAL_LICENSE	403	El endpoint (registros individuales de ventas realizadas) solo está disponible bajo una Licencia de Datos Comercial. Consulta Uso de datos a continuación.
RATE_LIMITED	429	Más de 1 solicitud por segundo en una clave. Espera un segundo y reintenta.
RATE_LIMIT_EXCEEDED	429	La clave alcanzó su límite diario de 100,000 solicitudes. Se restablece a la medianoche UTC.
VALIDATION_ERROR	400	Falta un parámetro de consulta requerido o es inválido, por ejemplo q en search
NOT_FOUND	404	No hay ninguna carta con ese ID
SERVER_ERROR	500	Error interno del servidor. Inténtalo de nuevo más tarde.

Precios y niveles

Enterprise, para tu propio negocio

El acceso a la API para uso interno está incluido con el plan Enterprise, $49.99 al mes o $499.99 al año, que también incluye 30,000 escaneos de cartas al mes. Cada clave puede hacer 1 solicitud por segundo, hasta 100,000 solicitudes al día.

Incluido con Enterprise:

• Una clave de API por cuenta
• 1 solicitud por segundo, hasta 100,000 al día
• Acceso a todos los datos de precios (más de 16 millones de cartas)
• Movimientos del mercado y análisis de categorías
• Endpoints de API de portafolio
• Soporte prioritario
• Licenciado para tu propio uso interno (consulta Uso de datos a continuación)

¿No tienes Enterprise? Ver planes de precios →

Planes comerciales, para aplicaciones y sitios web

Si tus clientes o el público verán nuestros datos, necesitas un plan Comercial en su lugar. Una cuenta nueva puede comenzar con un mes de configuración gratuito para construir y probar con datos reales, y un pago de Enterprise ya realizado se descuenta de la primera factura comercial.

Inicia sesión para ver planes comerciales y comenzar un mes de configuración →

Uso de datos y licencia comercial

Lo que cubre tu plan Enterprise

Tu clave de API licencia los datos de HobbyCardIndex para uso interno de tu propio negocio: fijar precios de tu propio inventario, tus propias decisiones de compra y venta, informes internos y herramientas que solo usa tu equipo. Fijar tu propio precio en una carta usando nuestros datos cuenta como uso interno.

Lo que necesita una Licencia de Datos Comercial

• Mostrar nuestros precios, ventas realizadas o datos de mercado a tus clientes o al público: un sitio web, aplicación, mercado, widget, superposición de transmisión, pantalla de punto de venta o lista de precios impresa
• Revender, sublicenciar o redistribuir los datos, incluidas las respuestas de API y los archivos de precios masivos
• Construir o entrenar una guía de precios, base de datos o modelo de IA a partir de los datos que vendas u ofrezcas a otros
• Incluir los datos en un producto o servicio por el que cobres
• Compartir tu clave de API, exportaciones o archivos masivos con otra empresa
• Registros individuales de ventas realizadas de /prices/:cardId/sales: este endpoint solo se activa para planes comerciales que lo incluyan, una carta por llamada con un límite mensual. Ningún plan incluye una descarga masiva de ventas realizadas.

Cómo comenzar

Inicia sesión y abre Configuración, Acceso a API para ver los planes comerciales, comenzar un mes de configuración gratuito o comprar Starter o Growth por carta. ¿Preguntas o un acuerdo más grande en mente? Envía un correo a [email protected] con el asunto "Commercial Data License". Los planes comerciales piden un crédito a Hobby Card Index con un enlace, ya sea junto a los precios o en tu sitio web. Hasta que estés en uno, un plan Enterprise cubre solo uso interno.

Cuando tu plan termina

Deja de usar los datos y elimina las copias almacenadas, incluidas las respuestas de API en caché, los registros de ventas realizadas y los archivos masivos, dentro de 30 días.

Términos completos: Términos de servicio, sección 8.

Preguntas comunes

¿Existe una API para precios de cartas deportivas?

Sí. La API REST de HobbyCardIndex devuelve precios actuales por grado: sin procesar, PSA 10, 9 y 8, BGS 9.5, CGC 10 y SGC 10. También devuelve historial real de ventas realizadas y datos de mercado, para béisbol, fútbol americano, baloncesto, hockey, fútbol, Pokémon, Magic: The Gathering, Yu-Gi-Oh, One Piece y más de 25 categorías en total.

¿Cuánto cuesta la API de HobbyCardIndex?

Para uso interno de tu propio negocio, el acceso a la API está incluido con el plan Enterprise: $49.99 al mes o $499.99 al año, que también incluye 30,000 escaneos de cartas al mes, a 1 solicitud por segundo hasta 100,000 solicitudes al día. Las aplicaciones y sitios web que muestran nuestros datos a sus usuarios necesitan un plan Comercial, que comienza con un mes de configuración gratuito. Inicia sesión para ver planes comerciales.

¿Cuántas cartas cubre la API?

El catálogo contiene más de 16 millones de registros de cartas, con más de 22 millones de precios en todos los grados y más de 8 millones de imágenes de cartas.

¿Puedo identificar una carta desde una foto con la API?

La identificación por foto ejecuta nuestro propio escáner, que compara una foto de carta contra más de 8 millones de imágenes de cartas. Aún no está en la documentación pública de la API. Para usarlo en tu producto, envía un correo a [email protected].

¿Qué tan actualizados están los precios?

Los precios se basan en precios de venta reales, y el registro de precios de cada carta incluye la hora de su última actualización.

¿Puedo mostrar los precios de HobbyCardIndex en mi propio sitio web o aplicación?

Sí, con un plan Comercial. Una clave Enterprise licencia los datos para uso interno de tu propio negocio, como fijar precios de tu propio inventario. Mostrar nuestros precios a tus clientes o al público, o incorporarlos en un producto que ofrezcas a otros, necesita un plan Comercial, que comienza con un mes de configuración gratuito. Inicia sesión para ver planes comerciales, o lee uso de datos.

¿Cómo obtengo una clave de API?

Suscríbete al plan Enterprise y luego genera una clave en Configuración, en Acceso a la API. Cada cuenta tiene una clave activa, y generar una nueva reemplaza la anterior.

¿HobbyCardIndex tiene un servidor MCP?

Sí. Los asistentes de IA que hablan el Protocolo de Contexto de Modelo, como Claude Code y Cursor, pueden conectarse a https://hobbycardindex.com/api/v1/mcp y consultar precios de cartas con una clave de API de HobbyCardIndex, enviada como el encabezado X-API-Key. Tiene dos herramientas, search_cards y get_card_prices, y está listado en el Registro MCP oficial como com.hobbycardindex/card-prices. Cómo conectarse.