Genesis Arbitrage

Genesis Arbitrage · · 15 min de lectura

API de funding rate: las tasas de todos los exchanges en una petición y el historial de funding pagado

En resumen

  • Una API de funding rate debe devolver, por exchange, la tasa por intervalo, el propio intervalo, la hora del próximo funding, la tasa equivalente a 8 horas y el precio del futuro.
  • Binance, Bybit, OKX y Hyperliquid tienen cada uno sus endpoints, sus unidades y su forma de informar el intervalo. Genesis API /funding/rates devuelve las tasas de todos los exchanges en una sola petición GET, en porcentaje y normalizadas a 8 horas.
  • El historial de funding pagado de 13 exchanges (sumas, tasas medias, APR, un año de sumas diarias y un screener de combinaciones con net tras comisiones) está en /funding/analytics/* en los planes Pro y Max.

Una API de funding rate devuelve, para los futuros perpetuos de cada exchange, las tasas de financiación: la tasa por intervalo, el propio intervalo y la hora del próximo funding y, en su versión más completa, el historial de funding pagado. Cada exchange tiene su propia API con sus rutas, unidades e intervalos; por eso, para compararlos, las tasas se reúnen en una sola tabla, se convierten a porcentaje y se normalizan a un mismo periodo, normalmente 8 horas.

Qué debe devolver una API de funding rate

Una tasa sin su intervalo no dice nada: 0,02 % cada 4 horas y 0,02 % cada 8 horas difieren en un factor de dos. Por eso una API de tasas de financiación de criptomonedas útil devuelve cinco valores para cada par moneda–exchange.

Qué necesitasPara quéCampo de /funding/rates
Tasa por intervaloCuánto será el próximo pagofunding_pct
Intervalo de fundingSin él no se pueden comparar las tasasinterval
Hora del próximo fundingLa posición debe estar abierta para entoncesnext_payout
Tasa por 8 horasComparar exchanges con intervalos distintosfunding_8h_pct
Precio del futuroLa diferencia de precio entre patas mueve la entradaprice

El pago es el tamaño de la posición por la tasa: una posición de $10.000 al 0,01 % recibe o paga $1 por liquidación.

Por qué difieren los intervalos entre exchanges y cómo normalizar una tasa a 8 horas

Cada exchange decide con qué frecuencia liquida el funding y puede cambiar el intervalo de un contrato concreto. En la analítica de Genesis API, los intervalos de los CEX son de 8 y 4 horas, mientras que Hyperliquid y Lighter liquidan cada hora. Hyperliquid calcula la tasa como una tasa a 8 horas y paga una octava parte cada hora, como se describe en las reglas de funding de Hyperliquid.

En el ejemplo de la documentación de Genesis API, MEXC cobra un 0,02 % por TON cada 4 horas: 0,02 × 8 / 4 = 0,04 % por 8 horas. Un ejemplo hipotético con intervalo de una hora: el exchange A paga un 0,004 % cada hora y el exchange B paga un 0,02 % cada 8 horas. Con las cifras en bruto, A paga una quinta parte, pero en 8 horas son 0,004 × 8 / 1 = 0,032 % frente a 0,02 %, es decir, 1,6 veces más.

La normalización supone que la tasa se mantiene durante todo el periodo, y una tasa horaria puede cambiar ya en la siguiente liquidación. Solo el historial muestra lo que realmente se pagó.

El APR se calcula a partir de la tasa a 8 horas: tres liquidaciones al día, 1.095 al año. Para el exchange A son 0,032 × 3 × 365 = 35,04 % anual, mientras la tasa se mantenga.

API de funding rate en los exchanges: Binance, Bybit, OKX y Hyperliquid

Cada exchange importante tiene su propia API de funding rate: sus propias rutas, campos y forma de informar el intervalo.

ExchangeTasa actualHistorialIntervalo
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historycampo fundingIntervalHour
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historya partir de fundingTime y nextFundingTime
HyperliquidPOST /info, metaAndAssetCtxsPOST /info, fundingHistorycada hora

La API de funding rate de Binance devuelve la tasa y la hora del próximo funding en los campos lastFundingRate y nextFundingTime de premiumIndex (documentación de Binance), y el historial de tasas de Binance sale de fundingRate, que acepta startTime y endTime (historial de tasas de funding). fundingInfo devuelve el intervalo solo para los contratos cuyo intervalo o tope de tasa ha ajustado el exchange (descripción del endpoint).

Bybit devuelve fundingRate, nextFundingTime y fundingIntervalHour en una única respuesta de tickers con category=linear (tickers de Bybit), y su petición de historial exige symbol (historial de funding de Bybit). Como señala la documentación, cada contrato tiene su propio intervalo.

En OKX, la documentación propone deducir el intervalo de un contrato de la diferencia entre nextFundingTime y fundingTime (documentación de OKX).

Hyperliquid recibe todas las consultas de datos en POST https://api.hyperliquid.xyz/info, y el cuerpo JSON decide qué se devuelve: {"type": "metaAndAssetCtxs"} devuelve el funding actual de cada activo, {"type": "fundingHistory", "coin": "ETH", "startTime": …} devuelve el historial de tasas (documentación de Hyperliquid).

Para unir estos exchanges en una sola tabla, tu código tiene que:

Todos los exchanges en una petición: /funding/rates

GET /funding/rates devuelve, para cada moneda, la lista de exchanges con la tasa actual: Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid y el resto de exchanges que cubre Genesis Arbitrage, más de 1000 monedas en total. Los filtros coin y exchange (separados por comas para varios exchanges) son opcionales; sin ellos recibes el conjunto completo.

curl --compressed \
  "https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

Este es un elemento del array data dentro del sobre que comparten todas las respuestas de Genesis API: success, data, meta. Las tasas van en porcentaje, next_payout es la hora del pago en formato HH:MM UTC, los valores vacíos son null y Hyperliquid aparece como Hyper. Todos los campos y el formulario Probar están en la sección Tasas de funding de la documentación.

/funding/rates y /funding/spread están en todos los planes, desde Trial a $20 al mes: 500 K llamadas, 1 petición por segundo, 60 s de frescura de los datos (precios de Genesis API).

Spread de funding: /funding/spread

El spread de funding es la diferencia entre la tasa más alta y la más baja de una moneda entre exchanges, tras normalizar a 8 horas. El short va donde la tasa es más alta y el long donde es más baja: el short recibe la tasa de su exchange, el long paga la suya (o recibe, si esa tasa es negativa), y la diferencia es lo que queda.

GET /funding/spread devuelve, para cada moneda, el mejor par de exchanges en best: exchange_1 y exchange_2, sus tasas por su propio intervalo (funding_1_pct, funding_2_pct), los intervalos, las horas de pago y los enlaces al terminal. El spread del par está en spread_pct, los demás exchanges están en others, y los filtros son coin y min_spread (documentación de Spread de funding). Los intervalos de un par suelen diferir, como 1h y 8h para BTC en el ejemplo de la documentación, así que las tasas de un par solo se comparan a mano después de normalizarlas a 8 horas.

Python: top 10 de spreads de funding, anualizados

El script toma el conjunto completo de /funding/rates y, para cada moneda, busca los exchanges con el funding_8h_pct más alto y más bajo: la diferencia es el spread a 8 horas, anualizado como spread × 3 × 365. Con 429 y 503 espera Retry-After segundos, pero no más de un minuto: cuando se agota la cuota mensual, Retry-After dura hasta que la cuota se restablece.

import os
import time
import requests

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


def fetch_rates():
    for _ in range(3):
        r = requests.get(URL, headers=HEADERS, timeout=20)
        if r.status_code not in (429, 503):
            r.raise_for_status()
            return r.json()["data"]
        # 429 o 503: esperar Retry-After, pero no más de un minuto
        time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
    raise RuntimeError("La API no respondió tras tres intentos")


rows = []
for item in fetch_rates():
    ex = [e for e in item["exchanges"]
          if e["funding_8h_pct"] is not None]
    if len(ex) < 2:
        continue
    short = max(ex, key=lambda e: e["funding_8h_pct"])  # pata short
    long_ = min(ex, key=lambda e: e["funding_8h_pct"])  # pata long
    spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
    rows.append((spread, item["coin"], short, long_))

rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
    apr = spread * 3 * 365  # APR simple sobre el nocional de una pata
    print(f"{coin:<10} short {short['exchange']:<8} "
          f"long {long_['exchange']:<8} {spread:.4f}% por 8h  "
          f"APR {apr:.1f}%, sobre el capital {apr / 2:.1f}%")

La cifra anualizada se refiere al nocional de una pata. Ambas patas necesitan dinero, así que sobre el capital total sin apalancamiento el rendimiento es la mitad, como en el campo de analítica apr_capital. Un ejemplo hipotético: short en un exchange al 0,05 % por 8 horas, long en otro al 0,01 %. El spread es 0,05 − 0,01 = 0,04 %, anualizado 0,04 × 3 × 365 = 43,8 % por pata y 21,9 % sobre el capital.

Las comisiones no están incluidas. Un ejemplo hipotético: una comisión taker del 0,05 % en cada una de las cuatro operaciones (abrir y cerrar ambas patas) suma 4 × 0,05 = 0,2 % del nocional de una pata. Un spread del 0,04 % lo recupera en 0,2 / 0,04 = 5 liquidaciones, o 40 horas, si las tasas no cambian.

Solo una respuesta 200 cuenta para la cuota. En un monitor, consulta como máximo una vez cada meta.freshness_sec segundos y envía el ETag anterior en If-None-Match: un conjunto completo sin cambios vuelve como un 304 sin coste. Más en la guía de límites y en la lección 4 del curso de API de criptomonedas, que construye un monitor de spreads y funding en Python.

Historial de funding pagado: /funding/analytics/*

La tasa actual muestra la próxima liquidación; el historial muestra lo que realmente se pagó. Sale de cuatro endpoints de analítica: 13 exchanges, tasas en porcentaje por periodo de liquidación, marcas de tiempo en segundos epoch UTC. Están en los planes Pro ($100 al mes) y Max ($200); Trial y Start reciben 403 plan_restricted.

EndpointContenidoSección completa
/funding/analytics/summarySumas, tasas medias a 8 horas, APR y cobertura para 7 periodos, de 1 día a un año~600 KB gzip
/funding/analytics/recentTodos los pagos de los últimos 7 días~1 MB gzip
/funding/analytics/dailySumas diarias de 365 díashasta ~12 MB gzip
/funding/analytics/topTop 50 de pares moneda×exchange y top 50 de combinaciones short/long por periodo—

Las descargas completas sin coin están limitadas: summary y recent una vez cada 60 segundos, daily una vez cada 300 segundos por clave; una petición antes de que termine la ventana recibe 429 con Retry-After. Los recortes por coin y las respuestas 304 no tienen límite, así que el historial de una moneda se obtiene así:

curl --compressed -G \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

En summary, cada par moneda×exchange incluye el intervalo interval_h, el inicio de los datos data_since, la última tasa a 8 horas last8h para comparar «ahora frente a lo normal», y un array m de 14 métricas por periodo: sum, avg8h, apr, cov, flips y otras. Ejemplo de la documentación: BTC en Binance a 7 días, 21 liquidaciones positivas, avg8h 0,006298 %, apr 0,006298 × 3 × 365 ≈ 6,896 %. El análisis de m, recent y daily se explica en la guía de endpoints de funding, y los campos en la sección Analítica de funding de la documentación.

El screener de combinaciones top

/funding/analytics/top es un screener listo para usar, sin parámetros. Las patas de las combinaciones siempre están en exchanges distintos con una cobertura de al menos 0,9, y las combinaciones con net ≤ 0 nunca entran en las listas.

gross es el funding bruto de la combinación en el periodo, fees son las comisiones de cuatro operaciones según la tabla taker_fees, y net = gross − fees. apr_net se anualiza sobre el nocional de una pata, apr_capital es la mitad, sobre el capital de ambas patas. win_rate es la proporción de días rentables, max_dd la mayor caída, y price_div la diferencia de precio actual entre las patas, que net no incluye.

En el ejemplo de la documentación, la combinación de PEPE (short en HTX, long en Hyperliquid con el ticker 1000PEPE) obtuvo un gross de 1,51504 % con fees de 0,19 en 7 días. Así, net = 1,51504 − 0,19 = 1,32504 %, apr_net es 69,09 % y apr_capital 34,55 %. Listas ya preparadas: by_net_apr por rendimiento neto, by_stable para combinaciones estables, by_live para las que funcionan ahora mismo.

La tasa de funding como indicador de mercado

Con una tasa positiva, los longs con apalancamiento pagan a los shorts; con una negativa, ocurre al revés. Una tasa positiva pequeña es normal (Hyperliquid fija el componente de interés en un 0,01 % por 8 horas), y la tasa se convierte en señal cuando se aleja claramente de su nivel habitual.

Lee una tasa alta junto con el open interest: cuando ambos suben, hay muchas posiciones apalancadas apiladas en un lado, y un movimiento en su contra desencadena una cascada de liquidaciones. /market/open-interest devuelve el open interest por exchange (sección de la documentación). Más en La tasa de funding como indicador de mercado.

Riesgos del arbitraje de funding

Una combinación short/long entre dos exchanges apenas depende del precio, pero aun así se puede perder dinero con ella:

Sin código, las mismas tasas están en la tabla de Arbitraje de funding (guía), la calculadora de spread calcula una combinación con comisiones, y la visión general de las API de criptomonedas compara las API de datos de mercado en general.

Preguntas y respuestas

¿Dónde puedo obtener el historial de tasas de funding?

Los exchanges guardan el historial en formatos propios: GET /fapi/v1/fundingRate en Binance, GET /v5/market/funding/history en Bybit, el tipo fundingHistory en Hyperliquid. Genesis API devuelve el historial de 13 exchanges en un único formato: /funding/analytics/recent para los pagos de 7 días, /funding/analytics/daily para las sumas diarias de un año y /funding/analytics/summary para los totales por periodo, en los planes Pro y Max.

¿Por qué difieren las tasas de funding entre exchanges?

Cada exchange tiene sus propios traders, liquidez, fórmula de tasa y topes, así que el desequilibrio de posiciones se acumula de forma distinta. Los intervalos también difieren: 8 o 4 horas en los CEX, cada hora en Hyperliquid. Compara las tasas después de normalizarlas a un mismo periodo; en Genesis API es el campo funding_8h_pct.

¿Con qué frecuencia se actualizan las tasas de funding en la API?

La tasa actual de un exchange cambia hasta la liquidación; la tasa liquidada queda fijada y pasa al historial. La frescura de los datos de Genesis API es de 60 s en Trial, 30 s en Start, 10 s en Pro y 5 s en Max; el ETag del summary de analítica cambia cada 15 minutos aproximadamente, y las sumas diarias se recalculan cada hora.

¿Existe una API de funding rate gratuita?

Genesis API no tiene plan gratuito: las tasas de funding y el spread están en Trial a $20 al mes, el historial en Pro a $100 y Max a $200. En el sitio, las tasas de funding y los spreads se ven sin plan en Arbitraje de funding.