Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

Latência

Latência é o tempo entre um evento no mercado e o momento em que os dados sobre ele chegam ao seu código. Exemplo hipotético: uma negociação aparece numa exchange às 12:00:00 e seu script recebe o novo preço às 12:00:12, uma latência de 12 segundos.

Do que a latência é feita

EtapaO que adiciona tempo
ExchangePublicar uma negociação ou mudança do book na sua API
ColetaReceber dados por WebSocket ou REST, reconexões
CálculoCasar exchanges, recalcular spreads e books
EntregaO passo de atualização da saída do plano e a rede até o seu servidor
Seu códigoO intervalo de consulta e o tratamento da resposta

Algumas dessas etapas aparecem nos campos de resposta da Genesis API. meta.updated_at é o momento em que o snapshot foi montado, e meta.freshness_sec é o atraso de saída do seu plano: 60, 30, 10 ou 5 segundos. Os order books têm marcadores próprios: age_sec é a idade do book e stale sinaliza um book com mais de 30 segundos; os books ficam 5–20 segundos atrás da exchange (order book do mercado na documentação).

Preços defasados na arbitragem

Exemplo hipotético: um snapshot tirado há 15 segundos mostra uma moeda a US$ 10,00 na exchange A e a US$ 10,12 na exchange B.

MomentoPreço em APreço em BSpread
No snapshotUS$ 10,00US$ 10,121,2%
Na exchange agoraUS$ 10,00US$ 10,030,3%

Duas negociações com taxa de taker de 0,1% cada consomem 0,2%, então, em vez dos 1,2% do snapshot, sobram só 0,1%. Quanto maior a latência, mais vezes um bot enxerga um spread que já sumiu da exchange.

Tempo de resposta e atualidade dos dados

O tempo de resposta do servidor e a atualidade dos dados, isto é, há quanto tempo o snapshot foi montado, são números diferentes. Exemplo hipotético: a resposta chega em 0,2 segundo, mas o snapshot dentro dela tem 9 segundos. Você pode medir os dois:

import os
import time
import requests

r = requests.get(
    "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"coin": "BTC"},
    timeout=10,
)
r.raise_for_status()
meta = r.json()["meta"]
# tempo de resposta: do envio da requisição à leitura dos cabeçalhos
print("response time:", round(r.elapsed.total_seconds(), 2), "s")
# idade dos dados: tempo desde a montagem do snapshot
print("data age:", round(time.time() - meta["updated_at"]), "s")

A idade dos dados é calculada pelo relógio do seu servidor: se o relógio atrasa ou adianta, o erro entra no resultado, então mantenha a hora sincronizada (NTP).

Veja também: API polling, WebSocket, formato de resposta, riscos da automação: dados defasados, erros, chaves.

Perguntas e respostas

Qual é a latência da Genesis API?

A saída é atualizada a cada 60 segundos no Trial, 30 no Start, 10 no Pro e 5 no Max; o valor exato para a sua chave vem em meta.freshness_sec. O seu intervalo de consulta e a rede se somam a ele.