API de DEX: precios, liquidez y slippage de DEX junto al precio CEX
En resumen
- Una API de DEX devuelve el precio de un token en el pool, la liquidez, el volumen, la capitalización, el contrato y la red. Para el arbitraje también hace falta el precio CEX del mismo contrato: los endpoints DEX — Spot y DEX — Futuros de Genesis API lo devuelven en los planes Pro y Max.
- El precio en un DEX depende del tamaño de la operación, porque lo fija un pool de liquidez. En un ejemplo hipotético, un spread del 3 % deja 11 $ en una operación de 2500 $ y se vuelve negativo con 5000 $ tras el slippage, el impuesto del token y el gas.
/orderbooks/dex-slippagedevuelve el slippage para el tamaño de tu operación, los impuestos de compra y venta y el flag honeypot. Genesis API solo lee datos: el swap lo firmas tú en tu propia wallet.
Una API de DEX es el acceso programático a los datos de los exchanges descentralizados (DEX): el precio de un token en el pool, la liquidez del pool, el volumen de operaciones, la capitalización, la dirección del contrato y la red. La mayoría de los DEX no tiene libro de órdenes ni proceso de listado: el precio lo fija un pool de liquidez y cualquiera puede crear un pool. Por eso una API de DEX debe devolver, junto con el precio, los datos necesarios para comprobar el token y el pool.
En el arbitraje, el precio del DEX se compara con el precio CEX del mismo contrato y se calcula qué parte del spread sobrevive a tu tamaño de operación tras el slippage, el impuesto del token y el gas. En Genesis API, los pares DEX ↔ CEX salen de /arbitrage/dex-spot y /arbitrage/dex-futures, mientras que el slippage, los impuestos y el flag de honeypot por contrato salen de /orderbooks/dex-slippage.
Cómo fija el precio un DEX
En la mayoría de los DEX, un swap pasa por un pool de liquidez: un contrato inteligente que guarda reservas de dos tokens, por ejemplo un token y USDC. El precio es la proporción entre las reservas. Una compra saca el token del pool y añade USDC, así que cada unidad siguiente del token cuesta más que la anterior.
Uniswap describe ese pool con la fórmula del producto constante x × y = k, donde x e y son las reservas de los tokens: tras un swap, el producto no puede disminuir.
Ejemplo hipotético: un pool tiene 200 000 $ de liquidez, 100 000 $ en cada lado. Una compra de 1000 $ mueve el precio medio un 2 × 1000 / 200 000 = 1 %, y una compra de 10 000 $, un 10 %. El cálculo paso a paso con una tabla está en la lección Qué es el arbitraje DEX.
La fórmula describe un pool clásico. En Uniswap v3 y v4 se aplica dentro de los rangos de precio que eligen los proveedores de liquidez, y el precio DEX en las filas de Genesis Arbitrage está agregado por contrato y red. Por eso el slippage exacto para un tamaño de operación sale de los datos, y la fórmula sirve como estimación rápida.
Qué necesitas de una API de DEX
Para juzgar un par DEX ↔ CEX hace falta algo más que un precio. Esto es lo que necesitas y dónde está en las respuestas de Genesis API:
| Dato | Por qué importa en el arbitraje | Campo de Genesis API |
|---|---|---|
| Precio en DEX y en CEX | El spread y su dirección | dex_price, cex_price, spread_pct |
| Liquidez del pool | Cuánto mueve el precio una operación | liquidity_usd |
| Volumen de 24 h | Si el pool se negocia siquiera | dex_volume_24h, volume_24h_usd |
| Capitalización | Qué tamaño tiene el token | market_cap |
| Contrato y red | Si es el mismo token que en el exchange | contract, network o chain |
| Antigüedad del pool | Un pool reciente es motivo para revisar de nuevo el contrato | pool_created_at |
| Depósitos y retiros en el CEX | Si el token puede entrar o salir del exchange | deposit_enabled, withdraw_enabled |
| Slippage, impuesto, honeypot | Cuánto queda del spread | /orderbooks/dex-slippage |
| Enlaces al pool | Mira tú mismo el pool y sus operaciones | dexscreener_url, dextools_url, gmgn_url |
La capitalización y el volumen DEX vienen en DEX — Spot; la antigüedad del pool, en los lados buy y sell de Cross-chain. Una petición de la fila DEX — Spot de una moneda:
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d coin=SCR \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Una fila de la documentación de DEX — Spot, abreviada:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"dex_volume_24h": 319.73,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
…
}
El token cuesta más en MEXC que en el pool, así que el spread es positivo: 0,45 %. La liquidez del pool es de 10 544 $ y el volumen DEX de 24 h, de unos 320 $. Si es un solo pool clásico, el precio medio de una compra de 1000 $ quedará un 2 × 1000 / 10 544 ≈ 19 % por encima del inicial: más de 40 veces el spread. Los enlaces pueden ser null: esta fila solo tiene dexscreener_url.
Por qué los precios del DEX se alejan de los del CEX
El precio de un pool cambia solo con las operaciones en él, y desde fuera el nuevo precio aparece con cada bloque: Ethereum divide el tiempo en slots de 12 segundos. En un CEX el precio se mueve con el flujo de órdenes del libro. Una brecha dura hasta que un arbitrajista la cierra, y esto es lo que se lo impide:
- Depósitos o retiros cerrados. Si el token no puede entrar al exchange ni salir de él, los dos mercados viven por separado. En una fila, son
deposit_enabledywithdraw_enabled. - Los costes superan la brecha. Gas, comisiones del pool y del exchange: no compensa cerrar una brecha menor que estos costes.
- Impuesto del token. Con un impuesto de compra del 5 %, una brecha de hasta el 5 % se la come el propio impuesto.
- Pool delgado. En un pool de decenas de miles de dólares, una sola operación mediana mueve el precio.
- Otro token. En un DEX puede cotizar bajo el mismo ticker una copia con otro contrato. Genesis Arbitrage compara precios solo cuando la dirección del contrato coincide.
En el arbitraje, el signo del spread define la dirección de la operación, y la dirección define qué debe estar abierto en el exchange y qué datos de la pata DEX hay que leer:
spread_pct | Operación | Necesario en el CEX | Datos de la pata DEX |
|---|---|---|---|
| Mayor que 0 | Comprar en el DEX, depositar en el exchange, vender | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| Menor que 0 | Comprar en el exchange, retirar, vender en el DEX | withdraw_enabled | slippage_sell_pct, tax_sell_pct |
Mientras el token viaja entre la wallet y el exchange, el spread puede cerrarse. En un par DEX — Futuros, un short de futuros abierto a la vez que la compra en el DEX compensa el movimiento del precio, pero trae consigo margen, funding y riesgo de liquidación: consulta la lección Arbitraje: DEX — Futuros. Una fila de DEX — Futuros también tiene max_position_usd, el tamaño máximo de posición, cuando el exchange lo proporciona.
Slippage, impuesto del token y honeypots
/orderbooks/dex-slippage describe la pata DEX de un par por contrato: el slippage de compra y venta para tamaños de 100 $ a 100 000 $, el impuesto de compra y venta del token y el flag honeypot (un honeypot es un token que puedes comprar pero no vender). Son los mismos datos que las columnas DEX de la tabla del sitio. Los filtros son contract (separados por comas para varias direcciones) y network; los campos se describen en la sección Slippage en DEX.
Un ejemplo de respuesta de la documentación, con un contrato:
{
"sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
100000],
"contracts": [
{
"contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"network": "ETH",
"tax_buy_pct": 0,
"tax_sell_pct": 0,
"honeypot": "no",
"slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
1.41, 3.12, 6.05],
"slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
1.5, 3.3, 6.4],
"updated_at": 1794671040
}
]
}
Los arrays siguen la cuadrícula sizes_usd: una compra de 1000 $ pierde un 0,36 %, una de 10 000 $, un 0,86 % y una de 100 000 $, un 6,05 %. Un null en un array significa que el pool no tiene liquidez para ese tamaño. honeypot toma tres valores: no, suspect (las fuentes no coinciden) y yes (puede que no se pueda vender). Cada contrato tiene su propia hora de actualización en updated_at.
Ejemplo hipotético: un spread del 3 % y qué queda de él
El token cuesta 1,00 $ en el DEX y 1,03 $ en el CEX: un spread del 3 % sobre el precio de compra, así que compras en el DEX y vendes en el exchange. El impuesto de compra es del 1 %, la comisión del exchange por la venta, del 0,1 %, y el gas del swap y de la transferencia al exchange, de 4 $. La escalera de slippage_buy_pct: 0,5 % con 500 $, 0,7 % con 1000 $, 1,3 % con 2500 $ y 2,3 % con 5000 $.
| Tamaño de la operación | Slippage | Gas, % del tamaño | Spread restante |
|---|---|---|---|
| 500 $ | 0,5 % | 0,8 % | 0,6 %, o 3 $ |
| 1000 $ | 0,7 % | 0,4 % | 0,8 %, o 8 $ |
| 2500 $ | 1,3 % | 0,16 % | 0,44 %, o 11 $ |
| 5000 $ | 2,3 % | 0,08 % | −0,48 %, o −24 $ |
Para 5000 $: 3 − 2,3 − 1 − 0,1 − 0,08 = −0,48 %, una pérdida de 24 $ en la operación. Sumar porcentajes vale para una estimación; el cálculo exacto con productos sale unas centésimas de punto porcentual más bajo.
En dólares, lo máximo queda con 2500 $, mientras que con 5000 $ el mismo spread vuelve negativa la operación. A medida que crece el tamaño, el gas pesa menos y el slippage más, así que cada par tiene su propio tamaño de trabajo. Con honeypot: "yes" y un spread negativo no hay nada que calcular: un token comprado en el exchange puede no venderse en el pool.
La venta en el CEX del ejemplo usa el precio de la fila. En la práctica lo contrastas con el libro de órdenes del exchange: la Δ del libro de órdenes para las filas DEX sale de /orderbooks/spreads/dex-spot para 500 $, 1000 $, 2500 $, 5000 $ y 10 000 $ (campos en la documentación, un recorrido en la guía Endpoints de libros de órdenes).
Endpoints DEX en Genesis API
| Endpoint | Qué devuelve | Documentación |
|---|---|---|
/arbitrage/dex-spot | Precio DEX frente al spot CEX, liquidez, capitalización, volumen | DEX — Spot |
/arbitrage/dex-futures | Precio DEX frente a futuros CEX, max_position_usd | DEX — Futuros |
/arbitrage/crosschain | Un token en DEX de dos redes, antigüedad del pool | Cross-chain |
/orderbooks/dex-slippage | Slippage de 100 $ a 100 000 $, impuestos, honeypot | Slippage en DEX |
/market/dex-dumps | Caídas de tokens en DEX y si el token cotiza en un CEX | DEX Dumps |
Los cinco funcionan con los planes de API Pro (100 $ al mes, frescura de 10 s) y Max (200 $, frescura de 5 s); en Trial y Start devuelven 403 plan_restricted. DEX — Spot y DEX — Futuros aceptan coin, exchange, min_spread y min_liquidity; Cross-chain acepta chain en lugar de exchange, y DEX Dumps acepta chain y min_liquidity. Los parámetros y campos se explican en la guía Endpoints de arbitraje, y los precios, en la página de precios de Genesis API.
min_spread compara el spread con signo: min_spread=2 también descarta una fila con un spread del −5 %. Para ver ambas direcciones, aplica el umbral al valor absoluto en el código, como hace el ejemplo de abajo. Los swaps grandes en pools con una estimación del impacto en el precio salen del endpoint on-chain /onchain/dex-swaps, que se explica en el artículo API de datos on-chain.
Sin código, la tabla del sitio muestra los mismos pares: sus columnas, filtros y el orden de comprobación se describen en Cómo usar la tabla DEX — Spot.
Ejemplo en Python: pares DEX — Spot sin trampas
El script toma los pares DEX — Spot con liquidez desde 50 000 $ y un spread absoluto desde el 2 %, pide el slippage y los impuestos de sus contratos y descarta honeypot: "yes" y los impuestos superiores al 5 %. Con el resto calcula qué queda del spread con 1000 $ tras el slippage y el impuesto. La clave viene de la variable de entorno GENESIS_API_KEY.
La función de petición espera Retry-After segundos ante 429 y 503. Cuando se agota la cuota mensual, Retry-After cuenta atrás hasta el reinicio de la cuota y puede llegar a días, así que el script no inicia una espera larga:
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get(path, params=None):
for _ in range(3):
r = requests.get(API + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code == 403:
raise SystemExit("Los endpoints DEX requieren el plan Pro o Max")
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # cuota mensual agotada
raise SystemExit(f"cuota agotada, reintenta en {wait} s")
time.sleep(wait)
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API ocupada, inténtalo más tarde")
Selección de pares y comprobación de contratos:
SIZE = 1000 # tamaño de la operación, USD: uno de los valores de sizes_usd
MAX_TAX = 5 # omitir tokens con impuesto superior al 5 %
rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
if x["contract"] and abs(x["spread_pct"]) >= 2]
addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50): # hasta 50 direcciones por llamada
d = get("/orderbooks/dex-slippage",
{"contract": ",".join(addrs[i:i + 50])})
sizes = d["sizes_usd"]
for c in d["contracts"]: # las direcciones llegan en minúsculas
checks[c["contract"]] = c
found = []
for x in rows:
c = checks.get(x["contract"].lower())
if c is None or c["honeypot"] == "yes":
continue # sin datos, o puede que no se pueda vender
taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
if t is not None] # null significa sin fuente, no 0 %
if any(t > MAX_TAX for t in taxes):
continue
buy = x["spread_pct"] >= 0 # positivo: comprar en el DEX
ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
k = sizes.index(SIZE)
slip = ladder[k] if k < len(ladder) else None
if slip is None:
continue # el pool no tiene liquidez para SIZE
tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
left = abs(x["spread_pct"]) - slip - (tax or 0)
found.append((left, x, c["honeypot"], tax))
for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
print(f'{x["coin"]:<8} {x["exchange"]:<8} '
f'spread {x["spread_pct"]:+.2f}%, resta {left:.2f}%, '
f'impuesto {"sin datos" if tax is None else tax}, '
f'honeypot {hp}')
El script no resta el gas ni las comisiones del exchange, así que añade tus propias cifras de red y de exchange. Omite las filas sin datos en /orderbooks/dex-slippage: esos tokens se comprueban a mano a través de los enlaces de la fila. Las direcciones se comparan en minúsculas porque DEX — Spot puede devolver un contrato con mayúsculas y minúsculas mezcladas, como en el ejemplo de arriba.
Consulta en bucle no más a menudo que meta.freshness_sec. En Pro eso es cada 10 segundos: 30 × 86 400 / 10 = 259 200 llamadas a un endpoint en 30 días frente a una cuota de 5M. Cómo ahorrar cuota y tráfico se explica en Cómo hacer polling de una API sin tocar los límites.
Riesgos que el spread no muestra
- MEV y ataques sándwich. Un bot puede ver tu swap en el DEX antes de que entre en un bloque: compra antes que tú, vende justo después y se queda con parte del spread. Cuanto mayor es la tolerancia de slippage en tu wallet, más puede llevarse; la protección se explica en MEV y ataques sándwich en DEX.
- Poderes del propietario del token. Si el contrato lo permite, el propietario puede subir el impuesto o bloquear las ventas después de que compres, y el
honeypot: "no"y el impuesto cero de hoy no te protegen de eso. Los permisos del contrato y los bloqueos de liquidez se comprueban paso a paso en Cómo comprobar un token antes de comprarlo. - Retraso de los datos. Los precios llegan con el retraso de tu plan y la escalera de slippage, con su propio
updated_at. Antes de operar, comprueba el precio del pool en el enlace de la fila y el libro de órdenes en el exchange. - Transferencia al exchange. Los depósitos pueden cerrarse mientras el token está en tránsito, y el abono espera las confirmaciones de red, una cifra que cada exchange fija por su cuenta.
- Gas. En una red congestionada el gas sube y se come el spread de las operaciones pequeñas.
Preguntas y respuestas
¿Puedo comprar un token a través de Genesis API?
No. Genesis API solo devuelve datos y no coloca órdenes, ni en DEX ni en exchanges. Los swaps en DEX los firmas en tu propia wallet y las operaciones en CEX las abres tú en el exchange.
¿Con qué frecuencia se actualizan los precios DEX en la API?
El precio de un pool cambia con cada operación en él y se ve desde fuera con cada bloque nuevo. El núcleo de Genesis Arbitrage actualiza los datos cada segundo, y la API los sirve con la frescura de tu plan: 10 s en Pro y 5 s en Max, los únicos planes con los endpoints DEX. La hora de construcción de la instantánea está en meta.updated_at; el slippage y los impuestos llevan el updated_at de cada contrato.
¿Qué significa null en el impuesto de un token?
Que no hay fuente de datos del impuesto de este token. No lo trates como cero: el impuesto podría ser cualquiera. El ejemplo en Python de arriba conserva esas filas e imprime «impuesto sin datos» para que las compruebes a mano.
¿Qué plan de Genesis API necesito para los datos DEX?
Pro (100 $ al mes) o Max (200 $). En Trial y Start, DEX — Spot, DEX — Futuros, Cross-chain, DEX Dumps y el slippage en DEX devuelven 403 plan_restricted.
¿Las respuestas incluyen enlaces a DexScreener?
Sí. Las filas de DEX — Spot y DEX — Futuros y los dos lados de Cross-chain llevan dexscreener_url, dextools_url y gmgn_url, enlaces a la página del pool o del token. Cuando falta un enlace, el campo es null. En DEX Dumps el enlace al pool es pool_url, y los demás están en el array links.