Genesis Arbitrage

Genesis Arbitrage · · 16 min de leitura

API de DEX: preços, liquidez e slippage de DEX ao lado do preço CEX

Em resumo

  • Uma API de DEX retorna o preço de um token no pool, a liquidez, o volume, o valor de mercado, o contrato e a rede. Para arbitragem, você também precisa do preço CEX do mesmo contrato: os endpoints DEX — Spot e DEX — Futuros da Genesis API o retornam nos planos Pro e Max.
  • O preço em uma DEX depende do tamanho da operação, porque quem o define é um pool de liquidez. Em um exemplo hipotético, um spread de 3% deixa US$ 11 em uma operação de US$ 2.500 e fica negativo em US$ 5.000, depois do slippage, da taxa do token e do gas.
  • /orderbooks/dex-slippage retorna o slippage para o tamanho da sua operação, as taxas de compra e de venda e o flag honeypot. A Genesis API apenas lê dados: o swap você assina na sua própria carteira.

Uma API de DEX é o acesso programático a dados de exchanges descentralizadas (DEXs): o preço de um token no pool, a liquidez do pool, o volume negociado, o valor de mercado, o endereço do contrato e a rede. A maioria das DEXs não tem livro de ofertas nem processo de listagem: um pool de liquidez define o preço, e qualquer pessoa pode criar um pool. Por isso uma API de DEX precisa retornar, junto com o preço, os dados necessários para verificar o token e o pool.

Na arbitragem, o preço da DEX é comparado com o preço CEX do mesmo contrato, e você calcula quanto do spread sobrevive ao tamanho da sua operação depois do slippage, da taxa do token e do gas. Na Genesis API, os pares DEX ↔ CEX vêm de /arbitrage/dex-spot e /arbitrage/dex-futures, enquanto o slippage, as taxas e o flag de honeypot por contrato vêm de /orderbooks/dex-slippage.

Como uma DEX define o preço

Na maioria das DEXs, um swap passa por um pool de liquidez: um contrato inteligente que guarda reservas de dois tokens, por exemplo um token e USDC. O preço é a razão entre as reservas. Uma compra retira o token do pool e adiciona USDC, então cada unidade seguinte do token custa mais que a anterior.

A Uniswap descreve esse pool pela fórmula do produto constante x × y = k, em que x e y são as reservas dos tokens: depois de um swap, o produto não pode diminuir.

Exemplo hipotético: um pool tem US$ 200.000 de liquidez, US$ 100.000 de cada lado. Uma compra de US$ 1.000 move o preço médio em 2 × 1.000 / 200.000 = 1%, e uma compra de US$ 10.000, em 10%. O cálculo passo a passo com uma tabela está na lição O que é arbitragem DEX.

A fórmula descreve um pool clássico. Na Uniswap v3 e v4, ela vale dentro das faixas de preço que os provedores de liquidez escolhem, e o preço DEX nas linhas da Genesis Arbitrage é agregado por contrato e rede. Por isso o slippage exato para um tamanho de operação vem dos dados, e a fórmula serve como estimativa rápida.

O que você precisa de uma API de DEX

Avaliar um par DEX ↔ CEX exige mais do que um preço. Veja o que você precisa e onde isso está nas respostas da Genesis API:

DadoPor que importa na arbitragemCampo da Genesis API
Preço na DEX e na CEXO spread e a sua direçãodex_price, cex_price, spread_pct
Liquidez do poolQuanto uma operação move o preçoliquidity_usd
Volume de 24 hSe o pool chega a ser negociadodex_volume_24h, volume_24h_usd
Valor de mercadoO tamanho do tokenmarket_cap
Contrato e redeSe é o mesmo token da exchangecontract, network ou chain
Idade do poolUm pool recente é motivo para rever o contratopool_created_at
Depósitos e saques na CEXSe o token pode entrar na exchange ou sair deladeposit_enabled, withdraw_enabled
Slippage, taxa, honeypotQuanto sobra do spread/orderbooks/dex-slippage
Links do poolVeja você mesmo o pool e as suas negociaçõesdexscreener_url, dextools_url, gmgn_url

O valor de mercado e o volume DEX vêm em DEX — Spot, e a idade do pool, nos lados buy e sell de Cross-chain. Uma requisição para a linha DEX — Spot de uma moeda:

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
  -d coin=SCR \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Uma linha da documentação 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,
  …
}

O token custa mais na MEXC do que no pool, então o spread é positivo: 0,45%. A liquidez do pool é de US$ 10.544 e o volume DEX de 24 h é de cerca de US$ 320. Se for um único pool clássico, o preço médio de uma compra de US$ 1.000 ficará cerca de 2 × 1.000 / 10.544 ≈ 19% acima do preço inicial, mais de 40 vezes o spread. Os links podem ser null: esta linha tem apenas dexscreener_url.

Por que os preços das DEXs se afastam dos das CEXs

