Genesis Arbitrage

Genesis Arbitrage · · 15 min de lectura

API de interés abierto: OI de futuros por exchange y cómo leerlo

En resumen

  • El interés abierto es el volumen de posiciones de futuros que siguen abiertas. Medido en monedas, muestra la entrada de posiciones; medido en dólares, además se mueve con el precio.
  • Cada exchange publica el OI con su propio formato y sus propias unidades. En Genesis API una sola llamada a /market/open-interest cubre 13+ exchanges, con la suma en total, el desglose en exchanges y los cambios de OI y de precio a 5, 15 y 30 minutos y a 1 hora, en todos los planes.
  • Leído junto con el precio y el funding, el OI muestra quién está acumulando posiciones y quién paga por mantenerlas. No predice el precio; la decisión y la operación en el exchange siguen siendo tuyas.

Una API de interés abierto devuelve, para cada moneda, el volumen de posiciones abiertas de futuros, en monedas y en dólares, por exchange y en total, junto con su variación en los últimos minutos y horas. Los exchanges publican el OI de sus contratos a través de sus propias API, y los formatos cambian de un exchange a otro. En Genesis API toda la instantánea sale de una llamada a /market/open-interest: 13+ exchanges de futuros, entre ellos Binance, Bybit, OKX, Bitget y Gate, con cambios de OI y de precio a 5, 15 y 30 minutos y a 1 hora, en todos los planes, desde Trial a 20 $ al mes.

Qué es el interés abierto

El interés abierto (OI, por open interest) es el total de posiciones de un contrato de futuros que están abiertas y aún no se han cerrado. Cada contrato tiene dos lados, uno largo y otro corto, y el OI cuenta solo uno de ellos: un trader compra 1 BTC en largo, otro vende 1 BTC en corto, y el interés abierto crece en 1 BTC.

El OI sube cuando ambas partes de una operación abren posiciones, baja cuando ambas cierran, y no cambia cuando una posición pasa de un trader a otro. Por eso, un OI en alza significa que entran posiciones nuevas, y un OI a la baja, que se están cerrando posiciones, por voluntad propia o a la fuerza.

OI en monedas y en dólares

Los exchanges informan el OI en contratos, en monedas o directamente en dólares, y las monedas se convierten a dólares al precio. En la respuesta de ejemplo de Genesis API, el oi_usd de ByBit para GRAM es igual a oi_tokens por price: 16.159.003,8 × 1,6609 = 26.838.489,41.

La cifra en dólares es cómoda para comparar monedas y exchanges, pero se mueve con el precio. Ejemplo ilustrativo: un exchange tiene 2.000.000 de monedas en posiciones abiertas a 1,50 $, así que el OI es 2.000.000 × 1,50 $ = 3.000.000 $. Una hora después las posiciones no han cambiado, el precio es 1,65 $ y el OI en dólares ya es 2.000.000 × 1,65 $ = 3.300.000 $, un 10 % más sin una sola posición nueva.

OI total y desglose por exchange

El OI total de una moneda suma el OI de los exchanges que listan sus futuros y muestra cuánto dinero tiene el mercado en posiciones. El desglose muestra dónde está ese dinero: en la misma respuesta, ByBit concentra 26.838.489,41 / 96.544.685,3 × 100 = 27,8 % del OI en dólares de GRAM.

MedidaQué muestraLa trampa
OI en monedasCuántas posiciones hay abiertasEl tamaño del contrato varía según el exchange
OI en dólaresCuánto dinero hay en posicionesSe mueve con el precio
OI totalPosiciones en todo el mercadoDepende de qué exchanges se sumen
OI por exchangeDónde se acumulan posicionesLos métodos de los exchanges difieren

Qué devuelven las API de Binance, Bybit, OKX y Hyperliquid

Cada exchange publica el OI de sus contratos a través de su propia API. Esto es lo que dice la documentación oficial:

ExchangeOI actualHistorial de OIOjo con
BinanceGET /fapi/v1/openInterest, un symbol por peticiónGET /futures/data/openInterestHistEl historial cubre solo el último mes
BybitGET /v5/market/tickers, todos los símbolos en una peticiónGET /v5/market/open-interest, pasos de 5min a 1dopenInterest cuenta ambos lados, singleOpenInterest uno
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi en contratos, oiCcy en monedas, oiUsd en dólares
HyperliquidPOST /info, tipo metaAndAssetCtxsNo figura en la documentaciónOI de futuros perpetuos en una sola petición

Los detalles están en la documentación de Binance, Bybit, OKX y Hyperliquid. El historial de Binance llega como sumOpenInterest y sumOpenInterestValue, mientras que OKX devuelve las últimas 1.440 entradas en pasos desde 5 minutos. Hyperliquid acepta una petición a https://api.hyperliquid.xyz/info con el cuerpo {"type": "metaAndAssetCtxs"} y devuelve openInterest de cada perpetuo junto a markPx y funding.

La diferencia de método puede ser del doble. En la respuesta de ejemplo de /v5/market/open-interest de Bybit, openInterest es 63.910.691 y singleOpenInterest es 31.955.346, exactamente la mitad: el primero cuenta ambos lados, el segundo cuenta uno, como en la definición de OI de arriba.

