Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

Endpoint order book Genesis API: harga eksekusi, Δ order book, book, riwayat, dan DEX

Ringkasan

  • Enam endpoint order book di paket API Pro dan Max mengembalikan data yang sama dengan kolom "Δ order book", jendela "Order book", dan Genesis Charts di situs.
  • Harga eksekusi adalah harga rata-rata market order senilai $500, $1.000, $2.500, $5.000, atau $10.000; null berarti book terlalu tipis untuk volume itu.
  • Book tertinggal 5–20 detik dari exchange: periksa age_sec dan stale, lalu lihat book di terminal exchange sebelum bertransaksi.

API order book di Genesis API terdiri dari enam endpoint yang menunjukkan berapa banyak spread yang tersisa pada transaksi dengan ukuran tertentu. Endpoint ini mengembalikan harga eksekusi untuk suatu volume, Δ order book untuk baris arbitrase, order book beserta kedalamannya, riwayat slippage, dan slippage DEX — data yang sama dengan kolom "Δ order book" dan Genesis Charts di situs.

Enam endpoint order book

EndpointMengembalikanWajibDokumentasi
/orderbooks/execHarga beli dan jual untuk suatu volume di setiap pasarvolumeHarga eksekusi
/orderbooks/spreads/{dataset}Δ order book untuk baris satu koin dalam dataset arbitrasecoinΔ order book
/orderbooks/bookBook satu pasar: 10 level, wall, kedalaman, usiaexchange, market, coinOrder book pasar
/orderbooks/coin/{coin}Book sebuah koin di semua exchange dan pasarkoin di pathOrder book koin
/orderbooks/exec-historyRiwayat slippage, hingga 8 pasar per requestkeys, intervalRiwayat eksekusi
/orderbooks/dex-slippageSlippage, pajak, dan flag honeypot per kontrak—Slippage DEX

Keenamnya termasuk dalam paket API Pro ($100 per bulan) dan Max ($200); di Trial dan Start endpoint ini mengembalikan 403 plan_restricted. Di /orderbooks/exec dan di parameter keys pada riwayat, pasar ditulis sebagai Exchange|market|COIN, misalnya Binance|spot|BTC. Contoh respons di bawah menampilkan field data yang sudah dipersingkat.

Untuk gambaran umum data order book, baca artikel tentang API order book.

Harga eksekusi untuk suatu volume

Harga eksekusi adalah harga rata-rata saat market order dengan ukuran tertentu menelusuri book: pembelian mengambil ask, penjualan menghantam bid, sehingga nilainya adalah VWAP dari order yang dihabiskan transaksi. /orderbooks/exec mengembalikannya untuk setiap pasar pada satu volume dari grid.

ParameterTipeFungsi
volumeangkaVolume dalam USD: 500, 1000, 2500, 5000, atau 10000, wajib
exchangestringFilter berdasarkan exchange; pisahkan dengan koma untuk beberapa
marketstringspot atau futures
coinstringTicker koin, mis. BTC
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "volume": 1000,
  "markets": {
    "Binance|spot|BTC": [96021.5, 96010.2],
    "ByBit|futures|BTC": [96030.1, 96018.7],
    "Ourbit|spot|SHELL": [0.10418, null],
    …
  }
}

Nilai untuk setiap kunci pasar adalah [harga beli, harga jual]. null sebagai pengganti harga berarti book terlalu tipis untuk volume itu: pada contoh, bid SHELL di Ourbit tidak sanggup menyerap penjualan $1.000. Tanpa filter, respons berisi semua pasar, jadi gunakan coin bila Anda hanya butuh satu koin.

Δ order book: spread setelah menelusuri book

Δ order book adalah spread sebuah baris arbitrase yang dihitung ulang melalui order book untuk volume tertentu. /orderbooks/spreads/{dataset} mengambil semua baris satu koin dalam dataset yang dipilih dan menambahkan objek order_delta ke masing-masing, dengan rumus yang sama seperti kolom di situs.

ParameterTipeFungsi
{dataset}string, di pathspot-spot, spot-futures, futures-futures, dex-spot, atau dex-futures
coinstringTicker koin, wajib
volumeangkaDefault 0 — harga terbaik book; atau 500, 1000, 2500, 5000, 10000

