Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

ETag e If-None-Match

ETag es un encabezado de respuesta HTTP que lleva una etiqueta de versión de los datos: mientras el recurso no cambie, la etiqueta tampoco. El cliente devuelve la etiqueta en el encabezado If-None-Match y, si el servidor sigue teniendo esa versión, responde 304 Not Modified sin cuerpo. Ambos encabezados están definidos en el RFC 9110 (HTTP Semantics, 2022).

Cómo funciona una petición condicional

Un intercambio hipotético con la etiqueta "a7f3c9":

PasoPeticiónRespuesta
1GET /v1/funding/rates200, ETag: "a7f3c9", cuerpo JSON
2La misma URL con If-None-Match: "a7f3c9"304 Not Modified, sin cuerpo
3La misma petición tras actualizarse los datos200, una etiqueta nueva y JSON nuevo

Según el estándar, una respuesta 304 termina con sus encabezados y no puede llevar cuerpo, así que el cliente reutiliza su propia copia. El servidor compara las etiquetas; el cliente solo guarda la última etiqueta recibida y la envía con la misma petición.

import os
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/rates"
cache = {"tag": None, "data": None}  # el conjunto completo y su 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"]  # datos sin cambios, sin consumir cuota
    r.raise_for_status()
    cache["tag"] = r.headers.get("ETag")
    cache["data"] = r.json()["data"]
    return cache["data"]

# elige la moneda en local: una petición con coin llega sin ETag
btc = [row for row in get_rates() if row["coin"] == "BTC"]

ETag en Genesis API

En Genesis API solo una respuesta 200 cuenta como llamada: un 304 no consume cuota, aunque sí cuenta para el límite de peticiones por segundo. No tiene cuerpo, y las respuestas de menos de 64 KB no cuentan para el límite de volumen de descarga. Los conjuntos completos sin filtros llevan la etiqueta: la respuesta a una petición con coin o filtros se construye para esa petición y llega sin ETag, así que ahí el propio filtro ahorra el tráfico (planes y límites).

Ejemplo hipotético: un bot descarga cada 60 segundos el resumen completo de la analítica de funding /funding/analytics/summary (planes Pro y Max). La sección pesa unos 600 KB comprimida con gzip y su etiqueta cambia más o menos cada 15 minutos. En 30 días son 30 × 24 × 60 = 43 200 peticiones. Con If-None-Match, solo 30 × 24 × 4 = 2880 descargan la sección completa; las otras 40 320 vuelven como 304, sin cuerpo ni cargo de cuota. El tráfico baja de unos 26 GB a 1,7 GB.

Véase también: API polling, HTTP 429, frescura de los datos, formato de respuesta, ETag y errores de Genesis API, cómo consultar una API sin chocar con los límites.

Preguntas y respuestas

¿Una respuesta 304 consume cuota de Genesis API?

No. Solo las respuestas 200 consumen cuota; 304 y los errores son gratis, pero cuentan para el límite de peticiones por segundo.

¿Qué hago si la respuesta no trae ETag?

Consulta no más a menudo que meta.freshness_sec y compara meta.updated_at con la respuesta anterior: el mismo valor significa que la instantánea no se ha actualizado.