Construir una instantánea por tu cuenta implica consultar cada exchange según sus reglas, convertir contratos a monedas y monedas a dólares, y respetar los límites de cada plataforma. En Binance eso exige una petición aparte por cada contrato.

Interés abierto en Genesis API: /market/open-interest

El endpoint /market/open-interest devuelve los mismos datos que la tabla OI Tracking del sitio: el OI total de cada moneda en total y el desglose por exchange en exchanges. Sin parámetros obtienes todas las monedas; coin deja una sola moneda, y exchange deja los exchanges elegidos, separados por comas si son varios.

curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

La respuesta es un array data. A continuación, uno de sus elementos tomado de la documentación, con algunos campos recortados:

{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_5m": 0.0196,
    "oi_change_1h": 0.3185,
    "price_change_5m": -0.0228,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_tokens": 16159003.8,
      "oi_change_1h": -0.097,
      "price_change_1h": -0.1683,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}
CampoSignificado
total.oi_usd / total.oi_tokensOI total en dólares y en monedas
total.avg_pricePrecio medio de la moneda entre exchanges
total.volume_24hVolumen de 24 h, USD
total.oi_change_5m/15m/30m/1hCambio del OI en 5, 15 y 30 minutos y 1 hora, %
total.price_change_5m/15m/30m/1hCambio del precio en los mismos intervalos, %
exchanges{}Las mismas métricas por exchange: price en lugar de avg_price, más trade_url

Los cambios son porcentajes: 0.3185 significa 0,3185 %. Los valores vacíos llegan como null, así que sáltalos. La frescura depende del plan: 60 s en Trial, 30 s en Start, 10 s en Pro y 5 s en Max, de modo que consultar con más frecuencia que meta.freshness_sec no aporta nada.

Una respuesta sin filtros incluye la cabecera ETag. Devuélvela en If-None-Match y una instantánea sin cambios vuelve como 304, que no consume tu cuota; el mecanismo se explica en ETag e If-None-Match. El filtro exchange recorta solo exchanges: total se sigue calculando con todos los exchanges.

Los campos, los parámetros y el formulario «Probar» están en la sección de documentación "OI Tracking". Todos los endpoints de mercado se recorren con ejemplos en la guía Datos de mercado de Genesis API.

Leer el OI junto con el precio: cuatro escenarios

Un OI en alza indica que se abren posiciones, pero no qué lado empuja. El precio en el mismo intervalo da la pista.

PrecioOILectura habitualQué comprobar
SubeSubePosiciones nuevas en la dirección del movimiento, la subida está respaldada por dineroFunding: muy positivo significa que hay exceso de largos
BajaSubeSe acumulan cortos, o hay largos comprando durante la caídaFunding: muy negativo significa riesgo de short squeeze
SubeBajaLa subida se sostiene con cierres de cortos, sin dinero nuevoSi el OI cae en todos los exchanges
BajaBajaLos largos se cierran, por decisión propia o a la fuerzaUn OI que se desploma en 5 minutos apunta a liquidaciones

En el ejemplo de la documentación, el OI total de GRAM subió un 0,32 % en una hora mientras el precio cayó un 0,19 %, lo que formalmente lo sitúa en la segunda fila. Pero las fracciones de punto porcentual por hora son ruido habitual: lee los escenarios con movimientos claros y en monedas con un OI grande.

OI y funding: quién mantiene posiciones y quién paga por ellas

La tasa de financiación (funding) muestra qué lado de los futuros perpetuos paga al otro, y el OI muestra cuántas posiciones hay abiertas. Juntos indican hacia dónde se inclina el mercado y cuánto apalancamiento soporta.

Un OI y un precio al alza con una tasa muy positiva significan que los largos añaden posiciones y pagan a los cortos por mantenerlas. Si el precio da la vuelta, sus liquidaciones aceleran la caída. Un OI y un precio al alza con una tasa negativa significan que los cortos se acumulan contra el movimiento, y una subida brusca puede cerrarlos a la fuerza.

Todas las combinaciones de funding, OI y precio están en La tasa de funding como indicador del mercado. En Genesis API, /funding/rates devuelve la tasa de cada exchange, también en todos los planes: la tasa por intervalo de funding (funding_pct) y la tasa normalizada a 8 horas (funding_8h_pct). Los endpoints de funding y el historial de funding liquidado se explican en API de tasas de funding, y los campos, en la documentación.

Python: OI con más de un 5 % de subida en una hora mientras sube el precio

El script obtiene toda la instantánea en una llamada y se queda con las monedas cuyo OI total creció más de un 5 % en una hora mientras el precio subía, con un OI de 5 M$ o más. Para cada una imprime el desglose por exchange: la cuota del exchange en el OI y sus cambios de OI y de precio en la hora. La clave sale de la variable de entorno GENESIS_API_KEY; con 429 y 503 el script espera Retry-After segundos y reintenta.

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000  # con OI pequeño una sola posición lo mueve mucho

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # límite de peticiones o reconstrucción de datos
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