O preço de um pool só muda com as negociações nele, e visto de fora o novo preço aparece a cada bloco: a Ethereum divide o tempo em slots de 12 segundos. Em uma CEX, o preço se move com o fluxo de ordens do livro. Uma diferença dura até que um arbitrador a feche, e o que atrapalha é isto:

Na arbitragem, o sinal do spread define a direção da operação, e a direção define o que precisa estar aberto na exchange e quais dados da perna DEX ler:

spread_pctOperaçãoNecessário na CEXDados da perna DEX
Acima de 0Comprar na DEX, depositar na exchange, venderdeposit_enabledslippage_buy_pct, tax_buy_pct
Abaixo de 0Comprar na exchange, sacar, vender na DEXwithdraw_enabledslippage_sell_pct, tax_sell_pct

Enquanto o token viaja entre a carteira e a exchange, o spread pode se fechar. Em um par DEX — Futuros, um short de futuros aberto junto com a compra na DEX compensa o movimento do preço, mas traz consigo margem, funding e risco de liquidação — veja a lição Arbitragem: DEX — Futuros. Uma linha de DEX — Futuros também tem max_position_usd, o tamanho máximo de posição, quando a exchange o fornece.

Slippage, taxa do token e honeypots

/orderbooks/dex-slippage descreve a perna DEX de um par por contrato: o slippage de compra e de venda para tamanhos de US$ 100 a US$ 100.000, a taxa de compra e de venda do token e o flag honeypot (honeypot é um token que você consegue comprar, mas não vender). São os mesmos dados das colunas DEX da tabela do site. Os filtros são contract (separados por vírgula para vários endereços) e network; os campos estão descritos na seção Slippage em DEX.

Um exemplo de resposta da documentação, com um 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
    }
  ]
}

Os arrays seguem a grade sizes_usd: uma compra de US$ 1.000 perde 0,36%, uma de US$ 10.000, 0,86% e uma de US$ 100.000, 6,05%. Um null em um array significa que o pool não tem liquidez para aquele tamanho. honeypot assume três valores: no, suspect (as fontes divergem) e yes (pode ser impossível vender). Cada contrato tem o seu próprio horário de atualização em updated_at.

Exemplo hipotético: um spread de 3% e o que sobra dele

O token custa US$ 1,00 na DEX e US$ 1,03 na CEX: um spread de 3% sobre o preço de compra, então você compra na DEX e vende na exchange. A taxa de compra é de 1%, a taxa da exchange na venda, de 0,1%, e o gas do swap e da transferência para a exchange, de US$ 4. A escada de slippage_buy_pct: 0,5% em US$ 500, 0,7% em US$ 1.000, 1,3% em US$ 2.500 e 2,3% em US$ 5.000.

Tamanho da operaçãoSlippageGas, % do tamanhoSpread restante
US$ 5000,5%0,8%0,6%, ou US$ 3
US$ 1.0000,7%0,4%0,8%, ou US$ 8
US$ 2.5001,3%0,16%0,44%, ou US$ 11
US$ 5.0002,3%0,08%−0,48%, ou −US$ 24

Para US$ 5.000: 3 − 2,3 − 1 − 0,1 − 0,08 = −0,48%, uma perda de US$ 24 na operação. Somar percentuais serve para uma estimativa; o cálculo exato com produtos dá alguns centésimos de ponto percentual a menos.

Em dólares, o máximo sobra em US$ 2.500, enquanto em US$ 5.000 o mesmo spread torna a operação negativa. À medida que o tamanho cresce, o gas pesa menos e o slippage mais, então cada par tem o seu próprio tamanho de trabalho. Com honeypot: "yes" e spread negativo, não há o que calcular: um token comprado na exchange pode não ser vendido no pool.

A venda na CEX no exemplo usa o preço da linha. Na prática, você confere no order book da exchange: o Δ do order book para linhas DEX vem de /orderbooks/spreads/dex-spot para US$ 500, US$ 1.000, US$ 2.500, US$ 5.000 e US$ 10.000 — campos na documentação, passo a passo no guia Endpoints de livros de ofertas.

Endpoints DEX da Genesis API

EndpointO que retornaDocumentação
/arbitrage/dex-spotPreço DEX vs spot CEX, liquidez, valor de mercado, volumeDEX — Spot
/arbitrage/dex-futuresPreço DEX vs futuros CEX, max_position_usdDEX — Futuros
/arbitrage/crosschainUm token em DEXs de duas redes, idade do poolCross-chain
/orderbooks/dex-slippageSlippage de US$ 100 a US$ 100.000, taxas, honeypotSlippage em DEX
/market/dex-dumpsQuedas de tokens em DEXs e se o token é negociado em uma CEXDEX Dumps

