Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

API polling

API polling é obter dados recentes por meio de requisições repetidas em intervalos fixos: a cada N segundos o cliente pergunta ao servidor o que mudou. Bots e dashboards trabalham assim com uma API REST, que nunca envia nada por conta própria: cada consulta é um simples HTTP GET.

Intervalo e atualidade dos dados

Consultar mais rápido do que os dados se atualizam não traz nada: o servidor devolve o mesmo snapshot. Na Genesis API, a atualidade dos dados depende do plano: a saída é atualizada a cada 60 segundos no Trial, 30 no Start, 10 no Pro e 5 no Max, e esse valor vem no campo meta.freshness_sec. O horário de montagem do snapshot está em meta.updated_at; o mesmo valor em duas respostas seguidas significa que a segunda requisição foi desperdiçada.

Exemplo hipotético: no Trial, um bot consulta um endpoint a cada 10 segundos. Das seis requisições por minuto, só uma traz dados novos; as outras cinco repetem o snapshot e ainda consomem cota, a menos que o bot envie If-None-Match.

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

while True:
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 1}, timeout=10)
    if r.status_code in (429, 503):
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    r.raise_for_status()
    meta = r.json()["meta"]
    print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
    # consultar mais rápido que o passo de atualização do plano é inútil
    time.sleep(meta["freshness_sec"])

Quantas chamadas o polling consome

Consultar um endpoint a cada 10 segundos: 2.592.000 ÷ 10 = 259.200 chamadas em 30 dias. A cota da Genesis API também cobre 30 dias.

Plano e cotaIntervalo = atualidadeChamadas por endpointEndpoints dentro da cota
Trial, 500K60 s43.20011
Start, 2M30 s86.40023
Pro, 5M10 s259.20019
Max, 10M5 s518.40019

A conta ignora respostas 304. No Pro, 19 endpoints a cada 10 segundos dão em média 1,9 requisição por segundo, contra um limite de 5. Distribua as requisições: 19 de uma vez passariam do limite, e o servidor responderia com HTTP 429.

Polling, WebSocket e webhooks

MétodoQuem inicia a transferênciaIndicado para
PollingO cliente, em intervalos fixosDados que se atualizam num passo conhecido; qualquer cliente HTTP serve
WebSocketO servidor, por uma conexão abertaUm fluxo contínuo de mudanças: order books e negociações de uma exchange
WebhookO servidor, com uma requisição à sua URLEventos raros, se você tem um endpoint HTTPS público

A Genesis API não tem WebSocket nem webhooks: os dados são servidos por REST e o plano define a atualidade. Consultar em meta.freshness_sec é a forma padrão de trabalhar com ela; as formas de reduzir tráfego e chamadas estão em Como consultar uma API sem bater nos limites.

Veja também: rate limit, planos e limites na documentação, formato de resposta, limites da Genesis API.

Perguntas e respostas

Com que frequência devo consultar a Genesis API?

No máximo na frequência do meta.freshness_sec do seu plano: a cada 60 segundos no Trial, 30 no Start, 10 no Pro e 5 no Max. Consultar mais rápido devolve os mesmos dados.