Genesis Arbitrage

Genesis Arbitrage · · 16 min de lectura

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-slippage devuelve 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:

DatoPor qué importa en el arbitrajeCampo de Genesis API
Precio en DEX y en CEXEl spread y su direccióndex_price, cex_price, spread_pct
Liquidez del poolCuánto mueve el precio una operaciónliquidity_usd
Volumen de 24 hSi el pool se negocia siquieradex_volume_24h, volume_24h_usd
CapitalizaciónQué tamaño tiene el tokenmarket_cap
Contrato y redSi es el mismo token que en el exchangecontract, network o chain
Antigüedad del poolUn pool reciente es motivo para revisar de nuevo el contratopool_created_at
Depósitos y retiros en el CEXSi el token puede entrar o salir del exchangedeposit_enabled, withdraw_enabled
Slippage, impuesto, honeypotCuánto queda del spread/orderbooks/dex-slippage
Enlaces al poolMira tú mismo el pool y sus operacionesdexscreener_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:

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_pctOperaciónNecesario en el CEXDatos de la pata DEX
Mayor que 0Comprar en el DEX, depositar en el exchange, venderdeposit_enabledslippage_buy_pct, tax_buy_pct
Menor que 0Comprar en el exchange, retirar, vender en el DEXwithdraw_enabledslippage_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ónSlippageGas, % del tamañoSpread 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

EndpointQué devuelveDocumentación
/arbitrage/dex-spotPrecio DEX frente al spot CEX, liquidez, capitalización, volumenDEX — Spot
/arbitrage/dex-futuresPrecio DEX frente a futuros CEX, max_position_usdDEX — Futuros
/arbitrage/crosschainUn token en DEX de dos redes, antigüedad del poolCross-chain
/orderbooks/dex-slippageSlippage de 100 $ a 100 000 $, impuestos, honeypotSlippage en DEX
/market/dex-dumpsCaídas de tokens en DEX y si el token cotiza en un CEXDEX 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

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.