Genesis Arbitrage

Genesis Arbitrage · · 13 min de lectura

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

EndpointQué devuelvePlanes de API
/market/fair-pricePrecio justo (mark) y última operaciónTrial, Start, Pro, Max
/market/pumpsPumps y dumps en CEXTrial, Start, Pro, Max
/market/dex-dumpsCaídas de tokens en DEXPro, Max
/market/open-interestInterés abierto por exchangeTrial, Start, Pro, Max
/ai/signalsSeñales de Genesis AI+Trial, Start, Pro, Max
/coins/searchFicha de una moneda en todos los exchangesTrial, 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ámetroTipoQué hace
exchangestringExchange; varios separados por comas
coinstringTicker de la moneda, p. ej. BTC
min_spreadnumberSpread absoluto mínimo, %
CampoTipoSignificado
fair_price / last_pricenumberPrecio mark y precio de la última operación
spread_pctnumberSpread entre ambos, %
fair_changes / last_changesobjectCambio 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ámetroTipoQué hace
exchangestringExchange; varios separados por comas
coinstringTicker de la moneda
min_changenumberUmbral absoluto de cambio de precio, %
CampoTipoSignificado
pricenumberPrecio actual
change_5s … change_1hnumberCambio de precio en el intervalo, %
volume_24hnumberVolumen de 24 h, USD
funding_pctnumber o nullTasa de financiación (funding) por período de liquidación, %
contract / networkstring o nullDirecció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ámetroTipoQué hace
chainstringRed, p. ej. bsc
min_liquiditynumberLiquidez mínima del pool, USD
CampoTipoSignificado
tsintHora del evento, segundos unix
price / liquidity_usdnumberPrecio y liquidez del pool, USD
market_capnumber o nullCapitalización de mercado, USD
price_changesobjectCambio de precio, %: m5, h1, h6 y h24
listed_on_cexbooleanSi la moneda cotiza en CEX
cex_spot / cex_futuresstring[]Exchanges con el spot y los futuros de la moneda
pool_urlstringEnlace 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ámetroTipoQué hace
coinstringTicker de la moneda
exchangestringExchange; varios separados por comas
CampoTipoSignificado
total.oi_usd / total.oi_tokensnumberInterés abierto en dólares y en monedas
total.avg_pricenumberPrecio medio ponderado por volumen entre exchanges
total.volume_24hnumberVolumen de 24 h, USD
total.oi_change_5m/15m/30m/1hnumberCambio del OI en el intervalo, %
total.price_change_5m/15m/30m/1hnumberCambio de precio en el intervalo, %
exchanges{}objectLas 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.

MonedaOI, 1 hPrecio, 1 hResultado
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.

  1. Pide la instantánea completa

    Una llamada sin filtros devuelve todas las monedas.

  2. 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.

  3. Aplica la condición

    oi_change_1h por encima de 5, price_change_1h por encima de 0.

  4. Comprueba la amplitud del movimiento

    Cuenta los exchanges de exchanges donde 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ámetroTipoQué hace
categorystringCalificación: alpha, high, middle, risky o noise
coinstringTicker de la moneda
CampoTipoSignificado
idstringIdentificador: tu bot lo usa para omitir repeticiones
ts / timeint / stringHora: segundos unix e ISO 8601
pipelinestringFuente de la señal
message_ru / message_enstring o nullTexto de la señal en ruso e inglés
linksarrayEnlaces 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.

CampoTipoSignificado
contracts[]arrayContratos: dirección, red y exchanges que lo usan
exchanges{}.spot_price / futures_pricenumber o nullPrecio spot y de futuros; null significa que no hay mercado
exchanges{}.deposit / withdrawboolean o nullSi los depósitos y los retiros están abiertos
fundingobject o nullResumen 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.