Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

ETag e If-None-Match

ETag é um cabeçalho de resposta HTTP que traz uma etiqueta de versão dos dados: enquanto o recurso não muda, a etiqueta também não. O cliente devolve a etiqueta no cabeçalho If-None-Match e, se o servidor ainda tem essa versão, responde 304 Not Modified sem corpo. Os dois cabeçalhos são definidos na RFC 9110 (HTTP Semantics, 2022).

Como funciona uma requisição condicional

Uma troca hipotética com a etiqueta "a7f3c9":

PassoRequisiçãoResposta
1GET /v1/funding/rates200, ETag: "a7f3c9", corpo JSON
2A mesma URL com If-None-Match: "a7f3c9"304 Not Modified, sem corpo
3A mesma requisição após os dados serem atualizados200, uma nova etiqueta e um novo JSON

Pelo padrão, uma resposta 304 termina nos cabeçalhos e não pode ter corpo, então o cliente reutiliza a própria cópia. O servidor compara as etiquetas; o cliente só guarda a última etiqueta recebida e a envia junto com a mesma requisição.

import os
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/rates"
cache = {"tag": None, "data": None}  # o conjunto completo e sua etiqueta

def get_rates():
    headers = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
    if cache["tag"]:
        headers["If-None-Match"] = cache["tag"]
    r = requests.get(URL, headers=headers, timeout=10)
    if r.status_code == 304:
        return cache["data"]  # dados inalterados, sem consumir cota
    r.raise_for_status()
    cache["tag"] = r.headers.get("ETag")
    cache["data"] = r.json()["data"]
    return cache["data"]

# escolha a moeda localmente: uma requisição com coin vem sem ETag
btc = [row for row in get_rates() if row["coin"] == "BTC"]

ETag na Genesis API

Na Genesis API, só uma resposta 200 conta como chamada: um 304 não consome sua cota, mas conta para o limite de requisições por segundo. Ele não tem corpo, e respostas abaixo de 64 KB não contam para o limite de volume de download. Os conjuntos completos, sem filtros, trazem a etiqueta: a resposta a uma requisição com coin ou filtros é montada para aquela requisição e vem sem ETag, então ali o próprio filtro poupa o tráfego (planos e limites).

Exemplo hipotético: um bot baixa a cada 60 segundos o resumo completo da análise de funding /funding/analytics/summary (planos Pro e Max). A seção tem cerca de 600 KB compactada em gzip, e a etiqueta muda mais ou menos a cada 15 minutos. Em 30 dias são 30 × 24 × 60 = 43.200 requisições. Com If-None-Match, só 30 × 24 × 4 = 2.880 baixam a seção completa; as outras 40.320 voltam como 304, sem corpo e sem cobrança de cota. O tráfego cai de cerca de 26 GB para 1,7 GB.

Veja também: API polling, HTTP 429, atualidade dos dados, formato de resposta, ETag e erros da Genesis API, como consultar uma API sem bater nos limites.

Perguntas e respostas

Uma resposta 304 consome cota da Genesis API?

Não. Só respostas 200 consomem cota; 304 e erros são gratuitos, mas contam para o limite de requisições por segundo.

E se a resposta não tiver ETag?

Consulte no máximo na frequência de meta.freshness_sec e compare meta.updated_at com a resposta anterior: o mesmo valor significa que o snapshot não foi atualizado.