Untuk pasangan CEX, pembelian melewati ask exchange_buy dan penjualan masuk ke bid exchange_sell. order_delta memuat buy_price dan sell_price, dan hasilnya tidak pernah melebihi spread_pct baris.

Untuk baris DEX, tanda spread menentukan sisi CEX: dengan spread_pct ≥ 0 token dijual ke bid CEX, dengan spread negatif token dibeli dari ask. order_delta memuat side dan cex_price, yaitu harga eksekusi di CEX; bila tandanya berbalik setelah menelusuri book, Δ bernilai 0.

Field status: ok — terhitung, no_book — tidak ada book, exhausted — book tidak memenuhi volume.

Contoh hipotetis: koin XYZ, beli di MEXC pada 2,000, jual di Gate pada 2,016, spread baris 0,8%. Request Δ order book untuk $5.000:

curl -G \
  "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
  -d coin=XYZ -d volume=5000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "XYZ",
  "exchange_buy": "MEXC",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 2.0,
  "price_sell": 2.016,
  "ask_buy": 2.001,
  "bid_sell": 2.015,
  "spread_pct": 0.8,
  "order_delta": {
    "volume": 5000,
    "buy_price": 2.004,
    "sell_price": 2.01,
    "spread_pct": 0.2994,
    "status": "ok"
  }
}

Field lain pada baris sama seperti di /arbitrage/spot-spot. Spread baris: (2,016 − 2,000) / 2,000 × 100 = 0,8%.

Untuk $5.000, pembelian melalui book MEXC rata-rata di 2,004 dan penjualan ke book Gate mendapat 2,010: (2,010 − 2,004) / 2,004 × 100 ≈ 0,2994%. Dari 0,8%, sekitar 0,3% bertahan pada ukuran ini — kira-kira $15 sebelum fee dan transfer: 5.000 × 0,002994 ≈ 14,97.

Contoh Python: spread sebelum dan sesudah book

Skrip mencetak spread baris berdampingan dengan spread setelah book untuk BTC di dataset Spot – Spot pada $5.000. Kunci diambil dari variabel lingkungan GENESIS_API_KEY; pada 429 dan 503 skrip menunggu Retry-After detik.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            # rate limit or data being rebuilt
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API is busy, try again later")


rows = get("/orderbooks/spreads/spot-spot",
           {"coin": "BTC", "volume": 5000})
for row in rows:
    od = row["order_delta"]
    if od["status"] == "ok":
        after = f'{od["spread_pct"]:.4f}%'
    else:
        after = od["status"]  # no_book or exhausted
    print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
          f'{row["spread_pct"]}% → {after}')

Dalam loop, lakukan polling tidak lebih sering dari sekali per meta.freshness_sec detik: 10 dtk di Pro, 5 dtk di Max. Kuota dan limit dibahas di panduan limit Genesis API.

Order book pasar dan order book koin

/orderbooks/book mengembalikan book satu pasar, seperti jendela "Order book" di situs. Tiga parameter wajib menentukan pasarnya: exchange (tidak peka huruf besar/kecil), market (spot atau futures), dan coin. /orderbooks/coin/{coin} mengembalikan array objek yang sama untuk setiap exchange dan pasar dari koin tersebut.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
  -d exchange=Binance -d market=spot -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}
FieldArti
best_bid, best_askBid dan ask terbaik
bids, asks10 level teratas: [harga, jumlah USD]
walls_bid, walls_askWall terbesar: [harga, jumlah USD]
depth_bid_usd, depth_ask_usdKedalaman sisi dalam ±50% dari harga terbaik, USD
book_ts, age_sec, staleWaktu book dan usianya dalam detik; stale — lebih tua dari 30 dtk
source, depth_limitedSumber book (ws atau rest) dan flag kedalaman terbatas

Kedalaman pasar pada depth_bid_usd dan depth_ask_usd adalah jumlah dolar order di satu sisi book: pada contoh, sekitar $58,8 juta ask untuk BTC di Binance dalam +50% dari ask terbaik.

Dengan depth_limited: true, exchange hanya menerbitkan sebagian book, dan volume besar mungkin tidak terisi. Jika tidak ada book untuk exchange, pasar, dan koin itu, Anda mendapat 404.

Riwayat eksekusi