def passes(t):
    oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or px is None:
        return False
    return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0

def pct(v):
    return "n/d" if v is None else f"{v:+.1f}%"

hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
    t = row["total"]
    print(f"{row['coin']}: OI {pct(t['oi_change_1h'])} en 1 h, "
          f"precio {pct(t['price_change_1h'])}, "
          f"total ${t['oi_usd'] / 1e6:.1f}M")
    exs = sorted(row["exchanges"].items(), reverse=True,
                 key=lambda kv: kv[1].get("oi_usd") or 0)
    for name, m in exs:
        share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
        print(f"  {name:<8} cuota {share:4.1f}%, "
              f"OI {pct(m.get('oi_change_1h'))}, "
              f"precio {pct(m.get('price_change_1h'))}")

Salida ilustrativa para la moneda XYZ: OI +6,2 % en una hora, precio +3,0 %, OI total 48,1 M$.

ExchangeCuota de OIOI 1 hPrecio 1 h
Binance46,2 %+8,0 %+3,0 %
ByBit27,0 %+5,0 %+3,1 %
OKX17,5 %+2,0 %+2,9 %
Bitget9,3 %+9,0 %+3,2 %

El crecimiento es amplio: el OI subió en los cuatro exchanges, y un 5 % o más en tres de ellos. Si el mismo +6,2 % hubiera venido de un solo exchange que hace una hora tenía el 10 % del OI de la moneda, su OI habría tenido que crecer un 62 %: 0,10 × 62 = 6,2. Un pico en una sola plataforma suele indicar a un único jugador grande, y es pronto para sacar conclusiones sobre el mercado a partir de él.

La segunda parte añade el funding: una llamada a /funding/rates para todas las monedas y, para cada moneda encontrada, la tasa de 8 horas más baja y más alta entre exchanges y en cuántos exchanges la tasa es positiva.

# tasas de funding de todos los exchanges: una llamada cubre todas las monedas
rates = {row["coin"]: row["exchanges"]
         for row in get("/funding/rates")}

for row in hits:
    fr = sorted((e["funding_8h_pct"], e["exchange"])
                for e in rates.get(row["coin"], [])
                if e.get("funding_8h_pct") is not None)
    if not fr:
        print(f"{row['coin']}: sin tasas de funding")
        continue
    (lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
    plus = sum(1 for rate, _ in fr if rate > 0)
    print(f"{row['coin']}: funding a 8 h {lo:+.4f}% ({lo_ex}) "
          f"a {hi:+.4f}% ({hi_ex}), positivo en {plus} de {len(fr)}")

El script hace dos llamadas. Ejecutado una vez por minuto, son 2 × 60 × 24 × 30 = 86.400 llamadas cada 30 días, menos de una quinta parte de la cuota de 500K del plan Trial. Para consultar en bucle sin gastar cuota en datos sin cambios, añade ETag e If-None-Match: las técnicas están en Cómo consultar una API sin chocar con los límites, y las cuotas y las peticiones por segundo, en la guía de límites de Genesis API.

Salvedades: qué distorsiona el interés abierto

Sin código, los mismos datos están en la tabla OI Tracking del sitio; sus columnas, filtros y gráficos se describen en la guía. Las cuotas y los precios de los planes de la API están en la página de precios de Genesis API.

Preguntas y respuestas

¿En qué se diferencia el interés abierto del volumen de operaciones?

El volumen es la suma de las operaciones en un período; el interés abierto son las posiciones que siguen abiertas ahora mismo. Cada operación cuenta para el volumen, pero cambia el OI solo cuando ambas partes abren o ambas cierran posiciones. Un volumen alto con OI plano significa que las posiciones sobre todo cambian de manos. La respuesta de /market/open-interest tiene ambas cifras: volume_24h y oi_usd.

¿Dónde consigo el historial del interés abierto?

Genesis API no tiene historial: el endpoint devuelve la instantánea actual y los cambios a 5, 15 y 30 minutos y a 1 hora, así que una serie larga se construye guardando respuestas. Los exchanges ofrecen historial en sus propias API: Binance, el último mes; Bybit, en pasos de 5 minutos a un día; OKX, las últimas 1.440 entradas. En el sitio, el botón Gráfico de OI Tracking abre un gráfico de OI en el plan Pro del sitio.

¿Con qué frecuencia se actualizan los datos de OI en Genesis API?

La frescura depende del plan de la API: 60 segundos en Trial, 30 en Start, 10 en Pro y 5 en Max. La hora de construcción de la instantánea está en meta.updated_at, y el retraso de tu plan, en meta.freshness_sec. Consultar más rápido que ese retraso no aporta nada, y con If-None-Match una instantánea sin cambios vuelve como 304, que no consume tu cuota.

¿Qué significa un interés abierto al alza con el precio a la baja?

Normalmente se abren cortos nuevos, o alguien compra largos contra el movimiento. Si a la vez el funding pasa a negativo, los cortos también pagan a los largos por mantener sus posiciones. Una reversión brusca al alza en ese punto puede obligar a cerrar a los cortos y acelerar la subida.