Documentación de Genesis API
Todo lo necesario para integrar: autenticación, límites, endpoints y esquemas de respuesta.
Planes y límites
Los límites los define tu plan. El estado actual siempre está en /account/usage y en los encabezados de cada respuesta.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Llamadas al mes | 500K | 2M | 5M | 10M |
| Peticiones por segundo | 1 | 2 | 5 | 15 |
| Frescura de datos | 60 s | 30 s | 10 s | 5 s |
Los endpoints fuera de tu plan devuelven 403 con el código plan_restricted. Las peticiones por encima de los límites nunca se cobran.
Solo una respuesta 200 cuenta como llamada. Las respuestas 304 (sin cambios) y los errores 4xx/5xx no consumen tu cuota, pero sí cuentan para el límite de peticiones por segundo.
El volumen de descarga está limitado a 60 MB de datos comprimidos cada 10 segundos por clave. Consultar todos los conjuntos de datos con la frescura de tu plan cabe con holgura; las respuestas de menos de 64 KB no cuentan. Al superar el límite, se devuelve 429 download_limited hasta que termine la ventana, sin cobro. Ahorra tráfico con If-None-Match, los filtros y el parámetro coin.
Encabezados de límites
| Encabezado | Descripción | |
|---|---|---|
X-RateLimit-Limit | Límite de peticiones por segundo de tu plan | |
X-RateLimit-Remaining | Peticiones restantes en la ventana actual | |
X-RateLimit-Reset | Tiempo unix de reinicio de la ventana | |
X-Quota-Limit | Cuota de llamadas del período actual de 30 días | |
X-Quota-Remaining | Llamadas restantes en el período | |
X-Quota-Reset | Tiempo unix en que se reinicia la cuota | |
Retry-After | Segundos a esperar antes de reintentar (con 429 y 503) |