Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

Rate limit

Um rate limit limita quantas requisições um cliente pode enviar a uma API por unidade de tempo. Ao passar do limite, o servidor responde com 429 Too Many Requests, definido na RFC 6585, e pode incluir um cabeçalho Retry-After informando quantos segundos esperar (erro HTTP 429).

Taxa e cota

Em geral há dois limites: a taxa (requisições por segundo ou por minuto) e a cota (chamadas por dia ou por mês). Na Genesis API, ambos dependem do plano:

PlanoRequisições por segundoChamadas em 30 diasA cota na taxa máxima dura
Trial1500K5,8 dias
Start22M11,6 dias
Pro55M11,6 dias
Max1510M7,7 dias

A última coluna supõe requisições ininterruptas no limite de taxa e um 200 em cada resposta. Para o Pro: 5 × 86.400 = 432.000 requisições por dia, e 5.000.000 / 432.000 ≈ 11,6 dias. O limite por segundo é um teto para picos, enquanto a cota define o ritmo médio: 30 dias têm 2.592.000 segundos, então o Pro sustenta em média 5.000.000 / 2.592.000 ≈ 1,93 requisição por segundo.

Só as respostas 200 consomem a cota; as 304 e os erros não, mas ainda contam para o limite de requisições por segundo. O volume de download tem um teto à parte de 60 MB de dados comprimidos a cada 10 segundos por chave; o que passar do teto recebe 429 download_limited.

Como ficar dentro do limite

Toda resposta da Genesis API informa o estado do limite em cabeçalhos:

CabeçalhoO que mostra
X-RateLimit-LimitLimite de requisições por segundo do seu plano
X-RateLimit-RemainingRequisições restantes na janela atual
X-RateLimit-ResetHorário unix em que a janela reinicia
Retry-AfterSegundos a esperar antes de tentar de novo (em 429 e 503)

A cota aparece em X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset e no endpoint Uso, /account/usage. O código abaixo consulta três endpoints em sequência: quando a janela fica sem requisições, ele espera X-RateLimit-Reset por conta própria, e em 429 e 503 faz uma 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):
            # o servidor pede uma pausa; a próxima passada tenta de novo
            time.sleep(int(r.headers.get("Retry-After", "1")))
            continue
        r.raise_for_status()
        print(path, "linhas:", r.json()["meta"]["count"])
        if r.headers.get("X-RateLimit-Remaining") == "0":
            # janela esgotada: esperar o reinício em vez de receber um 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)  # atualização do Pro: consultar mais rápido não adianta

Veja também: polling de API, atualidade dos dados, Planos e limites, limites da Genesis API, como fazer polling em uma API sem bater nos limites.

Perguntas e respostas

O que acontece quando a cota mensal acaba?

Requisições além da cota nunca são cobradas. Espere o reinício (o horário está em X-Quota-Reset) ou passe para um plano superior: o novo plano vale na hora, a cota começa do zero e o que sobrou do plano antigo é perdido.

Posso contornar o limite com uma segunda chave?

Não. A conta tem uma única chave, e usar várias contas ou trocar de IP para passar do limite viola as regras. Se faltarem chamadas, corte as desnecessárias com filtros, o parâmetro coin e um ETag com If-None-Match, ou passe para um plano superior.