Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

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

EndpointYang dikembalikanPaket
/arbitrage/spot-spotSpread antar pasar spot CEXTrial, Start, Pro, Max
/arbitrage/spot-futuresSpot vs futures di CEXTrial, Start, Pro, Max
/arbitrage/futures-futuresFutures antar exchange CEXTrial, Start, Pro, Max
/arbitrage/dex-spotHarga DEX vs spot CEXPro, Max
/arbitrage/dex-futuresHarga DEX vs futures CEXPro, Max
/arbitrage/crosschainSatu token di DEX antar networkPro, Max
/arbitrage/stocksSaham, logam, indeks, dan komoditas yang ditokenisasi di CEXStart, 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.

ParameterTipeFungsiContoh
coinstringFilter berdasarkan ticker coincoin=BTC
exchangestringFilter berdasarkan exchange; pisahkan dengan koma untuk beberapaexchange=Binance,OKX
min_spreadnumberSpread minimum, %min_spread=1
min_volumenumberVolume 24 jam minimum di kedua sisi, USDmin_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",
  …
}
FieldTipeIsi
exchange_buy, exchange_sellstringExchange pembelian dan exchange penjualan
market_buy, market_sellstringPasar sisi tersebut: spot atau futures
price_buy, price_sellnumberHarga yang dipakai untuk menghitung spread
bid_*, ask_*number atau nullBid dan ask terbaik di tiap sisi
spread_pctnumberSpread, %
network, contractstring; string atau nullNetwork token dan alamat kontrak
deposit_enabled_*, withdraw_enabled_*booleanApakah deposit dan penarikan terbuka di tiap exchange
volume_24h_buy, volume_24h_sellnumber atau nullVolume 24 jam, USD
trade_url_buy, trade_url_sellstringTautan 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.

ParameterTipeFungsiContoh
coinstringFilter berdasarkan ticker coincoin=SCR
exchangestringExchange CEX; pisahkan dengan koma untuk beberapaexchange=MEXC
min_spreadnumberSpread minimum, %min_spread=2
min_liquiditynumberLikuiditas minimum, USDmin_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.

FieldTipeIsi
exchangestringExchange CEX
cex_price, dex_pricenumberHarga di CEX dan di DEX
liquidity_usdnumberLikuiditas pool, USD
market_cap, dex_volume_24hnumber atau nullKapitalisasi pasar dan volume DEX 24 jam (DEX – Spot)
ticker, max_position_usdstring; number atau nullPair di exchange dan posisi maksimum, USD (DEX – Futures)
deposit_enabled, withdraw_enabledbooleanApakah deposit dan penarikan terbuka di CEX
dexscreener_url, dextools_url, gmgn_urlstring atau nullTautan 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.

ParameterTipeFungsiContoh
coinstringFilter berdasarkan ticker tokencoin=WLD
chainstringFilter berdasarkan networkchain=ethereum
min_spreadnumberSpread minimum, %min_spread=1
min_liquiditynumberLikuiditas minimum, USDmin_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,
    …
  }
}
FieldTipeIsi
buy.chainstringNetwork sisi tersebut
buy.pairstringPair DEX, misalnya WLD/USDC
buy.contractstringAlamat kontrak di network itu
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberHarga, likuiditas pool, dan volume 24 jam, USD
buy.pool_created_atstring atau nullTanggal pembuatan pool
buy.dexscreener_url, dextools_url, gmgn_urlstring atau nullTautan 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.

ParameterTipeFungsiContoh
symbolstringFilter berdasarkan ticker instrumensymbol=BRENT
categorystringKategori: Stock, Metal, Index, atau Commoditycategory=Commodity
exchangestringFilter berdasarkan exchange; pisahkan dengan koma untuk beberapaexchange=MEXC
min_spreadnumberSpread 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:

EndpointTabel di situs dan panduannya
/arbitrage/spot-spotSpot – Spot
/arbitrage/spot-futuresSpot – Futures
/arbitrage/futures-futuresFutures Arbitrage
/arbitrage/dex-spotDEX – Spot
/arbitrage/dex-futuresDEX – Futures
/arbitrage/crosschainCrosschain
/arbitrage/stocksStock Arbitrage

Cara membuat monitor pair

  1. Pilih endpoint sesuai paket Anda

    Lihat tabel paket di atas: dataset DEX dan Cross-chain hanya ada di Pro dan Max.

  2. Persempit data di sisi server

    Atur min_spread di atas total biaya Anda, serta min_volume atau min_liquidity untuk menyingkirkan coin yang tidak likuid.

  3. Simpan baris yang bisa dieksekusi di kode

    Spot – Spot — withdraw_enabled_buy dan deposit_enabled_sell. DEX – Spot dengan spread positif — deposit_enabled, dengan spread negatif — withdraw_enabled. Saham — cari berdasarkan symbol_on_buy dan symbol_on_sell.

  4. Periksa token dan order book

    Bandingkan contract dan network, lalu hitung eksekusi untuk ukuran posisi Anda dengan endpoint order book.

  5. 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.