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/ratesdevuelve 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
nettras 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é necesitas | Para qué | Campo de /funding/rates |
|---|---|---|
| Tasa por intervalo | Cuánto será el próximo pago | funding_pct |
| Intervalo de funding | Sin él no se pueden comparar las tasas | interval |
| Hora del próximo funding | La posición debe estar abierta para entonces | next_payout |
| Tasa por 8 horas | Comparar exchanges con intervalos distintos | funding_8h_pct |
| Precio del futuro | La diferencia de precio entre patas mueve la entrada | price |
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.
| Exchange | Tasa actual | Historial | Intervalo |
|---|---|---|---|
| Binance | GET /fapi/v1/premiumIndex | GET /fapi/v1/fundingRate | GET /fapi/v1/fundingInfo |
| Bybit | GET /v5/market/tickers | GET /v5/market/funding/history | campo fundingIntervalHour |
| OKX | GET /api/v5/public/funding-rate | GET /api/v5/public/funding-rate-history | a partir de fundingTime y nextFundingTime |
| Hyperliquid | POST /info, metaAndAssetCtxs | POST /info, fundingHistory | cada 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:
- convertir las tasas de fracciones a porcentaje;
- encontrar el intervalo de cada contrato y normalizar la tasa a 8 horas;
- convertir las marcas de tiempo desde milisegundos y unificar los tickers:
BTCUSDT,BTC-USDT-SWAP,BTC, además de multiplicadores como1000PEPEen las monedas pequeñas; - respetar los rate limits de cada exchange y actualizar el código cuando cambie su API.
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.
| Endpoint | Contenido | Sección completa |
|---|---|---|
/funding/analytics/summary | Sumas, tasas medias a 8 horas, APR y cobertura para 7 periodos, de 1 día a un año | ~600 KB gzip |
/funding/analytics/recent | Todos los pagos de los últimos 7 días | ~1 MB gzip |
/funding/analytics/daily | Sumas diarias de 365 días | hasta ~12 MB gzip |
/funding/analytics/top | Top 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:
- la tasa cambia antes de la liquidación y puede cambiar de signo, y solo cobra la posición abierta en el momento de la liquidación;
- los precios de las patas divergen: si el precio del exchange short es inferior al del exchange long, la entrada empieza en negativo, así que comprueba
priceoprice_div; - comisiones y slippage: son cuatro operaciones, y en un libro de órdenes poco profundo la entrada cuesta más de lo que muestra la tabla;
- liquidación de una pata: el margen no se traslada entre exchanges, y la liquidación se activa con el precio de referencia (mark price);
- el exchange puede cambiar el intervalo o el tope de tasa de un contrato; en Binance esos contratos aparecen en
fundingInfo.
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.