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
| Etapa | O que adiciona tempo |
|---|---|
| Exchange | Publicar uma negociação ou mudança do book na sua API |
| Coleta | Receber dados por WebSocket ou REST, reconexões |
| Cálculo | Casar exchanges, recalcular spreads e books |
| Entrega | O passo de atualização da saída do plano e a rede até o seu servidor |
| Seu código | O 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.
| Momento | Preço em A | Preço em B | Spread |
|---|---|---|---|
| No snapshot | US$ 10,00 | US$ 10,12 | 1,2% |
| Na exchange agora | US$ 10,00 | US$ 10,03 | 0,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.