Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

Atualidade dos dados

Atualidade dos dados é a idade da informação no momento em que ela chega a você: quantos segundos se passaram entre a construção dos dados e a chegada da resposta. Em arbitragem, ela decide se um spread ainda está vivo: um par calculado com cotações de um minuto atrás pode ter fechado antes da sua requisição.

Atualidade por plano da Genesis API

O núcleo da Genesis Arbitrage atualiza os dados a cada segundo, e o seu plano da Genesis API define com que frequência a saída da API é atualizada. Toda resposta traz o valor do seu plano em meta.freshness_sec e a hora de construção dos dados em meta.updated_at (formato de resposta).

Planofreshness_secConsulta no máximo
Trial60uma vez a cada 60 s
Start30uma vez a cada 30 s
Pro10uma vez a cada 10 s
Max5uma vez a cada 5 s

Consultar mais rápido que freshness_sec devolve o mesmo snapshot. Envie o ETag da resposta anterior em If-None-Match: se nada mudou, a API responde 304 sem corpo, e essa resposta não consome cota (ETag e If-None-Match, polling de API). Enquanto os dados são reconstruídos, você recebe 503 snapshot_not_ready; tente de novo após Retry-After segundos.

Livro de ofertas e idade por plataforma

Os livros de ofertas têm seu próprio horário. Em /orderbooks/book e /orderbooks/coin/{coin}, cada livro traz book_ts (o horário do livro), age_sec (sua idade em segundos) e stale, que é true quando o livro tem mais de 30 s. Os livros ficam de 5 a 20 segundos atrás da exchange (order book do mercado).

age_sec é calculado na construção da resposta, então, no momento do recebimento, now − book_ts é mais preciso. Nos mercados de previsão, /predictions/platforms mostra a atualidade por plataforma: quotes_at é o horário das últimas cotações e full_scan_at, o da última varredura completa.

Checagem no código

Os livros de ofertas estão nos planos Pro e Max, mas a checagem de meta é a mesma para todos os endpoints.

import os
import time

import requests

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


def get_json(params, tries=3):
    for _ in range(tries):
        r = requests.get(URL, headers=HEADERS, params=params,
                         timeout=10)
        if r.status_code in (429, 503):  # rate limit ou reconstrução
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError("data not ready")


params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"idade do snapshot {now - meta['updated_at']:.0f} s,"
      f" atualidade do plano {meta['freshness_sec']} s")

book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
    print("o livro de ofertas está desatualizado, sinal ignorado")

Veja também: limites da Genesis API, como consultar uma API sem bater nos limites, riscos da automação, livro de ofertas.

Perguntas e respostas

Qual a diferença entre atualidade e latência?

Latência é o caminho todo entre um evento na exchange e o seu código: a publicação pela exchange, a coleta, o cálculo, a entrega e o seu intervalo de consulta. Atualidade é a parte que você vê na resposta: há quanto tempo o snapshot foi construído. Um servidor pode responder em uma fração de segundo e ainda assim devolver um snapshot de um minuto atrás.