Nivel gratuito · REST

La clave gratuita de la API de Pinnacle: 100 solicitudes al día, y qué compran.

La clave gratuita es una clave real en los mismos endpoints REST que los planes de pago: 20 solicitudes por minuto, 100 al día, sin tarjeta, sin caducidad. Encaja con prototipos y actualizaciones lentas. No encaja con el sondeo.

Actualizado el · Ejemplos originales · probado solo con mocks

Qué incluye la clave gratuita

El nivel gratuito es acceso REST a los mercados en vivo y prepartido con toda la profundidad de línea, limitado a 20 solicitudes por minuto y 100 al día. No hay tarjeta que introducir ni fecha de caducidad; la clave sirve también como inicio de sesión del panel de la cuenta. Llega a la misma ruta /kit/v1/markets y al mismo envelope de respuesta que los planes REST de pago, así que el código escrito contra ella pasa a un plan de pago sin cambios. Comprobado contra la documentación del proveedor el 26 de septiembre de 2026.

Dos cosas no están en ella. El stream SSE de caídas forma parte del plan de alertas y de los dos planes combinados, y el WebSocket en bruto es un complemento de los tres planes REST. Una clave gratuita que abre el stream recibe un mensaje de control que dice que el plan no lo incluye, no alertas. Para evaluar esos transportes, el proveedor ofrece bajo petición una demo completa de tres días, con SSE, WebSocket en bruto y 10 solicitudes por segundo.

Qué cubren 100 solicitudes al día

Una solicitud devuelve un tablero de deporte completo, cada evento con su money line, hándicaps y totales en todos los periodos. El recuento que importa es tableros multiplicados por actualizaciones, no eventos.

UsoSolicitudes al díaCabe en la clave gratuita
Una hoja de cálculo que actualiza un deporte cada 15 minutos96Sí
Un deporte sondeado cada 5 minutos durante 8 horas96Sí
Tres deportes cada 5 minutos durante 8 horas288No
Inspeccionar respuestas mientras escribes un parserUnas pocas docenasSí
Precios en vivo durante un partido, cada 10 segundos360 por horaNo

La primera fila es el patrón en torno al que está construido el quickstart de Google Sheets en pnclFEED: una llamada cada 15 minutos, 96 al día, dentro de la asignación. El techo de 20 por minuto rara vez importa a estos ritmos; existe para evitar que una ráfaga gaste el día en cinco minutos.

Cómo estirar el presupuesto

El cursor since no reduce el número de solicitudes, solo el payload: una llamada delta sigue siendo una llamada. Lo que reduce el número es el alcance y la programación. Sondea un tablero en lugar de cinco, sondea en las horas en que se juega el deporte, y haz que un solo proceso sea el único que llama mientras cada dashboard, hoja y modelo lee de la copia de ese proceso. Una caché delante de la clave convierte cincuenta lectores en una solicitud.

Comprueba el recuento antes de que se agote. A 90 solicitudes, las 10 restantes deberían reservarse para las llamadas programadas, y un poller que alcanza el límite diario debería parar en lugar de reintentar, porque un 429 del día no se puede esperar en segundos. La calculadora de costes de la API en pnclAPI convierte el intervalo, las horas y los tableros en una cifra diaria para cualquier programación.

Cuándo compensa un plan de pago

En el momento en que una programación necesita más de un tablero cada 15 minutos, la clave gratuita deja de ser el plan. El plan de snapshots REST sube el techo a 10 solicitudes por segundo por 99 USD al mes, o 249 USD por tres meses y 449 USD por seis. Alertas sin sondeo es el plan SSE a 99 USD, alertas con sondeo son 149 USD, y el plan de alto volumen a 229 USD funciona a 30 solicitudes por segundo con alertas incluidas. La página de precios lista todos los términos, y la guía de planes empareja cada uno con el bucle que estás escribiendo.

Obtener y conservar la clave

Crea la cuenta a través del enlace de acceso, copia la clave del panel y guárdala en el servidor en una variable de entorno. Envíala en la cabecera x-portal-apikey. Nunca la pongas en JavaScript del navegador ni en un repositorio público; la lista de comprobación de acceso recorre la primera solicitud y cómo validar el envelope que devuelve.

Preguntas sobre el nivel gratuito

¿La clave gratuita caduca o hay que renovarla?

No. Los términos publicados no tienen caducidad ni tarjeta. Sigue siendo válida hasta que pases a un plan superior o se cierre la cuenta.

¿Los precios son los mismos que en los planes de pago?

Sí. Los endpoints y el envelope son los mismos; los planes difieren en la tasa, en el tope diario y en los transportes que incluyen, no en los datos.

¿Puedo probar el stream SSE gratis?

No con la clave gratuita. Pide al proveedor la demo completa de tres días, que incluye el stream y el WebSocket en bruto.

Las asignaciones y los precios siguen los términos publicados por el proveedor, revisados el 26 de septiembre de 2026. Publicado el 29 de septiembre de 2026.

Tu siguiente paso

Comprueba el encaje. Luego consigue el acceso.

Confirma los mercados, el transporte y los términos de cuenta que necesitas antes de elegir un plan.