Endpoints de arbitraje de Genesis API: CEX, DEX, cross-chain y acciones
En resumen
- Siete endpoints devuelven los pares de las tablas del sitio: los tres conjuntos CEX están en todos los planes, las acciones desde Start, y DEX – Spot, DEX – Futures y Cross-chain en Pro y Max.
- Una fila CEX incluye los precios y las mejores cotizaciones de ambos exchanges, la red, el contrato, el estado de depósitos y retiros y los volúmenes: los campos para elegir pares que realmente puedas ejecutar.
- El spread de la respuesta es la diferencia de precio en el momento del snapshot: no descuenta comisiones, transferencias ni slippage.
Los endpoints de arbitraje de Genesis API devuelven los mismos pares que las tablas de Genesis Arbitrage: spreads entre mercados spot y de futuros de CEX, entre DEX y CEX, entre redes y en acciones tokenizadas. Cada elemento de data es un par: dónde comprar, dónde vender, el spread —la diferencia de precio en porcentaje— y los campos para comprobarlo: estado de depósitos y retiros, volúmenes, liquidez, enlaces. Los siete endpoints son peticiones GET con la clave en el encabezado X-API-Key.
Siete endpoints y planes
| Endpoint | Qué devuelve | Planes |
|---|---|---|
/arbitrage/spot-spot | Spreads entre mercados spot de CEX | Trial, Start, Pro, Max |
/arbitrage/spot-futures | Spot frente a futuros en CEX | Trial, Start, Pro, Max |
/arbitrage/futures-futures | Futuros entre exchanges CEX | Trial, Start, Pro, Max |
/arbitrage/dex-spot | Precio en DEX frente a spot de CEX | Pro, Max |
/arbitrage/dex-futures | Precio en DEX frente a futuros de CEX | Pro, Max |
/arbitrage/crosschain | Un token en DEX entre redes | Pro, Max |
/arbitrage/stocks | Acciones tokenizadas, metales, índices y materias primas en CEX | Start, Pro, Max |
Un endpoint fuera de tu plan devuelve 403 plan_restricted; los códigos de error están en Respuestas y errores de Genesis API y los precios, en la página de precios de Genesis API.
CEX: Spot – Spot, Spot – Futures, Futures – Futures
Los tres endpoints CEX aceptan los mismos parámetros y devuelven filas con el mismo formato. Los campos market_buy y market_sell indican el mercado de cada lado: spot y spot, spot y futures, o futures y futures.
| Parámetro | Tipo | Qué hace | Ejemplo |
|---|---|---|---|
coin | string | Filtra por ticker de la moneda | coin=BTC |
exchange | string | Filtra por exchange; varios separados por comas | exchange=Binance,OKX |
min_spread | number | Spread mínimo, % | min_spread=1 |
min_volume | number | Volumen mínimo de 24 h en ambos lados, USD | min_volume=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
-d min_spread=1 -d min_volume=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
-d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
-d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Una fila de respuesta de la documentación de Spot — Spot, abreviada:
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"ask_buy": 0.0007029,
"bid_sell": 0.0007021,
"spread_pct": 0.11,
"network": "ETH",
"contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
"volume_24h_buy": 17652.64,
"volume_24h_sell": 12512.51,
"trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
…
}
| Campo | Tipo | Contenido |
|---|---|---|
exchange_buy, exchange_sell | string | Exchange de compra y exchange de venta |
market_buy, market_sell | string | Mercado del lado: spot o futures |
price_buy, price_sell | number | Precios con los que se calcula el spread |
bid_*, ask_* | number o null | Mejor bid y ask de cada lado |
spread_pct | number | Spread, % |
network, contract | string; string o null | Red del token y dirección del contrato |
deposit_enabled_*, withdraw_enabled_* | boolean | Si los depósitos y retiros están abiertos en cada exchange |
volume_24h_buy, volume_24h_sell | number o null | Volumen de 24 h, USD |
trade_url_buy, trade_url_sell | string | Enlaces a las terminales de trading |
spread_pct se calcula a partir de price_buy y price_sell: la columna Precio del sitio, la última operación. La operación en sí pasa por el libro de órdenes: compras a ask_buy y vendes a bid_sell. En el ejemplo bid_sell queda por debajo de ask_buy, así que con las mejores cotizaciones el par es negativo:
(0,0007021 − 0,0007029) / 0,0007029 × 100 ≈ −0,11 %
La diferencia exacta para tu volumen sale de Order-book Δ — GET /orderbooks/spreads/{dataset}, descrito en la guía de endpoints de libros de órdenes.
Pares Spot – Spot transferibles
Un par spot entre exchanges solo funciona si la moneda se puede mover: comprarla en un exchange, retirarla y acreditarla en el otro. Para eso hacen falta retiros abiertos en el exchange de compra (withdraw_enabled_buy) y depósitos abiertos en el de venta (deposit_enabled_sell). La petición no tiene parámetros para estos indicadores, así que se filtran en el código, mientras que min_volume descarta en el servidor las monedas ilíquidas.
import os
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 1, "min_volume": 50000},
timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]
# La transferencia funciona solo si los retiros están abiertos en el
# exchange de compra y los depósitos en el exchange de venta
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)
for x in ok[:10]:
print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
f'{x["exchange_sell"]} {x["spread_pct"]}% '
f'network {x["network"]}')
Los reintentos ante 429 y 503 se hacen con la función get_json de Respuestas y errores de Genesis API. Un bot que envía estos pares a Telegram se construye en el artículo bot de arbitraje cripto en Python.
DEX – Spot y DEX – Futures
Los conjuntos DEX comparan el precio de un token en un DEX, un exchange descentralizado, con su precio en un CEX: DEX – Spot frente a spot, DEX – Futures frente a futuros. Ambos endpoints están en los planes Pro y Max.
| Parámetro | Tipo | Qué hace | Ejemplo |
|---|---|---|---|
coin | string | Filtra por ticker de la moneda | coin=SCR |
exchange | string | Exchange CEX; varios separados por comas | exchange=MEXC |
min_spread | number | Spread mínimo, % | min_spread=2 |
min_liquidity | number | Liquidez mínima, USD | min_liquidity=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d min_spread=2 -d min_liquidity=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
-d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Una fila de DEX – Spot de la documentación, abreviada:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
"gmgn_url": null,
…
}
El precio en MEXC está por encima del precio del pool, así que el spread es positivo. El signo de spread_pct marca la dirección: el signo más significa que el token es más barato en el DEX, así que compras allí y vendes en el CEX; el signo menos, lo contrario.
| Campo | Tipo | Contenido |
|---|---|---|
exchange | string | Exchange CEX |
cex_price, dex_price | number | Precio en el CEX y en el DEX |
liquidity_usd | number | Liquidez del pool, USD |
market_cap, dex_volume_24h | number o null | Capitalización de mercado y volumen de 24 h en el DEX (DEX – Spot) |
ticker, max_position_usd | string; number o null | Par del exchange y posición máxima, USD (DEX – Futures) |
deposit_enabled, withdraw_enabled | boolean | Si los depósitos y retiros están abiertos en el CEX |
dexscreener_url, dextools_url, gmgn_url | string o null | Enlaces a DexScreener, DEXTools y GMGN |
El pool del ejemplo tiene 10.544 USD de liquidez, así que una compra grande moverá su precio. El slippage para volúmenes de 100 a 100.000 USD, los impuestos del token y la marca de honeypot por contrato salen de GET /orderbooks/dex-slippage en los planes Pro y Max.
Cross-chain: un token entre redes
GET /arbitrage/crosschain compara el precio en DEX de un token entre blockchains, en los planes Pro y Max. Una fila contiene coin, spread_pct y dos objetos con los mismos campos: buy, el lado donde el token es más barato, y sell, donde cuesta más. El token se mueve entre redes mediante un puente cross-chain.
| Parámetro | Tipo | Qué hace | Ejemplo |
|---|---|---|---|
coin | string | Filtra por ticker del token | coin=WLD |
chain | string | Filtra por red | chain=ethereum |
min_spread | number | Spread mínimo, % | min_spread=1 |
min_liquidity | number | Liquidez mínima, USD | min_liquidity=20000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
-d coin=WLD -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Una fila de la documentación de Cross-chain, abreviada:
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
…
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"price_usd": 0.4072,
"liquidity_usd": 421426,
…
}
}
| Campo | Tipo | Contenido |
|---|---|---|
buy.chain | string | Red del lado |
buy.pair | string | Par del DEX, como WLD/USDC |
buy.contract | string | Dirección del contrato en esa red |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Precio, liquidez del pool y volumen de 24 h, USD |
buy.pool_created_at | string o null | Fecha de creación del pool |
buy.dexscreener_url, dextools_url, gmgn_url | string o null | Enlaces a DexScreener, DEXTools y GMGN |
sell tiene los mismos campos. pool_created_at es una cadena de fecha UTC, no segundos unix como la mayoría de las marcas de tiempo de la API, y puede ser null. Un pool creado hace unos días es motivo para revisar los contratos de ambos lados: en una red nueva puede haber otro token tras el mismo ticker.
Arbitraje de acciones: acciones, metales, índices, materias primas
GET /arbitrage/stocks devuelve spreads de acciones tokenizadas, metales, índices y materias primas entre exchanges CEX y está disponible desde el plan Start.
| Parámetro | Tipo | Qué hace | Ejemplo |
|---|---|---|---|
symbol | string | Filtra por ticker del instrumento | symbol=BRENT |
category | string | Categoría: Stock, Metal, Index o Commodity | category=Commodity |
exchange | string | Filtra por exchange; varios separados por comas | exchange=MEXC |
min_spread | number | Spread mínimo, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Una fila de la documentación de arbitraje de acciones, abreviada:
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"spread_pct": 0.18,
…
}
symbol es el ticker común del instrumento, mientras que symbol_on_buy y symbol_on_sell son sus nombres en cada exchange: en el ejemplo el petróleo Brent cotiza como UKOIL en MEXC y como BRENTOIL en Ourbit. Busca el instrumento en el exchange por symbol_on_*. La fila no tiene red, contrato ni campos de depósito: en CEX estos instrumentos se negocian como futuros perpetuos y el par se abre con posiciones Long y Short (guía de la tabla).
Respuestas de la API y tablas del sitio
Las columnas de las tablas del sitio se explican en las guías:
| Endpoint | Tabla del sitio y su guía |
|---|---|
/arbitrage/spot-spot | Spot – Spot |
/arbitrage/spot-futures | Spot – Futures |
/arbitrage/futures-futures | Arbitraje de futuros |
/arbitrage/dex-spot | DEX – Spot |
/arbitrage/dex-futures | DEX – Futures |
/arbitrage/crosschain | Crosschain |
/arbitrage/stocks | Arbitraje de acciones |
Cómo montar un monitor de pares
Elige el endpoint según tu plan
Revisa la tabla de planes de arriba: los conjuntos DEX y Cross-chain solo están en Pro y Max.
Acota el conjunto en el servidor
Fija
min_spreadpor encima de la suma de tus comisiones, ymin_volumeomin_liquiditypara descartar monedas ilíquidas.Conserva en el código las filas ejecutables
Spot – Spot:
withdraw_enabled_buyydeposit_enabled_sell. DEX – Spot con spread positivo:deposit_enabled; con spread negativo:withdraw_enabled. Acciones: busca porsymbol_on_buyysymbol_on_sell.Comprueba el token y el libro de órdenes
Compara
contractynetwork, y calcula la ejecución para tu volumen con los endpoints de libros de órdenes.Consulta al ritmo de tu plan
No más a menudo que
meta.freshness_sec. El bot envía una alerta y la operación la haces tú en el exchange.
Preguntas y respuestas
¿Pueden estos endpoints ejecutar una operación?
No. Genesis API solo entrega datos y no envía órdenes. Un bot sobre Genesis API encuentra un par y te manda una alerta, y la operación la abres tú en el exchange.
¿Por qué las filas no tienen las columnas Book ni Ord.?
Ambas se calculan a partir de los libros de órdenes y se piden aparte: Order-book Δ con GET /orderbooks/spreads/{dataset} y el libro de órdenes de un mercado con GET /orderbooks/book, ambos en los planes Pro y Max.
¿Qué plan necesito para DEX y Cross-chain?
Pro o Max. Trial cubre los tres conjuntos CEX y Start añade el arbitraje de acciones.