Endpoints de arbitragem da Genesis API: CEX, DEX, cross-chain e ações
Em resumo
- Sete endpoints retornam os pares das tabelas do site: os três datasets CEX estão em todos os planos, ações a partir do Start, e DEX – Spot, DEX – Futures e Cross-chain no Pro e no Max.
- Uma linha CEX traz os preços e as melhores cotações das duas exchanges, a rede, o contrato, o status de depósito e saque e os volumes: os campos para escolher pares que você realmente consegue executar.
- O spread da resposta é a diferença de preço no momento do snapshot: taxas, transferências e slippage não são descontados dele.
Os endpoints de arbitragem da Genesis API retornam os mesmos pares das tabelas da Genesis Arbitrage: spreads entre mercados spot e de futuros das CEX, entre DEX e CEX, entre redes e em ações tokenizadas. Cada item de data é um par: onde comprar, onde vender, o spread — a diferença de preço em porcentagem — e os campos para conferi-lo: status de depósito e saque, volumes, liquidez, links. Os sete endpoints são requisições GET com a chave no cabeçalho X-API-Key.
Sete endpoints e planos
| Endpoint | O que retorna | Planos |
|---|---|---|
/arbitrage/spot-spot | Spreads entre mercados spot das CEX | Trial, Start, Pro, Max |
/arbitrage/spot-futures | Spot contra futuros nas CEX | Trial, Start, Pro, Max |
/arbitrage/futures-futures | Futuros entre exchanges CEX | Trial, Start, Pro, Max |
/arbitrage/dex-spot | Preço na DEX contra spot da CEX | Pro, Max |
/arbitrage/dex-futures | Preço na DEX contra futuros da CEX | Pro, Max |
/arbitrage/crosschain | Um token na DEX entre redes | Pro, Max |
/arbitrage/stocks | Ações tokenizadas, metais, índices e commodities nas CEX | Start, Pro, Max |
Um endpoint fora do seu plano retorna 403 plan_restricted; os códigos de erro estão em Respostas e erros da Genesis API e os preços, na página de preços da Genesis API.
CEX: Spot – Spot, Spot – Futures, Futures – Futures
Os três endpoints CEX aceitam os mesmos parâmetros e retornam linhas no mesmo formato. Os campos market_buy e market_sell mostram o mercado de cada lado: spot e spot, spot e futures, ou futures e futures.
| Parâmetro | Tipo | O que faz | Exemplo |
|---|---|---|---|
coin | string | Filtra pelo ticker da moeda | coin=BTC |
exchange | string | Filtra por exchange; várias separadas por vírgula | exchange=Binance,OKX |
min_spread | number | Spread mínimo, % | min_spread=1 |
min_volume | number | Volume mínimo de 24 h nos dois 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"
Uma linha de resposta da documentação 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 | Conteúdo |
|---|---|---|
exchange_buy, exchange_sell | string | Exchange de compra e exchange de venda |
market_buy, market_sell | string | Mercado do lado: spot ou futures |
price_buy, price_sell | number | Preços a partir dos quais o spread é calculado |
bid_*, ask_* | number ou null | Melhor bid e ask de cada lado |
spread_pct | number | Spread, % |
network, contract | string; string ou null | Rede do token e endereço do contrato |
deposit_enabled_*, withdraw_enabled_* | boolean | Se depósitos e saques estão abertos em cada exchange |
volume_24h_buy, volume_24h_sell | number ou null | Volume de 24 h, USD |
trade_url_buy, trade_url_sell | string | Links para os terminais de negociação |
spread_pct é calculado a partir de price_buy e price_sell — a coluna Preço do site, o último negócio. A operação em si passa pelo livro de ofertas: você compra a ask_buy e vende a bid_sell. No exemplo, bid_sell está abaixo de ask_buy, então, nas melhores cotações, o par fica negativo:
(0,0007021 − 0,0007029) / 0,0007029 × 100 ≈ −0,11%
A diferença exata para o seu volume vem do Order-book Δ — GET /orderbooks/spreads/{dataset}, descrito no guia dos endpoints de order books.
Pares Spot – Spot transferíveis
Um par spot entre exchanges só funciona se a moeda puder ser movida: comprada em uma exchange, sacada e creditada na outra. Para isso, é preciso ter saques abertos na exchange de compra (withdraw_enabled_buy) e depósitos abertos na exchange de venda (deposit_enabled_sell). A requisição não tem parâmetros para esses indicadores, então você filtra no código, enquanto min_volume descarta no servidor as moedas 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"]
# A transferência só funciona se os saques estiverem abertos na
# exchange de compra e os depósitos na exchange de venda
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"]}')
As novas tentativas em 429 e 503 usam a função get_json de Respostas e erros da Genesis API. Um bot que envia esses pares ao Telegram é montado no artigo bot de arbitragem de criptomoedas em Python.
DEX – Spot e DEX – Futures
Os datasets DEX comparam o preço de um token em uma DEX, uma exchange descentralizada, com o preço em uma CEX: DEX – Spot contra o spot, DEX – Futures contra os futuros. Os dois endpoints estão nos planos Pro e Max.
| Parâmetro | Tipo | O que faz | Exemplo |
|---|---|---|---|
coin | string | Filtra pelo ticker da moeda | coin=SCR |
exchange | string | Exchange CEX; várias separadas por vírgula | 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"
Uma linha de DEX – Spot da documentação, 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,
…
}
O preço na MEXC está acima do preço do pool, então o spread é positivo. O sinal de spread_pct define a direção: mais significa que o token está mais barato na DEX, então você compra lá e vende na CEX; menos significa o contrário.
| Campo | Tipo | Conteúdo |
|---|---|---|
exchange | string | Exchange CEX |
cex_price, dex_price | number | Preço na CEX e na DEX |
liquidity_usd | number | Liquidez do pool, USD |
market_cap, dex_volume_24h | number ou null | Capitalização de mercado e volume de 24 h na DEX (DEX – Spot) |
ticker, max_position_usd | string; number ou null | Par da exchange e posição máxima, USD (DEX – Futures) |
deposit_enabled, withdraw_enabled | boolean | Se depósitos e saques estão abertos na CEX |
dexscreener_url, dextools_url, gmgn_url | string ou null | Links do DexScreener, DEXTools e GMGN |
O pool do exemplo tem US$ 10.544 de liquidez, então uma compra grande moverá o preço dele. O slippage para volumes de US$ 100 a US$ 100.000, os impostos do token e a marca de honeypot por contrato vêm de GET /orderbooks/dex-slippage nos planos Pro e Max.
Cross-chain: um token entre redes
GET /arbitrage/crosschain compara o preço de um token na DEX entre blockchains, nos planos Pro e Max. Uma linha contém coin, spread_pct e dois objetos com os mesmos campos: buy, o lado em que o token é mais barato, e sell, em que custa mais. O token passa de uma rede para outra por uma ponte cross-chain.
| Parâmetro | Tipo | O que faz | Exemplo |
|---|---|---|---|
coin | string | Filtra pelo ticker do token | coin=WLD |
chain | string | Filtra por rede | 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"
Uma linha da documentação 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 | Conteúdo |
|---|---|---|
buy.chain | string | Rede do lado |
buy.pair | string | Par da DEX, como WLD/USDC |
buy.contract | string | Endereço do contrato nessa rede |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Preço, liquidez do pool e volume de 24 h, USD |
buy.pool_created_at | string ou null | Data de criação do pool |
buy.dexscreener_url, dextools_url, gmgn_url | string ou null | Links do DexScreener, DEXTools e GMGN |
sell tem os mesmos campos. pool_created_at é uma string de data em UTC, e não segundos unix como a maioria dos timestamps da API, e pode ser null. Um pool criado há poucos dias é motivo para conferir os contratos dos dois lados: em uma rede nova, outro token pode estar por trás do mesmo ticker.
Arbitragem de ações: ações, metais, índices, commodities
GET /arbitrage/stocks retorna spreads de ações tokenizadas, metais, índices e commodities entre exchanges CEX e está disponível a partir do plano Start.
| Parâmetro | Tipo | O que faz | Exemplo |
|---|---|---|---|
symbol | string | Filtra pelo ticker do instrumento | symbol=BRENT |
category | string | Categoria: Stock, Metal, Index ou Commodity | category=Commodity |
exchange | string | Filtra por exchange; várias separadas por vírgula | 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"
Uma linha da documentação de arbitragem de ações, 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 é o ticker comum do instrumento, enquanto symbol_on_buy e symbol_on_sell são os nomes dele em cada exchange: no exemplo, o petróleo Brent é negociado como UKOIL na MEXC e como BRENTOIL na Ourbit. Procure o instrumento na exchange por symbol_on_*. A linha não tem rede, contrato nem campos de depósito: nas CEX esses instrumentos são negociados como futuros perpétuos, e o par é aberto com posições Long e Short (guia da tabela).
Respostas da API e tabelas do site
As colunas das tabelas do site são explicadas nos guias:
| Endpoint | Tabela do site e seu guia |
|---|---|
/arbitrage/spot-spot | Spot – Spot |
/arbitrage/spot-futures | Spot – Futures |
/arbitrage/futures-futures | Arbitragem de futuros |
/arbitrage/dex-spot | DEX – Spot |
/arbitrage/dex-futures | DEX – Futures |
/arbitrage/crosschain | Crosschain |
/arbitrage/stocks | Arbitragem de ações |
Como montar um monitor de pares
Escolha o endpoint conforme o seu plano
Confira a tabela de planos acima: os datasets DEX e Cross-chain estão apenas no Pro e no Max.
Reduza o conjunto no servidor
Defina
min_spreadacima da soma das suas taxas, emin_volumeoumin_liquiditypara descartar moedas ilíquidas.Mantenha no código as linhas executáveis
Spot – Spot:
withdraw_enabled_buyedeposit_enabled_sell. DEX – Spot com spread positivo:deposit_enabled; com spread negativo:withdraw_enabled. Ações: procure porsymbol_on_buyesymbol_on_sell.Confira o token e o livro de ofertas
Compare
contractenetwork, e calcule a execução para o seu volume com os endpoints de order books.Consulte no ritmo do seu plano
Não mais seguido que
meta.freshness_sec. O bot envia um alerta, e a operação você faz na exchange.
Perguntas e respostas
Esses endpoints podem executar uma operação?
Não. A Genesis API só entrega dados e não envia ordens. Um bot na Genesis API encontra um par e envia um alerta, e a operação você abre na exchange.
Por que as linhas não têm as colunas Book e Ord.?
As duas são calculadas a partir dos order books e vêm separadas: Order-book Δ em GET /orderbooks/spreads/{dataset} e o livro de ofertas de um mercado em GET /orderbooks/book, ambos nos planos Pro e Max.
Qual plano preciso para DEX e Cross-chain?
Pro ou Max. O Trial cobre os três datasets CEX, e o Start acrescenta a arbitragem de ações.