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-interestcubre 13+ exchanges, con la suma entotal, el desglose enexchangesy 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.
| Medida | Qué muestra | La trampa |
|---|---|---|
| OI en monedas | Cuántas posiciones hay abiertas | El tamaño del contrato varía según el exchange |
| OI en dólares | Cuánto dinero hay en posiciones | Se mueve con el precio |
| OI total | Posiciones en todo el mercado | Depende de qué exchanges se sumen |
| OI por exchange | Dónde se acumulan posiciones | Los 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:
| Exchange | OI actual | Historial de OI | Ojo con |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, un symbol por petición | GET /futures/data/openInterestHist | El historial cubre solo el último mes |
| Bybit | GET /v5/market/tickers, todos los símbolos en una petición | GET /v5/market/open-interest, pasos de 5min a 1d | openInterest cuenta ambos lados, singleOpenInterest uno |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi en contratos, oiCcy en monedas, oiUsd en dólares |
| Hyperliquid | POST /info, tipo metaAndAssetCtxs | No figura en la documentación | OI 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",
…
}
}
}
| Campo | Significado |
|---|---|
total.oi_usd / total.oi_tokens | OI total en dólares y en monedas |
total.avg_price | Precio medio de la moneda entre exchanges |
total.volume_24h | Volumen de 24 h, USD |
total.oi_change_5m/15m/30m/1h | Cambio del OI en 5, 15 y 30 minutos y 1 hora, % |
total.price_change_5m/15m/30m/1h | Cambio 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.
| Precio | OI | Lectura habitual | Qué comprobar |
|---|---|---|---|
| Sube | Sube | Posiciones nuevas en la dirección del movimiento, la subida está respaldada por dinero | Funding: muy positivo significa que hay exceso de largos |
| Baja | Sube | Se acumulan cortos, o hay largos comprando durante la caída | Funding: muy negativo significa riesgo de short squeeze |
| Sube | Baja | La subida se sostiene con cierres de cortos, sin dinero nuevo | Si el OI cae en todos los exchanges |
| Baja | Baja | Los largos se cierran, por decisión propia o a la fuerza | Un 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$.
| Exchange | Cuota de OI | OI 1 h | Precio 1 h |
|---|---|---|---|
| Binance | 46,2 % | +8,0 % | +3,0 % |
| ByBit | 27,0 % | +5,0 % | +3,1 % |
| OKX | 17,5 % | +2,0 % | +2,9 % |
| Bitget | 9,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
- Los métodos de los exchanges difieren. Bybit tiene dos campos de OI que difieren al doble, OKX cuenta
oien contratos cuyo tamaño fija el exchange, y el ticker de una misma moneda puede variar: PEPE en un exchange, 1000PEPE en otro. Los cambios porcentuales son la comparación más segura entre exchanges: no dependen de las unidades mientras cada exchange cuente igual de una lectura a la siguiente. - Los dólares dependen del precio. El
oi_usdde cada exchange es su OI en monedas por su propio precio, así que en un movimiento brusco el OI en dólares cambia aunque las posiciones sigan quietas. - Las liquidaciones provocan picos. En una cascada de liquidaciones los exchanges cierran posiciones a la fuerza: el OI cae varios puntos porcentuales en minutos mientras el precio se mueve con fuerza. Un desplome de
oi_change_5mjunto con unprice_change_5mbrusco es la firma de las liquidaciones. - Un OI pequeño genera porcentajes grandes. En una moneda con unos cientos de miles de dólares de OI, una sola posición lo mueve decenas de puntos porcentuales, y un umbral sobre
total.oi_usdfiltra ese ruido. - El total depende de qué exchanges incluya. Si una moneda obtiene futuros en un exchange más, el OI total crece gracias a la nueva plataforma aunque en las demás no haya cambiado nada. Contrasta el crecimiento del total con el desglose de
exchanges.
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.