Endpoint arbitrase Genesis API: CEX, DEX, cross-chain, dan saham
Ringkasan
- Tujuh endpoint mengembalikan pair dari tabel di situs: tiga dataset CEX tersedia di semua paket, saham mulai Start, sedangkan DEX – Spot, DEX – Futures, dan Cross-chain di Pro dan Max.
- Satu baris CEX memuat harga dan quote terbaik kedua exchange, network, kontrak, status deposit dan penarikan, serta volume — field untuk memilih pair yang benar-benar bisa dieksekusi.
- Spread dalam respons adalah selisih harga pada saat snapshot: biaya, transfer, dan slippage tidak dikurangkan darinya.
Endpoint arbitrase Genesis API mengembalikan pair yang sama dengan tabel Genesis Arbitrage: spread antara pasar spot dan futures CEX, antara DEX dan CEX, antar network, serta pada saham yang ditokenisasi. Setiap item data adalah satu pair: di mana membeli, di mana menjual, spread — selisih harga dalam persen — dan field untuk memeriksanya: status deposit dan penarikan, volume, likuiditas, tautan. Ketujuh endpoint adalah request GET dengan key di header X-API-Key.
Tujuh endpoint dan paket
| Endpoint | Yang dikembalikan | Paket |
|---|---|---|
/arbitrage/spot-spot | Spread antar pasar spot CEX | Trial, Start, Pro, Max |
/arbitrage/spot-futures | Spot vs futures di CEX | Trial, Start, Pro, Max |
/arbitrage/futures-futures | Futures antar exchange CEX | Trial, Start, Pro, Max |
/arbitrage/dex-spot | Harga DEX vs spot CEX | Pro, Max |
/arbitrage/dex-futures | Harga DEX vs futures CEX | Pro, Max |
/arbitrage/crosschain | Satu token di DEX antar network | Pro, Max |
/arbitrage/stocks | Saham, logam, indeks, dan komoditas yang ditokenisasi di CEX | Start, Pro, Max |
Endpoint di luar paket Anda mengembalikan 403 plan_restricted; kode error ada di Respons dan error Genesis API, dan harga di halaman harga Genesis API.
CEX: Spot – Spot, Spot – Futures, Futures – Futures
Tiga endpoint CEX memakai parameter yang sama dan mengembalikan baris dengan format yang sama. Field market_buy dan market_sell menunjukkan pasar tiap sisi: spot dan spot, spot dan futures, atau futures dan futures.
| Parameter | Tipe | Fungsi | Contoh |
|---|---|---|---|
coin | string | Filter berdasarkan ticker coin | coin=BTC |
exchange | string | Filter berdasarkan exchange; pisahkan dengan koma untuk beberapa | exchange=Binance,OKX |
min_spread | number | Spread minimum, % | min_spread=1 |
min_volume | number | Volume 24 jam minimum di kedua sisi, 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"
Satu baris respons dari dokumentasi Spot — Spot, diringkas:
{
"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",
…
}
| Field | Tipe | Isi |
|---|---|---|
exchange_buy, exchange_sell | string | Exchange pembelian dan exchange penjualan |
market_buy, market_sell | string | Pasar sisi tersebut: spot atau futures |
price_buy, price_sell | number | Harga yang dipakai untuk menghitung spread |
bid_*, ask_* | number atau null | Bid dan ask terbaik di tiap sisi |
spread_pct | number | Spread, % |
network, contract | string; string atau null | Network token dan alamat kontrak |
deposit_enabled_*, withdraw_enabled_* | boolean | Apakah deposit dan penarikan terbuka di tiap exchange |
volume_24h_buy, volume_24h_sell | number atau null | Volume 24 jam, USD |
trade_url_buy, trade_url_sell | string | Tautan ke terminal trading |
spread_pct dihitung dari price_buy dan price_sell — kolom Harga di situs, yaitu transaksi terakhir. Transaksinya sendiri berjalan lewat order book: Anda membeli di ask_buy dan menjual di bid_sell. Pada contoh, bid_sell berada di bawah ask_buy, sehingga pada quote terbaik pair ini negatif:
(0.0007021 − 0.0007029) / 0.0007029 × 100 ≈ −0,11%
Selisih persis untuk ukuran posisi Anda berasal dari Order-book Δ — GET /orderbooks/spreads/{dataset}, dibahas di panduan endpoint order book.
Pair Spot – Spot yang bisa ditransfer
Pair spot antar exchange hanya berfungsi jika coin bisa dipindahkan: dibeli di satu exchange, ditarik, lalu masuk di exchange lain. Untuk itu penarikan harus terbuka di exchange pembelian (withdraw_enabled_buy) dan deposit harus terbuka di exchange penjualan (deposit_enabled_sell). Request tidak punya parameter untuk flag ini, jadi Anda memfilternya di kode, sementara min_volume menyingkirkan coin yang tidak likuid di sisi server.
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"]
# Transfer hanya berfungsi jika penarikan terbuka di exchange
# pembelian dan deposit terbuka di exchange penjualan
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"]}')
Retry untuk 429 dan 503 memakai fungsi get_json dari Respons dan error Genesis API. Bot yang mengirim pair ini ke Telegram dibuat di artikel bot arbitrase kripto dengan Python.
DEX – Spot dan DEX – Futures
Dataset DEX membandingkan harga token di DEX, exchange terdesentralisasi, dengan harganya di CEX: DEX – Spot terhadap spot, DEX – Futures terhadap futures. Kedua endpoint ada di paket Pro dan Max.
| Parameter | Tipe | Fungsi | Contoh |
|---|---|---|---|
coin | string | Filter berdasarkan ticker coin | coin=SCR |
exchange | string | Exchange CEX; pisahkan dengan koma untuk beberapa | exchange=MEXC |
min_spread | number | Spread minimum, % | min_spread=2 |
min_liquidity | number | Likuiditas minimum, 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"
Satu baris DEX – Spot dari dokumentasi, diringkas:
{
"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,
…
}
Harga MEXC berada di atas harga pool, sehingga spread-nya positif. Tanda spread_pct menentukan arah: plus berarti token lebih murah di DEX, jadi Anda membeli di sana dan menjual di CEX; minus berarti sebaliknya.
| Field | Tipe | Isi |
|---|---|---|
exchange | string | Exchange CEX |
cex_price, dex_price | number | Harga di CEX dan di DEX |
liquidity_usd | number | Likuiditas pool, USD |
market_cap, dex_volume_24h | number atau null | Kapitalisasi pasar dan volume DEX 24 jam (DEX – Spot) |
ticker, max_position_usd | string; number atau null | Pair di exchange dan posisi maksimum, USD (DEX – Futures) |
deposit_enabled, withdraw_enabled | boolean | Apakah deposit dan penarikan terbuka di CEX |
dexscreener_url, dextools_url, gmgn_url | string atau null | Tautan DexScreener, DEXTools, dan GMGN |
Pool pada contoh memiliki likuiditas $10.544, jadi pembelian besar akan menggeser harganya. Slippage untuk ukuran $100 hingga $100.000, pajak token, dan flag honeypot per kontrak berasal dari GET /orderbooks/dex-slippage di paket Pro dan Max.
Cross-chain: satu token di banyak network
GET /arbitrage/crosschain membandingkan harga DEX satu token antar blockchain, di paket Pro dan Max. Satu baris memuat coin, spread_pct, dan dua objek dengan field yang sama: buy, sisi tempat token lebih murah, dan sell, tempat token lebih mahal. Token berpindah antar network lewat bridge cross-chain.
| Parameter | Tipe | Fungsi | Contoh |
|---|---|---|---|
coin | string | Filter berdasarkan ticker token | coin=WLD |
chain | string | Filter berdasarkan network | chain=ethereum |
min_spread | number | Spread minimum, % | min_spread=1 |
min_liquidity | number | Likuiditas minimum, 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"
Satu baris dari dokumentasi Cross-chain, diringkas:
{
"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,
…
}
}
| Field | Tipe | Isi |
|---|---|---|
buy.chain | string | Network sisi tersebut |
buy.pair | string | Pair DEX, misalnya WLD/USDC |
buy.contract | string | Alamat kontrak di network itu |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Harga, likuiditas pool, dan volume 24 jam, USD |
buy.pool_created_at | string atau null | Tanggal pembuatan pool |
buy.dexscreener_url, dextools_url, gmgn_url | string atau null | Tautan DexScreener, DEXTools, dan GMGN |
sell memiliki field yang sama. pool_created_at adalah string tanggal UTC, bukan detik unix seperti sebagian besar timestamp di API, dan bisa bernilai null. Pool yang dibuat beberapa hari lalu adalah alasan untuk memeriksa kontrak di kedua sisi: token lain bisa saja berada di balik ticker yang sama di network baru.
Arbitrase saham: saham, logam, indeks, komoditas
GET /arbitrage/stocks mengembalikan spread pada saham, logam, indeks, dan komoditas yang ditokenisasi antar exchange CEX, dan tersedia mulai paket Start.
| Parameter | Tipe | Fungsi | Contoh |
|---|---|---|---|
symbol | string | Filter berdasarkan ticker instrumen | symbol=BRENT |
category | string | Kategori: Stock, Metal, Index, atau Commodity | category=Commodity |
exchange | string | Filter berdasarkan exchange; pisahkan dengan koma untuk beberapa | exchange=MEXC |
min_spread | number | Spread minimum, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Satu baris dari dokumentasi Stock Arbitrage, diringkas:
{
"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 adalah ticker umum instrumen, sedangkan symbol_on_buy dan symbol_on_sell adalah namanya di tiap exchange: pada contoh, minyak Brent diperdagangkan sebagai UKOIL di MEXC dan BRENTOIL di Ourbit. Cari instrumen di exchange berdasarkan symbol_on_*. Baris ini tidak punya network, kontrak, atau field deposit: di CEX instrumen ini diperdagangkan sebagai perpetual futures, dan pair dibuka dengan posisi Long dan Short (panduan tabel).
Respons API dan tabel di situs
Kolom tabel di situs dijelaskan dalam panduan:
| Endpoint | Tabel di situs dan panduannya |
|---|---|
/arbitrage/spot-spot | Spot – Spot |
/arbitrage/spot-futures | Spot – Futures |
/arbitrage/futures-futures | Futures Arbitrage |
/arbitrage/dex-spot | DEX – Spot |
/arbitrage/dex-futures | DEX – Futures |
/arbitrage/crosschain | Crosschain |
/arbitrage/stocks | Stock Arbitrage |
Cara membuat monitor pair
Pilih endpoint sesuai paket Anda
Lihat tabel paket di atas: dataset DEX dan Cross-chain hanya ada di Pro dan Max.
Persempit data di sisi server
Atur
min_spreaddi atas total biaya Anda, sertamin_volumeataumin_liquidityuntuk menyingkirkan coin yang tidak likuid.Simpan baris yang bisa dieksekusi di kode
Spot – Spot —
withdraw_enabled_buydandeposit_enabled_sell. DEX – Spot dengan spread positif —deposit_enabled, dengan spread negatif —withdraw_enabled. Saham — cari berdasarkansymbol_on_buydansymbol_on_sell.Periksa token dan order book
Bandingkan
contractdannetwork, lalu hitung eksekusi untuk ukuran posisi Anda dengan endpoint order book.Lakukan polling sesuai kecepatan paket Anda
Tidak lebih sering dari
meta.freshness_sec. Bot mengirim alert, dan Anda membuka transaksi sendiri di exchange.
Tanya jawab
Apakah endpoint ini bisa membuka transaksi?
Tidak. Genesis API hanya menyediakan data dan tidak menempatkan order. Bot di atas Genesis API menemukan pair dan mengirim alert, lalu Anda membuka transaksi sendiri di exchange.
Mengapa baris tidak punya kolom Book atau Ord.?
Keduanya dihitung dari order book dan datang terpisah: Order-book Δ dari GET /orderbooks/spreads/{dataset} dan order book sebuah pasar dari GET /orderbooks/book, keduanya di paket Pro dan Max.
Paket apa yang dibutuhkan untuk DEX dan Cross-chain?
Pro atau Max. Trial mencakup tiga dataset CEX, dan Start menambahkan arbitrase saham.