Elige tu ruta de acceso
El acceso oficial de Pinnacle y una suscripción de datos de cuotas de terceros son acuerdos distintos. La página actual de la API de Pinnacle ofrece solicitudes a medida para casos de uso empresariales, individuales y académicos, sujetas a aprobación y elegibilidad. Si necesitas una relación contractual oficial u operaciones específicas de cuenta, empieza por la propia vía de solicitud de Pinnacle. Una suscripción de terceros no es una cuenta de Pinnacle ni una garantía de acceso oficial. Revisado el 26 de septiembre de 2026.
Para una integración de terceros, lee primero los límites de cobertura y elige un plan según los datos que consumes. Las claves, el proceso de compra y la gestión del plan viven en el mismo panel de cuenta.
Cuatro pasos hacia una primera respuesta verificable
- Confirma la oferta. Pregunta al servicio por los deportes, mercados, transporte y uso previsto que necesitas, incluida cualquier redistribución. Guarda el plan y los términos que aceptes.
- Crea la cuenta a través del enlace de acceso. Sigue los pasos actuales de registro y verificación, y conserva el correo de confirmación y los términos del plan para tus registros.
- Guarda la clave en tu servidor. Almacénala en la variable de entorno
ODDS_API_KEY. Nunca la pegues en un playground público, la pongas en JavaScript del navegador ni la subas a un repositorio. Envíala en la cabecera de solicitud documentadax-portal-apikey. - Solicita un snapshot y valida el sobre. Un estado de éxito es solo la primera comprobación. Exige la estructura de objeto documentada y un array
events, y luego distingue un resultado vacío de datos malformados.
Estos pasos siguen la documentación actual, revisada el 26 de septiembre de 2026.
Autenticarse no es lo mismo que tener derecho de acceso
Una clave válida puede carecer aún del transporte solicitado. Los snapshots REST, las alertas SSE y el WebSocket en bruto tienen requisitos de plan distintos. Antes de tratar un error de conexión como un problema del parser, confirma la suscripción actual de la cuenta, los complementos y la política de conexiones concurrentes.
Detente ante errores de autenticación o de permisos e inspecciona la cuenta. No reintentes una clave inválida en un bucle cerrado. Ante límites de tasa, respeta Retry-After cuando se proporcione; cuando la ventana del límite agotado sea desconocida, detente e investiga. Un reintento debe consumir un presupuesto acotado de tiempo e intentos. Registra el estado y el código de error, nunca la clave ni el cuerpo completo del error del servidor.
Términos de prueba y demo
El nivel gratuito no caduca: 20 solicitudes por minuto y 100 solicitudes al día, sin tarjeta, y la clave de API sirve también como inicio de sesión de la cuenta. Para evaluar los streams, hay disponible bajo petición una demo completa de tres días con SSE, WebSocket en bruto y 10 solicitudes por segundo. Confirma los derechos vigentes en la cuenta antes de depender de ellos. Revisado el 26 de septiembre de 2026.
Empieza sin comprar acceso
La clave gratuita no cuesta nada y no caduca. Úsala para confirmar tu runtime, tu parser y tus mensajes de error contra respuestas reales antes de gastar nada. Cuando pases a un plan de pago, trata la primera respuesta con el nuevo derecho de acceso como un paso de validación nuevo: el éxito en el nivel gratuito no establece acceso a streaming, latencia ni los mercados exactos que vas a comprar.