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-slippageretorna 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:
| Dado | Por que importa na arbitragem | Campo da Genesis API |
|---|---|---|
| Preço na DEX e na CEX | O spread e a sua direção | dex_price, cex_price, spread_pct |
| Liquidez do pool | Quanto uma operação move o preço | liquidity_usd |
| Volume de 24 h | Se o pool chega a ser negociado | dex_volume_24h, volume_24h_usd |
| Valor de mercado | O tamanho do token | market_cap |
| Contrato e rede | Se é o mesmo token da exchange | contract, network ou chain |
| Idade do pool | Um pool recente é motivo para rever o contrato | pool_created_at |
| Depósitos e saques na CEX | Se o token pode entrar na exchange ou sair dela | deposit_enabled, withdraw_enabled |
| Slippage, taxa, honeypot | Quanto sobra do spread | /orderbooks/dex-slippage |
| Links do pool | Veja você mesmo o pool e as suas negociações | dexscreener_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:
- Depósitos ou saques fechados. Se o token não pode entrar na exchange nem sair dela, os dois mercados vivem separados. Em uma linha, são
deposit_enabledewithdraw_enabled. - Os custos superam a diferença. Gas, taxas do pool e da exchange: não vale a pena fechar uma diferença menor que esses custos.
- Taxa do token. Com uma taxa de compra de 5%, uma diferença de até 5% é consumida pela própria taxa.
- Pool raso. Em um pool de dezenas de milhares de dólares, uma única operação média move o preço.
- Outro token. Uma cópia com outro contrato pode ser negociada em uma DEX com o mesmo ticker. A Genesis Arbitrage só compara preços quando o endereço do contrato é o mesmo.
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_pct | Operação | Necessário na CEX | Dados da perna DEX |
|---|---|---|---|
| Acima de 0 | Comprar na DEX, depositar na exchange, vender | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| Abaixo de 0 | Comprar na exchange, sacar, vender na DEX | withdraw_enabled | slippage_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ção | Slippage | Gas, % do tamanho | Spread restante |
|---|---|---|---|
| US$ 500 | 0,5% | 0,8% | 0,6%, ou US$ 3 |
| US$ 1.000 | 0,7% | 0,4% | 0,8%, ou US$ 8 |
| US$ 2.500 | 1,3% | 0,16% | 0,44%, ou US$ 11 |
| US$ 5.000 | 2,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
| Endpoint | O que retorna | Documentação |
|---|---|---|
/arbitrage/dex-spot | Preço DEX vs spot CEX, liquidez, valor de mercado, volume | DEX — Spot |
/arbitrage/dex-futures | Preço DEX vs futuros CEX, max_position_usd | DEX — Futuros |
/arbitrage/crosschain | Um token em DEXs de duas redes, idade do pool | Cross-chain |
/orderbooks/dex-slippage | Slippage de US$ 100 a US$ 100.000, taxas, honeypot | Slippage em DEX |
/market/dex-dumps | Quedas de tokens em DEXs e se o token é negociado em uma CEX | DEX 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
- MEV e ataques sanduíche. Um bot pode ver o seu swap na DEX antes de ele entrar em um bloco: compra na sua frente, vende logo depois e fica com parte do spread. Quanto maior a tolerância de slippage na sua carteira, mais ele pode levar; a proteção está em MEV e ataques sanduíche em DEXs.
- Poderes do dono do token. Se o contrato permitir, o dono pode aumentar a taxa ou bloquear vendas depois da sua compra, e o
honeypot: "no"e a taxa zero de hoje não protegem você disso. As permissões do contrato e os bloqueios de liquidez são verificados passo a passo em Como verificar um token antes de comprar. - Atraso dos dados. Os preços chegam com o atraso do seu plano e a escada de slippage, com o seu próprio
updated_at. Antes de operar, confira o preço do pool pelo link da linha e o order book na exchange. - Transferência para a exchange. Os depósitos podem fechar enquanto o token está em trânsito, e o crédito espera as confirmações da rede, um número que cada exchange define por conta própria.
- Gas. Em uma rede congestionada o gas sobe e consome o spread das operações pequenas.
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.