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 cota | Intervalo = atualidade | Chamadas por endpoint | Endpoints dentro da cota |
|---|---|---|---|
| Trial, 500K | 60 s | 43.200 | 11 |
| Start, 2M | 30 s | 86.400 | 23 |
| Pro, 5M | 10 s | 259.200 | 19 |
| Max, 10M | 5 s | 518.400 | 19 |
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étodo | Quem inicia a transferência | Indicado para |
|---|---|---|
| Polling | O cliente, em intervalos fixos | Dados que se atualizam num passo conhecido; qualquer cliente HTTP serve |
| WebSocket | O servidor, por uma conexão aberta | Um fluxo contínuo de mudanças: order books e negociações de uma exchange |
| Webhook | O servidor, com uma requisição à sua URL | Eventos 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.