Endpoints de funding de Genesis API: tasas, spread y analítica del historial de funding
En resumen
/funding/ratesy/funding/spreadestán en todos los planes de la API: la tasa de cada exchange por intervalo y por 8 horas, la hora del próximo pago y el mejor par de exchanges por spread.- La analítica del funding liquidado son cuatro endpoints
/funding/analytics/…con 13 exchanges y hasta un año de historial, en los planes Pro y Max. - Las descargas completas de summary, recent y daily pesan hasta ~12 MB en gzip y se permiten una vez cada 60–300 segundos: pide un corte por
coino repite la petición conIf-None-Match.
La API de tasas de funding de Genesis API es un conjunto de endpoints con las tasas de funding de los futuros perpetuos en distintos exchanges, el mejor par de exchanges por spread de funding y el historial del funding liquidado. Las tasas actuales y el spread están en todos los planes de la API; la analítica histórica de 13 exchanges, en Pro y Max. El sitio muestra los mismos datos en Funding Arbitrage, consulta la guía.
Endpoints de funding y planes
| Endpoint | Qué devuelve | Planes de la API |
|---|---|---|
/funding/rates | Tasas de cada exchange por moneda | Trial, Start, Pro, Max |
/funding/spread | El mejor par de exchanges por spread y los demás exchanges | Trial, Start, Pro, Max |
/funding/analytics/summary | Resumen de periodos de 1 día a un año | Pro, Max |
/funding/analytics/recent | Todos los pagos de 7 días | Pro, Max |
/funding/analytics/daily | Sumas diarias de 365 días | Pro, Max |
/funding/analytics/top | Screener de pares y combinaciones de exchanges | Pro, Max |
Los parámetros y campos están en las secciones de la documentación Tasas de funding, Spread de funding y Funding analytics. En Trial y Start los endpoints de analítica devuelven 403 plan_restricted. Para una visión general de las API de datos de funding, consulta el artículo sobre la API de tasas de funding. Los ejemplos de respuesta de abajo muestran el campo data, abreviado.
Tasas y normalización a 8 horas
/funding/rates devuelve, por cada moneda, una lista de exchanges con la tasa actual. Los filtros coin y exchange (separados por comas si son varios exchanges) son opcionales.
curl "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"
}
]
}
| Campo | Significado |
|---|---|
funding_pct | Tasa por intervalo de liquidación, % |
funding_8h_pct | Tasa normalizada a 8 horas, % |
interval | Intervalo de liquidación, p. ej. 8h; null: sin datos |
next_payout | Hora del próximo pago, HH:MM UTC; null: sin datos |
price, trade_url | Precio y enlace al terminal de trading del exchange |
Un ejemplo hipotético: una tasa horaria de 0,005 % son 0,005 × 8 / 1 = 0,04 % por 8 horas, igual que MEXC, solo que paga ocho veces y puede cambiar en la hora siguiente.
Anualizada sin capitalización, la tasa a 8 horas × 3 × 365 da el APR. Un ejemplo hipotético: 0,01 % cada 8 horas da 0,01 × 3 × 365 = 10,95 % anual, mientras la tasa se mantenga. Qué dice la tasa sobre el mercado se explica en La tasa de funding como indicador del mercado.
Spread de funding: el mejor par de exchanges
/funding/spread devuelve, por cada moneda, el mejor par de exchanges por spread de funding (best) y los demás exchanges (others). Filtros: coin y min_spread, el spread mínimo en %.
{
"coin": "BTC",
"spread_pct": 0.01,
"best": {
"exchange_1": "Hyper",
"exchange_2": "CoinEx",
"funding_1_pct": 0.0,
"funding_2_pct": 0.0,
"next_payout_1": null,
"next_payout_2": "08:00",
"interval_1": "1h",
"interval_2": "8h",
"trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
"trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
},
"others": [ … ]
}
spread_pct es el spread del mejor par, %. funding_1_pct y funding_2_pct son tasas por su propio intervalo (interval_1, interval_2): para compararlas a mano, normaliza ambas a 8 horas. El short va donde la tasa es más alta y el long donde es más baja. Hyperliquid aparece como Hyper en las respuestas.
El script de Python muestra las diez monedas con mayor spread_pct (desde 0,05 %) y los intervalos de liquidación del par. Ante 429 y 503 espera Retry-After segundos; en un bucle, repite la petición como máximo una vez por meta.freshness_sec.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
for _ in range(3):
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 0.05}, timeout=15)
if r.status_code not in (429, 503):
break
# límite de peticiones o datos en reconstrucción: espera y reintenta
time.sleep(int(r.headers.get("Retry-After", "5")))
r.raise_for_status()
rows = sorted(r.json()["data"], key=lambda x: x["spread_pct"],
reverse=True)
for row in rows[:10]:
b = row["best"]
print(f'{row["coin"]:<10} {row["spread_pct"]:>8.4f}% '
f'{b["exchange_1"]} {b["interval_1"]} / '
f'{b["exchange_2"]} {b["interval_2"]}')
Analítica del funding liquidado
Cuatro endpoints /funding/analytics/… devuelven el historial del funding liquidado de 13 exchanges: los mismos datos que la pestaña Analítica de Funding Arbitrage. Las tasas son porcentajes por periodo de liquidación y las marcas de tiempo son segundos epoch UTC.
| Endpoint | Contenido | Sección completa | Sin coin, como máximo |
|---|---|---|---|
/funding/analytics/summary | Sumas, tasas medias, APR y cobertura de 7 periodos | ~600 KB gzip | una vez cada 60 s |
/funding/analytics/recent | Todos los pagos de 7 días | ~1 MB gzip | una vez cada 60 s |
/funding/analytics/daily | Sumas diarias de 365 días | hasta ~12 MB gzip | una vez cada 300 s |
/funding/analytics/top | Top 50 de pares y top 50 de combinaciones por periodo | — | sin límite |
Una descarga completa antes de que termine la ventana recibe 429 con Retry-After. Las reglas de ETag y compresión están en la guía formato de respuesta y errores.
curl --compressed -i \
"https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-H "If-None-Match: <ETag from the previous response>"
--compressed pide una respuesta comprimida y la descomprime, y -i imprime las cabeceras, entre ellas ETag. Envía la primera petición sin If-None-Match.
El summary y el array m
Cada par moneda×exchange del summary tiene m: la clave es un periodo (1d, 3d, 7d, 30d, 90d, 180d, 365d) y el valor son 14 números en el orden de metric_order. Un periodo no aparece en m cuando no hay datos para él.
{
"metric_order": ["sum", "avg8h", "apr", "n", "pos", "neg", "zero",
"min", "max", "cov", "med8h", "pos_streak",
"neg_streak", "flips"],
"coins": {
"BTC": {
"canon": "BTC",
"mult": 1,
"exchanges": {
"Binance": {
"interval_h": 8.0,
"data_since": 1568102400,
"last8h": 0.004123,
"m": {
"7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0,
0.000125, 0.01, 1.0, 0.00588, 7, 0, 0]
}
}
}
}
}
}
| Métrica | Índice | Significado |
|---|---|---|
sum | 0 | Acumulado en el periodo, % |
avg8h | 1 | Tasa media en términos de 8 horas, % |
apr | 2 | Anualizado, % |
n | 3 | Número de liquidaciones |
pos, neg, zero | 4–6 | Liquidaciones positivas, negativas y nulas |
min, max | 7–8 | La liquidación menor y la mayor, % |
cov | 9 | Cobertura del periodo de 0 a 1 |
med8h | 10 | Mediana en términos de 8 horas, % |
pos_streak, neg_streak | 11–12 | Días seguidos positivos y negativos |
flips | 13 | Cambios de signo |
Los índices 10–13 son null en los periodos 1d y 3d. Con cov < 0,9 los datos cubren solo parte del periodo, así que marca esos valores. En el ejemplo, BTC en Binance a 7 días: 21 liquidaciones, todas positivas, cov 1,0, y apr es igual a avg8h × 3 × 365: 0,006298 × 1095 ≈ 6,896.
Si avg8h supera con claridad a med8h, un pico ha inflado la media: la mediana, pos_streak y flips muestran mejor la estabilidad. Los demás campos del par:
data_since: cuándo empiezan los datos; no dibujes ceros antes de esa fecha.last8h: la última tasa en términos de 8 horas, para comparar «ahora frente a lo habitual».interval_h: intervalo de liquidación: 8 o 4 horas en los CEX, 1 hora en Hyperliquid y Lighter.canonymult: el nombre que une variantes del ticker (1000PEPE→PEPE) y el multiplicador del contrato;multnunca se aplica a las tasas.
Pagos de 7 días y sumas diarias
En /funding/analytics/recent cada exchange tiene una cadena s con la forma ts:rate;ts:rate;… en orden ascendente de tiempo y un intervalo i en horas. En /funding/analytics/daily la cadena day_ts:sum:pos:neg;… contiene la medianoche UTC, la suma del día y el número de liquidaciones positivas y negativas.
def parse_recent(s):
# "ts:rate;ts:rate;…" → [(ts, rate), …]
return [(int(t), float(v)) for t, v in
(p.split(":") for p in s.split(";") if p)]
def parse_daily(s):
# "day_ts:sum:pos:neg;…" → [(day, sum, positive, negative), …]
out = []
for p in filter(None, s.split(";")):
d, total, pos, neg = p.split(":")
out.append((int(d), float(total), int(pos), int(neg)))
return out
Screener de combinaciones
/funding/analytics/top es un screener ya preparado y sin parámetros: por cada periodo, el top 50 de pares moneda×exchange por funding acumulado y el top 50 de combinaciones short/long. Las patas de una combinación están siempre en exchanges distintos, con cobertura de al menos 0,9, y nunca aparecen filas con net ≤ 0.
by_net_apr: por rendimiento neto.by_stable:win_rate≥ 0,7 y una caída máxima no mayor que la mitad del bruto.by_live:live_8h> 0 ytrend_1d> 0.by_sum_pos,by_sum_neg: tops de un solo exchange por funding acumulado, solo concov≥ 0,5.
| Campo de la combinación | Significado |
|---|---|
gross, fees, net | Funding bruto, las comisiones de cuatro operaciones según taker_fees y net = gross − fees |
apr_net, apr_capital | Anualizado sobre el nominal de una pata, y apr_net / 2 sobre el capital de ambas patas |
win_rate, max_dd | Proporción de días con ganancia (0..1) y la caída máxima del resultado acumulado |
worst_streak, risk_days | La racha más larga de días con pérdida y los días sobre los que se midió el riesgo, máx. 90 |
live_8h, trend_1d, trend_7d | La diferencia actual de tasas a 8 horas y el spread bruto del último día y de la última semana |
price_div | La diferencia actual de precio entre las patas; null si no hay precios |
short_sym, long_sym | Tickers reales de las patas en los exchanges, que pueden diferir: PEPE y 1000PEPE |
En el ejemplo de la documentación, la combinación de PEPE (short en HTX, long en Hyperliquid) obtuvo un gross de 1,51504 % en 7 días. Las comisiones son 0,05 % por abrir y por cerrar en HTX y 0,045 % por cada una en Hyperliquid: 0,05 × 2 + 0,045 × 2 = 0,19.
Así, net = 1,51504 − 0,19 = 1,32504 %, apr_net = 1,32504 × 365 / 7 ≈ 69,09 %, apr_capital = 69,09 / 2 ≈ 34,55 %. No se incluyen la diferencia de precio entre las patas, el slippage ni el margen.
Cómo montar un monitor de funding
Busca candidatos
Pide
/funding/spreadconmin_spread(cualquier plan de la API) y ordena porspread_pct.Comprueba tasas y pagos
Pide
/funding/ratesconcoin:interval,next_payoutyfunding_8h_pcten ambos exchanges. La posición tiene que estar abierta en el momento de la liquidación.Mira el historial
En Pro y Max, pide
/funding/analytics/summaryconcoin:sum,apr,covyflipsde 7d y 30d muestran si la diferencia de tasas se mantiene.Evalúa la combinación completa
En
/funding/analytics/top, comparanet,apr_capital,win_rate,max_ddy elprice_divactual.Abre las posiciones tú mismo
Los enlaces
trade_urlllevan a los terminales de los exchanges; calcula el precio de la combinación con comisiones en la calculadora de spread.
Preguntas y respuestas
¿Cómo normalizo una tasa de funding a 8 horas?
Multiplica la tasa por intervalo por 8 y divide por la duración del intervalo en horas. /funding/rates lo hace por ti en el campo funding_8h_pct.
¿Dónde consigo el historial de tasas de funding?
/funding/analytics/recent tiene todos los pagos de 7 días, /funding/analytics/daily las sumas diarias de un año y /funding/analytics/summary los totales por periodo. Los tres están en los planes Pro y Max de la API.
¿Por qué una sección completa de analítica devuelve 429?
Las descargas completas sin coin están limitadas: summary y recent una vez cada 60 segundos, daily una vez cada 300 segundos por clave. Los cortes por moneda y las respuestas 304 a If-None-Match no tienen límite.