Rate limit
Un rate limit limita cuántas peticiones puede enviar un cliente a una API por unidad de tiempo. Al superar el límite, el servidor responde con 429 Too Many Requests, definido en RFC 6585, y puede añadir una cabecera Retry-After que indica cuántos segundos esperar (error HTTP 429).
Ritmo y cuota
Normalmente hay dos límites: el ritmo (peticiones por segundo o por minuto) y la cuota (llamadas por día o por mes). En Genesis API ambos dependen del plan:
| Plan | Peticiones por segundo | Llamadas en 30 días | La cuota al ritmo máximo dura |
|---|---|---|---|
| Trial | 1 | 500K | 5,8 días |
| Start | 2 | 2M | 11,6 días |
| Pro | 5 | 5M | 11,6 días |
| Max | 15 | 10M | 7,7 días |
La última columna supone peticiones sin pausa al límite de ritmo y un 200 en cada respuesta. Para Pro: 5 × 86 400 = 432 000 peticiones al día, y 5 000 000 / 432 000 ≈ 11,6 días. El límite por segundo es un techo para ráfagas, mientras que la cuota marca el ritmo medio: 30 días tienen 2 592 000 segundos, así que Pro admite un promedio de 5 000 000 / 2 592 000 ≈ 1,93 peticiones por segundo.
Solo las respuestas 200 consumen cuota; las 304 y los errores no, pero sí cuentan para el límite de peticiones por segundo. El volumen de descarga tiene un tope aparte de 60 MB de datos comprimidos cada 10 segundos por clave; lo que pase del tope recibe 429 download_limited.
Cómo no pasarse del límite
Cada respuesta de Genesis API informa del estado del límite en cabeceras:
| Cabecera | Qué muestra |
|---|---|
X-RateLimit-Limit | Límite de peticiones por segundo de tu plan |
X-RateLimit-Remaining | Peticiones que quedan en la ventana actual |
X-RateLimit-Reset | Hora unix en que se reinicia la ventana |
Retry-After | Segundos que esperar antes de reintentar (en 429 y 503) |
La cuota aparece en X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset y en el endpoint Uso, /account/usage. El código siguiente consulta tres endpoints seguidos: cuando la ventana se queda sin peticiones, espera por sí solo a X-RateLimit-Reset, y ante 429 y 503 hace una pausa de Retry-After.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# el servidor pide una pausa; la siguiente pasada reintenta
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "filas:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# ventana agotada: esperar su reinicio en vez de recibir un 429
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # frescura de Pro: consultar más rápido no aporta nada
Véase también: polling de API, frescura de los datos, Planes y límites, límites de Genesis API, cómo hacer polling a una API sin chocar con los límites.
Preguntas y respuestas
¿Qué pasa cuando se agota la cuota mensual?
Las peticiones por encima de la cuota nunca se cobran. Espera al reinicio (la hora está en X-Quota-Reset) o pasa a un plan superior: el nuevo plan se aplica al instante, la cuota empieza de cero y lo que quedaba del plan anterior se pierde.
¿Puedo saltarme el límite con una segunda clave?
No. Una cuenta tiene una sola clave, y usar varias cuentas o rotar IP para esquivar el límite infringe las reglas. Si te quedas corto de llamadas, recorta las innecesarias con filtros, el parámetro coin y un ETag con If-None-Match, o pasa a un plan superior.