Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

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:

PlanPeticiones por segundoLlamadas en 30 díasLa cuota al ritmo máximo dura
Trial1500K5,8 días
Start22M11,6 días
Pro55M11,6 días
Max1510M7,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:

CabeceraQué muestra
X-RateLimit-LimitLímite de peticiones por segundo de tu plan
X-RateLimit-RemainingPeticiones que quedan en la ventana actual
X-RateLimit-ResetHora unix en que se reinicia la ventana
Retry-AfterSegundos 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.