Os cinco funcionam nos planos de API Pro (US$ 100 por mês, atualização de 10 s) e Max (US$ 200, atualização de 5 s); em Trial e Start retornam 403 plan_restricted. DEX — Spot e DEX — Futuros aceitam coin, exchange, min_spread e min_liquidity, Cross-chain aceita chain no lugar de exchange, e DEX Dumps aceita chain e min_liquidity. Parâmetros e campos estão no guia Endpoints de arbitragem, e os preços, na página de planos da Genesis API.

min_spread compara o spread com sinal: min_spread=2 também descarta uma linha com spread de −5%. Para ver as duas direções, aplique o limite ao valor absoluto no código, como faz o exemplo abaixo. Swaps grandes em pools com estimativa de impacto no preço vêm do endpoint on-chain /onchain/dex-swaps, tratado no artigo API de dados on-chain.

Sem código, a tabela do site mostra os mesmos pares: as colunas, os filtros e a ordem de verificação estão descritos em Como usar a tabela DEX — Spot.

Exemplo em Python: pares DEX — Spot sem armadilhas

O script pega pares DEX — Spot com liquidez a partir de US$ 50.000 e spread absoluto a partir de 2%, pede o slippage e as taxas dos contratos deles e descarta honeypot: "yes" e taxas acima de 5%. Para o restante, calcula quanto sobra do spread em US$ 1.000 depois do slippage e da taxa. A chave vem da variável de ambiente GENESIS_API_KEY.

A função de requisição espera Retry-After segundos em 429 e 503. Quando a cota mensal acaba, Retry-After faz a contagem regressiva até o reinício da cota e pode chegar a dias, então o script não inicia uma espera longa:

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("Os endpoints DEX exigem o plano Pro ou Max")
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # cota mensal esgotada
                raise SystemExit(f"cota esgotada, tente em {wait} s")
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API ocupada, tente mais tarde")

Seleção de pares e verificação de contratos:

SIZE = 1000   # tamanho da operação, USD: um dos valores de sizes_usd
MAX_TAX = 5   # pular tokens com taxa acima de 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):  # até 50 endereços por chamada
    d = get("/orderbooks/dex-slippage",
            {"contract": ",".join(addrs[i:i + 50])})
    sizes = d["sizes_usd"]
    for c in d["contracts"]:  # os endereços chegam em 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  # sem dados, ou pode ser impossível vender
    taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
             if t is not None]  # null significa sem fonte, não 0%
    if any(t > MAX_TAX for t in taxes):
        continue
    buy = x["spread_pct"] >= 0  # positivo: comprar na 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  # o pool não tem 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'taxa {"sem dados" if tax is None else tax}, '
          f'honeypot {hp}')

O script não desconta o gas nem as taxas da exchange, então some os seus próprios números de rede e de exchange. Ele pula linhas sem dados em /orderbooks/dex-slippage: esses tokens devem ser verificados à mão pelos links da linha. Os endereços são comparados em minúsculas porque DEX — Spot pode retornar um contrato com maiúsculas e minúsculas misturadas, como no exemplo acima.

Consulte em loop no máximo com a frequência de meta.freshness_sec. No Pro, isso é a cada 10 segundos: 30 × 86.400 / 10 = 259.200 chamadas a um endpoint em 30 dias contra uma cota de 5M. Como economizar cota e tráfego está em Como fazer polling de uma API sem estourar os limites.

Riscos que o spread não mostra

Perguntas e respostas

Posso comprar um token pela Genesis API?

Não. A Genesis API apenas retorna dados e não envia ordens, nem em DEXs nem em exchanges. Você assina os swaps em DEX na sua própria carteira e abre as operações em CEX na exchange por conta própria.

Com que frequência os preços DEX são atualizados na API?

O preço de um pool muda a cada negociação nele e aparece de fora a cada novo bloco. O núcleo da Genesis Arbitrage atualiza os dados a cada segundo, e a API os entrega com a atualização do seu plano: 10 s no Pro e 5 s no Max, os únicos planos com os endpoints DEX. O horário de montagem do snapshot está em meta.updated_at; o slippage e as taxas trazem o updated_at de cada contrato.

O que null significa na taxa de um token?

Que não há fonte de dados da taxa desse token. Não trate como zero: a taxa pode ser qualquer valor. O exemplo em Python acima mantém essas linhas e imprime «taxa sem dados» para você verificá-las à mão.

Qual plano da Genesis API preciso para os dados DEX?

Pro (US$ 100 por mês) ou Max (US$ 200). Em Trial e Start, DEX — Spot, DEX — Futuros, Cross-chain, DEX Dumps e o slippage em DEX retornam 403 plan_restricted.

As respostas incluem links do DexScreener?

Sim. As linhas de DEX — Spot e DEX — Futuros e os dois lados de Cross-chain trazem dexscreener_url, dextools_url e gmgn_url, links para a página do pool ou do token. Quando um link falta, o campo é null. Em DEX Dumps, o link do pool é pool_url, e os demais estão no array links.