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;
nullberarti book terlalu tipis untuk volume itu. - Book tertinggal 5–20 detik dari exchange: periksa
age_secdanstale, 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
| Endpoint | Mengembalikan | Wajib | Dokumentasi |
|---|---|---|---|
/orderbooks/exec | Harga beli dan jual untuk suatu volume di setiap pasar | volume | Harga eksekusi |
/orderbooks/spreads/{dataset} | Δ order book untuk baris satu koin dalam dataset arbitrase | coin | Δ order book |
/orderbooks/book | Book satu pasar: 10 level, wall, kedalaman, usia | exchange, market, coin | Order book pasar |
/orderbooks/coin/{coin} | Book sebuah koin di semua exchange dan pasar | koin di path | Order book koin |
/orderbooks/exec-history | Riwayat slippage, hingga 8 pasar per request | keys, interval | Riwayat eksekusi |
/orderbooks/dex-slippage | Slippage, 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
volume | angka | Volume dalam USD: 500, 1000, 2500, 5000, atau 10000, wajib |
exchange | string | Filter berdasarkan exchange; pisahkan dengan koma untuk beberapa |
market | string | spot atau futures |
coin | string | Ticker 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
{dataset} | string, di path | spot-spot, spot-futures, futures-futures, dex-spot, atau dex-futures |
coin | string | Ticker koin, wajib |
volume | angka | Default 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
}
| Field | Arti |
|---|---|
best_bid, best_ask | Bid dan ask terbaik |
bids, asks | 10 level teratas: [harga, jumlah USD] |
walls_bid, walls_ask | Wall terbesar: [harga, jumlah USD] |
depth_bid_usd, depth_ask_usd | Kedalaman sisi dalam ±50% dari harga terbaik, USD |
book_ts, age_sec, stale | Waktu book dan usianya dalam detik; stale — lebih tua dari 30 dtk |
source, depth_limited | Sumber 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.
interval | Langkah titik | 360 titik mencakup |
|---|---|---|
1m | 1 menit | 6 jam |
15m | 15 menit | 3,75 hari |
1h | 1 jam | 15 hari |
1d | 1 hari | sekitar 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
Ambil satu baris arbitrase
Temukan setup di
/arbitrage/spot-spotatau dataset lain — lihat Endpoint arbitrase. Catat koin, exchange, danspread_pct.Hitung ulang spread melalui book
Request
/orderbooks/spreads/spot-spotdengan koin itu dan ukuran transaksi Anda, lalu bandingkanspread_pctdenganorder_delta.spread_pct.Periksa kesegaran dan kedalaman
Panggil
/orderbooks/bookuntuk kedua leg:age_sec,stale, dandepth_limitedmemberi tahu apakah angkanya layak dipercaya, dan wall menunjukkan di mana harga bisa tertahan.Bandingkan dengan riwayat
/orderbooks/exec-historymenunjukkan apakah slippage ini normal untuk pasar tersebut:1mmencakup 6 jam,1hmencakup 15 hari.Periksa pajak di leg DEX
Untuk setup DEX – Spot dan DEX – Futures, request
/orderbooks/dex-slippageuntuk kontrak baris itu: slippage, pajak, danhoneypot.
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.