Datos de mercado de Genesis API: Fair – Last, pumps, OI, señales de IA, búsqueda
En resumen
- Seis endpoints de mercado reflejan el sitio: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, señales de Genesis AI+ y búsqueda de monedas. Todos salvo DEX Dumps están disponibles desde el plan Trial.
- Los cambios de precio y de interés abierto llegan como porcentajes ya calculados en intervalos de 5 segundos a una hora, así que no necesitas guardar tu propio historial para obtenerlos.
- Genesis API solo lee datos. Muestra movimientos y anomalías, mientras que la decisión de operar y la operación en el exchange siguen siendo tuyas.
Los endpoints de mercado de Genesis API devuelven los mismos datos que las secciones Fair – Last, CEX Pumps – Dumps, DEX Dumps y OI Tracking del sitio, además del feed de señales de Genesis AI+ y una ficha de moneda con todos los exchanges. Cada llamada es un HTTP GET con la clave en el encabezado X-API-Key y la respuesta en el sobre data y meta. Los desarrolladores usan estos datos para alertas de movimientos bruscos, monitores de interés abierto y revisiones de una moneda antes de operar.
Endpoints y planes
| Endpoint | Qué devuelve | Planes de API |
|---|---|---|
/market/fair-price | Precio justo (mark) y última operación | Trial, Start, Pro, Max |
/market/pumps | Pumps y dumps en CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Caídas de tokens en DEX | Pro, Max |
/market/open-interest | Interés abierto por exchange | Trial, Start, Pro, Max |
/ai/signals | Señales de Genesis AI+ | Trial, Start, Pro, Max |
/coins/search | Ficha de una moneda en todos los exchanges | Trial, Start, Pro, Max |
La URL base es https://api.genesisarbitrage.com/v1, y un endpoint fuera de tu plan devuelve 403 plan_restricted. El plan también fija la frescura de los datos: 60 s en Trial, 30 s en Start, 10 s en Pro y 5 s en Max. La clave y la primera petición están en el inicio rápido, las cuotas en los límites de Genesis API y los códigos de error en las respuestas y errores de Genesis API.
Fair – Last: /market/fair-price
Cada fila son los futuros de una moneda en un exchange: el precio mark (Fair), el precio de la última operación (Last) y el spread entre ambos. El precio mark es calculado, y en Binance Futures la liquidación se activa con él. Una diferencia amplia significa que las operaciones de un exchange movieron Last, o que el libro de órdenes se quedó sin órdenes. Cómo analizar estas filas se explica en la guía de Fair – Last, y los campos en la documentación.
| Parámetro | Tipo | Qué hace |
|---|---|---|
exchange | string | Exchange; varios separados por comas |
coin | string | Ticker de la moneda, p. ej. BTC |
min_spread | number | Spread absoluto mínimo, % |
| Campo | Tipo | Significado |
|---|---|---|
fair_price / last_price | number | Precio mark y precio de la última operación |
spread_pct | number | Spread entre ambos, % |
fair_changes / last_changes | object | Cambio de cada precio, %: s5, s10, s30 y m1, en 5, 10 y 30 segundos y un minuto |
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
-d exchange=ByBit \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
La opción -G mueve los parámetros -d a la URL de la petición. La respuesta es un array data; aquí y más abajo mostramos uno de sus elementos:
{
"exchange": "ByBit",
"coin": "0G",
"fair_price": 0.192,
"last_price": 0.192,
"spread_pct": 0.0,
"trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
"fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
"last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}
CEX Pumps – Dumps: /market/pumps
El endpoint refleja la tabla CEX Pumps – Dumps: el precio de una moneda en los futuros de un exchange y su cambio en ocho intervalos, en los campos change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m y change_1h. Una petición con min_change=5 conserva las monedas que se movieron un 5 % o más, en cualquier dirección, en al menos un intervalo. Todos los campos están en la documentación del endpoint.
| Parámetro | Tipo | Qué hace |
|---|---|---|
exchange | string | Exchange; varios separados por comas |
coin | string | Ticker de la moneda |
min_change | number | Umbral absoluto de cambio de precio, % |
| Campo | Tipo | Significado |
|---|---|---|
price | number | Precio actual |
change_5s … change_1h | number | Cambio de precio en el intervalo, % |
volume_24h | number | Volumen de 24 h, USD |
funding_pct | number o null | Tasa de financiación (funding) por período de liquidación, % |
contract / network | string o null | Dirección del contrato y red del token |
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
-d coin=BTC -d exchange=MEXC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"exchange": "MEXC",
"coin": "BTC",
"price": 64267.9,
"change_5s": 0.0,
"change_10s": 0.0,
"change_30s": 0.02,
"change_60s": 0.06,
"change_5m": 0.08,
"change_15m": -0.06,
"change_30m": -0.09,
"change_1h": -0.2,
"volume_24h": 2243246205,
"funding_pct": 0.01,
"network": "BNB Smart Chain(BEP20)",
"trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}
DEX Dumps: /market/dex-dumps
Planes Pro y Max. El endpoint devuelve caídas de tokens en DEX, como la sección DEX Dumps, con la liquidez del pool y un indicador de si el token cotiza en CEX. El esquema de la respuesta está en la documentación.
| Parámetro | Tipo | Qué hace |
|---|---|---|
chain | string | Red, p. ej. bsc |
min_liquidity | number | Liquidez mínima del pool, USD |
| Campo | Tipo | Significado |
|---|---|---|
ts | int | Hora del evento, segundos unix |
price / liquidity_usd | number | Precio y liquidez del pool, USD |
market_cap | number o null | Capitalización de mercado, USD |
price_changes | object | Cambio de precio, %: m5, h1, h6 y h24 |
listed_on_cex | boolean | Si la moneda cotiza en CEX |
cex_spot / cex_futures | string[] | Exchanges con el spot y los futuros de la moneda |
pool_url | string | Enlace al pool |
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
-d chain=bsc -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783203653,
"coin": "ONLY",
"chain": "bsc",
"price": 0.00009884,
"liquidity_usd": 30477.58,
"market_cap": 98840,
"price_changes": {
"m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
},
"pool_url": "https://dexscreener.com/bsc/0x2a18…",
"listed_on_cex": false,
"cex_spot": [],
"cex_futures": []
}
OI Tracking: /market/open-interest
El interés abierto (OI) es el volumen de posiciones de futuros abiertas y aún no cerradas. El endpoint lo devuelve como la tabla OI Tracking: el total de la moneda en total y el desglose por exchange en exchanges. Los datos cubren más de 13 exchanges de futuros, entre ellos Binance, Bybit, OKX, Bitget y Gate. Hay una visión general en el artículo sobre la API de interés abierto y los campos en la documentación.
| Parámetro | Tipo | Qué hace |
|---|---|---|
coin | string | Ticker de la moneda |
exchange | string | Exchange; varios separados por comas |
| Campo | Tipo | Significado |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Interés abierto en dólares y en monedas |
total.avg_price | number | Precio medio ponderado por volumen entre exchanges |
total.volume_24h | number | Volumen de 24 h, USD |
total.oi_change_5m/15m/30m/1h | number | Cambio del OI en el intervalo, % |
total.price_change_5m/15m/30m/1h | number | Cambio de precio en el intervalo, % |
exchanges{} | object | Las mismas métricas por exchange: price en lugar de avg_price, más trade_url |
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
-d coin=GRAM \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "GRAM",
"total": {
"oi_usd": 96544685.3,
"oi_tokens": 58105803.3,
"avg_price": 1.661224,
"volume_24h": 47010004.63,
"oi_change_1h": 0.3185,
"price_change_1h": -0.1929,
…
},
"exchanges": {
"ByBit": {
"price": 1.6609,
"oi_usd": 26838489.41,
"oi_change_1h": -0.097,
"trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
…
}
}
}
Ejemplo hipotético: OI al alza más de un 5 % en una hora, junto con el precio
Buscas monedas que atrajeron posiciones nuevas durante la última hora mientras el precio subía: total.oi_change_1h por encima de 5 y total.price_change_1h por encima de 0. Ambos campos ya vienen en porcentaje.
Hace una hora la moneda A tenía 40 000 000 $ de OI y ahora tiene 42 600 000 $: (42 600 000 − 40 000 000) / 40 000 000 × 100 = 6,5 %. En la misma hora el precio subió de 2,00 $ a 2,056 $: (2,056 − 2,00) / 2,00 × 100 = 2,8 %. En la respuesta esto aparece como oi_change_1h: 6.5 y price_change_1h: 2.8.
| Moneda | OI, 1 h | Precio, 1 h | Resultado |
|---|---|---|---|
| A | +6,5 % | +2,8 % | Cumple |
| B | +7,2 % | −1,9 % | No: el OI sube contra el precio |
| C | +3,1 % | +4,0 % | No: OI por debajo del umbral |
La moneda B tiene el OI al alza con el precio a la baja, lo que suele significar que se están abriendo cortos. Que el OI suba junto con el precio no promete continuidad: un mercado sobrecalentado puede revertirse en una cascada de liquidaciones.
Pide la instantánea completa
Una llamada sin filtros devuelve todas las monedas.
Descarta las monedas pequeñas
Fija un umbral de
total.oi_usd, p. ej. 5 000 000 $: con un OI pequeño, un par de posiciones grandes producen un porcentaje enorme.Aplica la condición
oi_change_1hpor encima de 5,price_change_1hpor encima de 0.Comprueba la amplitud del movimiento
Cuenta los exchanges de
exchangesdonde el OI también creció más de un 5 %: el crecimiento en varios mercados pesa más.
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 # omitir monedas pequeñas
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 o reconstrucción
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
for row in get("/market/open-interest"):
t = row["total"]
oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
if oi is None or price is None:
continue
if (t.get("oi_usd") or 0) < MIN_OI_USD:
continue
if oi > 5 and price > 0:
wide = [ex for ex, m in row["exchanges"].items()
if (m.get("oi_change_1h") or 0) > 5]
print(f"{row['coin']}: OI {oi:+.1f}%, precio {price:+.1f}%, "
f"exchanges con crecimiento de OI: {len(wide)}")
Señales de Genesis AI+: /ai/signals
Genesis AI+ revisa las señales de arbitraje y puntúa cada una de alpha a noise. El endpoint devuelve ese feed con el texto en ruso e inglés y enlaces a los mercados. category acepta un solo valor: para alpha y high, haz dos peticiones o filtra la respuesta por tu lado. Las descripciones de los campos están en la documentación.
| Parámetro | Tipo | Qué hace |
|---|---|---|
category | string | Calificación: alpha, high, middle, risky o noise |
coin | string | Ticker de la moneda |
| Campo | Tipo | Significado |
|---|---|---|
id | string | Identificador: tu bot lo usa para omitir repeticiones |
ts / time | int / string | Hora: segundos unix e ISO 8601 |
pipeline | string | Fuente de la señal |
message_ru / message_en | string o null | Texto de la señal en ruso e inglés |
links | array | Enlaces listos: texto + url |
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
-d coin=UTYA \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "1783198680493",
"ts": 1783198680,
"time": "2026-07-04T20:58:00Z",
"coin": "UTYA",
"pipeline": "public",
"category": "noise",
"message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
"message_en": "Checked UTYA — DEX against MEXC Futures…",
"links": [
{
"text": "MEXC Futures",
"url": "https://futures.mexc.com/exchange/UTYA_USDT"
}
]
}
Búsqueda de monedas: /coins/search
El endpoint devuelve una ficha de moneda, como Coin Search en el sitio: contratos por red, precios spot y de futuros, estado de depósitos y retiros en cada exchange y un resumen de funding. El ticker va en el parámetro obligatorio query, y una moneda desconocida devuelve 404 not_found. Aquí data es un único objeto. Los campos están en la documentación.
| Campo | Tipo | Significado |
|---|---|---|
contracts[] | array | Contratos: dirección, red y exchanges que lo usan |
exchanges{}.spot_price / futures_price | number o null | Precio spot y de futuros; null significa que no hay mercado |
exchanges{}.deposit / withdraw | boolean o null | Si los depósitos y los retiros están abiertos |
funding | object o null | Resumen de funding; null significa que no hay futuros |
Un mismo ticker puede ser tokens distintos en exchanges distintos: antes de una transferencia, compara la dirección de contracts[] con el contrato de la página de depósito del exchange.
curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
-d query=IRYS \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true,
"spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
…
}
},
"funding": {
"spread_pct": 0.0,
"best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
}
}
Preguntas y respuestas
¿Qué endpoints de mercado están en el plan Trial?
Todos salvo DEX Dumps: ese endpoint está abierto en Pro y Max y devuelve 403 plan_restricted en Trial y Start.
¿La API tiene historial de interés abierto?
No: el endpoint devuelve la instantánea actual con cambios en 5, 15 y 30 minutos y una hora, y Genesis API no tiene velas históricas. Construye el historial tú mismo guardando las respuestas.
¿Puedo abrir operaciones con estos endpoints?
No. Genesis API solo lee datos y no envía órdenes: la operación la abres tú en el exchange.
¿Con qué frecuencia debo consultar los endpoints de mercado?
No más a menudo que meta.freshness_sec: de 60 s en Trial a 5 s en Max. Una respuesta sin filtros incluye el encabezado ETag. Devuélvelo en If-None-Match y, mientras los datos no cambien, el servidor responde 304, que no consume tu cuota.