/orderbooks/exec-history adalah riwayat slippage dari Genesis Charts: berapa biaya eksekusi pada setiap volume grid, dalam basis poin dari mid book (1 bp = 0,01%). Satu request menerima hingga 8 pasar di keys, dipisahkan koma; interval wajib.

intervalLangkah titik360 titik mencakup
1m1 menit6 jam
15m15 menit3,75 hari
1h1 jam15 hari
1d1 harisekitar satu tahun

Data dikumpulkan sejak 6 September 2026, sehingga seri harian baru terisi sejak tanggal itu.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
  --data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
  -d interval=1h \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
              [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "ByBit|futures|BTC": { … }
  }
}

buy dan sell masing-masing berisi lima seri, satu per volume di volumes_usd, masing-masing dengan 360 nilai dari yang terlama ke terbaru. Titik terakhir milik last_bucket_ts, dan titik i milik last_bucket_ts − (points − 1 − i) × step_sec. Nilai beli positif dan nilai jual negatif: harga rata-rata transaksi berada di atas dan di bawah mid book.

Seri [5, 7, 9, …] adalah pembelian $10.000: titik-titik awalnya berbiaya 5–9 bp, atau 0,05–0,09% di atas mid. null dalam seri berarti tidak ada data atau book tidak terisi; null sebagai pengganti objek pasar berarti kunci tidak dikenal.

Slippage DEX

/orderbooks/dex-slippage menjelaskan leg DEX dari sebuah setup: slippage beli dan jual untuk $100 hingga $100.000, pajak token, dan flag honeypot per kontrak — sama seperti kolom tabel DEX di situs. Filter: contract (pisahkan dengan koma untuk beberapa) dan network.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
  -d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "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
    }
  ]
}

Array slippage mengikuti grid sizes_usd: pada contoh, pembelian $5.000 mengalami slippage 0,58% dan pembelian $100.000 sebesar 6,05%. null dalam array berarti pool kekurangan likuiditas untuk ukuran itu.

tax_buy_pct dan tax_sell_pct adalah pajak beli dan jual token, %; null berarti tidak ada sumber, bukan 0%. honeypot: no; suspect — sumber tidak sepakat; yes — penjualan mungkin tidak bisa dilakukan.

Cara memeriksa setup terhadap book

  1. Ambil satu baris arbitrase

    Temukan setup di /arbitrage/spot-spot atau dataset lain — lihat Endpoint arbitrase. Catat koin, exchange, dan spread_pct.

  2. Hitung ulang spread melalui book

    Request /orderbooks/spreads/spot-spot dengan koin itu dan ukuran transaksi Anda, lalu bandingkan spread_pct dengan order_delta.spread_pct.

  3. Periksa kesegaran dan kedalaman

    Panggil /orderbooks/book untuk kedua leg: age_sec, stale, dan depth_limited memberi tahu apakah angkanya layak dipercaya, dan wall menunjukkan di mana harga bisa tertahan.

  4. Bandingkan dengan riwayat

    /orderbooks/exec-history menunjukkan apakah slippage ini normal untuk pasar tersebut: 1m mencakup 6 jam, 1h mencakup 15 hari.

  5. Periksa pajak di leg DEX

    Untuk setup DEX – Spot dan DEX – Futures, request /orderbooks/dex-slippage untuk kontrak baris itu: slippage, pajak, dan honeypot.

Tanya jawab

Apa bedanya Δ order book dengan spread biasa?

spread_pct sebuah baris memakai harga terakhir exchange; Δ order book memakai harga rata-rata market order pada volume yang diberikan. Selisih keduanya adalah bagian yang diambil book.

Mengapa saya mendapat null, bukan harga?

Di /orderbooks/exec, book punya terlalu sedikit order untuk volume itu; di Δ order book, kasus yang sama berstatus exhausted. Di riwayat eksekusi null berarti tidak ada data untuk titik itu, dan di slippage DEX berarti pool kekurangan likuiditas.

Bisakah saya menghitung eksekusi di atas $10.000?

Grid /orderbooks/exec dan Δ order book tetap di $500 sampai $10.000. Untuk ukuran lebih besar, lihat kedalaman dan wall di /orderbooks/book; untuk leg DEX, /orderbooks/dex-slippage sampai $100.000.