API kripto order book: depth, harga eksekusi, dan slippage di berbagai exchange
Ringkasan
- API order book mengembalikan level bid dan ask, yaitu harga dan ukuran di tiap level, sebagai snapshot REST atau stream perubahan lewat WebSocket. Bid dan ask terbaik hanya menggambarkan beberapa dolar pertama dari sebuah transaksi.
- Depth menentukan harga order besar. Dalam contoh hipotetis, pembelian $10.000 menembus lima level, harga rata-ratanya 25 basis poin di atas mid book, dan spread antar-exchange menyusut dari 1,20% menjadi 0,70%.
- Di paket Pro dan Max, Genesis API mengembalikan harga eksekusi siap pakai untuk $500–$10.000, Δ order book untuk baris arbitrase, usia dan depth book, riwayat slippage, serta tangga slippage DEX. Hanya REST; book tertinggal dari exchange 5–20 detik.
API order book kripto mengembalikan order beli dan jual yang sedang aktif untuk sebuah pasangan trading, dikelompokkan per level harga: setiap level membawa harga dan ukuran yang menunggu di harga itu. Dari level-level tersebut Anda menghitung harga eksekusi order dengan ukuran tertentu, slippage-nya, dan market depth; dari book dua exchange, Anda menghitung berapa banyak spread yang tersisa dalam transaksi nyata.
Exchange menyediakan book-nya sendiri sebagai snapshot REST atau stream WebSocket, sedangkan Genesis API di paket Pro dan Max menyediakan harga eksekusi, depth, dan Δ order book siap pakai untuk banyak exchange sekaligus.
Apa yang dikembalikan API order book
Order book adalah daftar limit order yang menunggu untuk satu pasangan. Order beli (bid) diurutkan dari harga tertinggi ke bawah, order jual (ask) dari harga terendah ke atas. Level adalah satu harga beserta total ukuran di harga itu; selisih antara ask terbaik dan bid terbaik adalah spread book.
Snapshot REST adalah respons untuk satu request: level pada saat itu. Endpoint order book Binance bersifat publik dan tidak butuh API key; berikut request untuk lima level teratas BTC/USDT dan responsnya (angkanya hipotetis):
curl "https://api.binance.com/api/v3/depth?symbol=BTCUSDT&limit=5"
{
"lastUpdateId": 81273645120,
"bids": [["96015.90000000", "1.25000000"], …],
"asks": [["96016.00000000", "0.84100000"], …]
}
Setiap level datang sebagai sepasang string [harga, kuantitas], dengan kuantitas dalam koin: bid terbaik bernilai 1,25 × 96.015,9 = $120.019,88. Parameter limit bernilai default 100 dan bisa sampai 5.000 level per sisi (dokumentasi Binance).
Stream WebSocket didorong oleh exchange lewat koneksi yang terus terbuka. Binance punya dua jenis stream book: btcusdt@depth5, btcusdt@depth10, dan btcusdt@depth20 mengirim 5, 10, atau 20 level teratas, sedangkan btcusdt@depth hanya mengirim perubahan. Keduanya diperbarui setiap 1000 ms, atau setiap 100 ms dengan akhiran @100ms (stream WebSocket Binance).
Book lokal lengkap dibangun dari snapshot ditambah stream selisih, dengan mencocokkan lastUpdateId snapshot terhadap ID pembaruan event; jika ada event yang terlewat, book dibangun ulang dari awal.
| Metode | Yang Anda dapatkan | Untuk apa |
|---|---|---|
| Snapshot REST | Level pada saat request, hingga 5.000 per sisi di Binance | Pengecekan sekali jalan, polling jarang |
| Stream WebSocket | Level teratas atau perubahan setiap 100–1000 ms | Book lokal di memori, bot trading |
| Genesis API lewat REST | Level sebagai [harga, jumlah USD], harga eksekusi, depth, dan usia book | Membandingkan exchange, memeriksa sebuah setup |
Mengapa bid dan ask terbaik menyesatkan untuk ukuran besar
Ask terbaik hanyalah harga level pertama. Market buy yang lebih besar dari level itu akan mengambil level berikutnya yang lebih mahal, dan harga isi rata-rata naik — itulah slippage.
Contoh hipotetis: token ABC di exchange A, bid terbaik 0,9996, ask terbaik 1,0004, mid book 1,0000. Market buy $10.000 menembus lima level ask:
| Harga ask | Di book, $ | Diambil, $ | Koin |
|---|---|---|---|
| 1,0004 | 1.100 | 1.100 | 1.099,56 |
| 1,0010 | 1.400 | 1.400 | 1.398,60 |
| 1,0018 | 2.600 | 2.600 | 2.595,33 |
| 1,0030 | 3.000 | 3.000 | 2.991,03 |
| 1,0050 | 6.000 | 1.900 | 1.890,55 |
Order tersebut membeli total 9.975,07 koin. Harga isi rata-ratanya adalah VWAP, harga rata-rata tertimbang volume: 10.000 / 9.975,07 ≈ 1,0025.
Slippage dari ask terbaik: (1,0025 − 1,0004) / 1,0004 × 100 ≈ 0,21%. Dari mid book: (1,0025 − 1,0000) / 1,0000 × 10.000 = 25 basis poin. Empat di antaranya adalah setengah spread book yang dibayar setiap market buy; 21 sisanya berasal dari depth.
Market depth dalam ±X% dan wall
Market depth adalah total ukuran order dalam jarak tertentu dari harga terbaik. Dalam contoh, ask dalam +0,2% dari yang terbaik, hingga 1,0024, berjumlah 1.100 + 1.400 + 2.600 = $5.100, dan dalam +0,5%, hingga 1,0054, berjumlah $14.100.
Baca depth sebagai kapasitas: order yang lebih besar dari depth dalam +0,2% akan terisi di level di luar batas itu. Di exchange A, pembelian $5.000 muat di dalamnya, sedangkan pembelian $10.000 tidak.
Wall adalah order besar di satu level, jauh lebih besar dari level di sekitarnya: $6.000 di 1,0050 dalam contoh. Selama wall berdiri, ia menahan harga, tetapi bisa ditarik sedetik sebelum order Anda mencapainya, dan pembelian pun terisi di level-level di belakangnya.
Di Genesis API, depth berasal dari /orderbooks/book, book satu pasar, dan /orderbooks/coin/{coin}, book sebuah koin di semua exchange dan pasar sekaligus (Order book pasar, Order book koin). Respons membawa 10 bids dan asks teratas sebagai [harga, jumlah USD], wall terbesar di walls_bid dan walls_ask, serta depth seluruh sisi dalam ±50% dari harga terbaik di depth_bid_usd dan depth_ask_usd. Koridor ±50% itu lebar, jadi untuk ukuran tertentu lihat level-nya atau harga eksekusi siap pakai.
Usia book: book usang dan depth terbatas
Setiap snapshot book punya usia. Jika book satu exchange 15 detik lebih tua daripada yang lain, sebagian spread di antara keduanya bisa jadi hanya selisih waktu: harga di book yang lebih lama sudah bergerak.
Di Genesis API, book tertinggal dari exchange 5–20 detik, dan masing-masing membawa usianya. Awal respons /orderbooks/book dari dokumentasi:
{
"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,
…
}
book_ts adalah waktu book dalam detik unix, age_sec usianya dalam detik, dan stale: true menandai book yang lebih tua dari 30 detik. source menunjukkan cara book diambil dari exchange: lewat WebSocket (ws) atau lewat request REST (rest).
depth_limited: true berarti exchange hanya menerbitkan depth terbatas: totalnya parsial, dan order besar mungkin tidak terisi. Ketika order habis, /orderbooks/exec mengembalikan null sebagai ganti harga, dan Δ order book mengembalikan status exhausted.
Spread yang bisa dieksekusi antar-exchange: Δ order book
Kembali ke contoh hipotetis. Di exchange B, transaksi terakhir tercetak di 1,0120, bid terbaik 1,0116, dan ask 1,0124. Bid B berisi $1.100 di 1,0116, $1.300 di 1,0110, $2.800 di 1,0102, $2.900 di 1,0090, dan $5.000 di 1,0070.
Menjual $10.000 ke bid tersebut menghasilkan VWAP 1,0095 dengan rumus yang sama. Itu (1,0120 − 1,0095) / 1,0120 × 10.000 ≈ 24,7 basis poin di bawah mid book B.
| Cara spread dihitung | Beli di A → jual di B | Spread |
|---|---|---|
| Transaksi terakhir, seperti di baris tabel | 1,0000 → 1,0120 | 1,20% |
| Harga terbaik book | 1,0004 → 1,0116 | 1,12% |
| Setelah mengeksekusi $10.000 | 1,0025 → 1,0095 | 0,70% |
Spread baris: (1,0120 − 1,0000) / 1,0000 × 100 = 1,20%. Setelah eksekusi: (1,0095 − 1,0025) / 1,0025 × 100 ≈ 0,70%. Baris itu menjanjikan $120 dari $10.000, dan sekitar $70 tersisa setelah melewati book: 10.000 × 0,006983 ≈ 69,83.
Dari 50 basis poin yang hilang, 8 habis pada selisih antara transaksi terakhir dan order terbaik, dan 42 lainnya pada depth kedua book.
Δ order book adalah sebutan Genesis Arbitrage untuk spread sebuah baris yang dihitung ulang lewat order book untuk ukuran tertentu; di situs itu adalah kolom «Δ order book» di tabel arbitrase, misalnya Spot – Futures. Di API, nilainya datang dari /orderbooks/spreads/{dataset}: setiap baris satu koin di dataset spot-spot, spot-futures, futures-futures, dex-spot, atau dex-futures mendapat objek order_delta (Δ order book).
order_delta membawa buy_price dan sell_price untuk ukuran yang dipilih, spread_pct setelah eksekusi, dan status: ok, no_book (tidak ada book), atau exhausted (book tidak terisi penuh). volume bernilai 0 (harga terbaik book) atau 500, 1000, 2500, 5000, 10000, dan hasilnya tidak pernah melebihi spread baris. Baris DEX membawa side dan cex_price sebagai ganti pasangan harga: sisi CEX dan harga eksekusinya.
Harga eksekusi itu sendiri, untuk semua pasar sekaligus, datang dari /orderbooks/exec: pasangan [harga beli, harga jual] di bawah kunci seperti Binance|spot|BTC, dengan null di tempat book terlalu tipis (Harga eksekusi).
Setup lengkap, dengan transfer koin dan pengecekan jaringan, dibahas di Arbitrase kripto antar exchange.
Contoh Python: spread baris vs spread setelah eksekusi
Skrip ini mengambil setup Spot – Spot dengan spread minimal 0,5%, meminta Δ order book pada $5.000 untuk sepuluh koin dengan spread terlebar, lalu mencetak berapa basis poin yang termakan book. Key diambil dari variabel lingkungan GENESIS_API_KEY. Pada 429 dan 503, skrip menunggu Retry-After detik, dan jika tunggunya lebih dari satu menit — kuota bulanan habis — skrip berhenti.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
VOLUME = 5000 # dollars per leg
MIN_SPREAD = 0.5 # row spread, %
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):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # the monthly quota is used up
break
time.sleep(wait)
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API did not answer, try again later")
rows = get("/arbitrage/spot-spot", {"min_spread": MIN_SPREAD})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
coins = list(dict.fromkeys(x["coin"] for x in rows))[:10]
for coin in coins:
data = get("/orderbooks/spreads/spot-spot",
{"coin": coin, "volume": VOLUME})
for row in data:
od = row["order_delta"]
if row["spread_pct"] < MIN_SPREAD or od["status"] != "ok":
continue # no_book or exhausted: the size will not fill
lost = (row["spread_pct"] - od["spread_pct"]) * 100
print(f'{coin} {row["exchange_buy"]}→{row["exchange_sell"]}'
f' {row["spread_pct"]:.2f}% → {od["spread_pct"]:.2f}%,'
f' the books ate {lost:.0f} bps')
time.sleep(0.25) # up to 4 requests per second: Pro allows 5
Skrip ini melakukan hingga 11 panggilan dengan jeda 0,25 detik antar koin. Jalankan dalam loop tidak lebih sering dari meta.freshness_sec: 10 detik di Pro dan 5 detik di Max (limit Genesis API). Untuk menambahkan notifikasi, lihat Bot arbitrase kripto di Python.
Riwayat biaya eksekusi
Satu snapshot tidak bisa memberi tahu apakah slippage saat ini normal untuk pasar tersebut atau book-nya lebih tipis dari biasanya. /orderbooks/exec-history mengembalikan riwayat dari Genesis Charts: berapa basis poin dari mid book yang dikeluarkan untuk eksekusi $500, $1.000, $2.500, $5.000, dan $10.000, terpisah untuk beli dan jual (Riwayat eksekusi).
Setiap interval punya 360 titik: 1m mencakup 6 jam, 15m 3,75 hari, 1h 15 hari, dan 1d sekitar satu tahun, dengan data sejak 6 September 2026. Satu request menerima hingga 8 pasar di parameter keys. Nilai beli positif dan nilai jual negatif; null berarti tidak ada data atau book tidak terisi penuh. Genesis API tidak menyediakan snapshot book masa lalu itu sendiri.
import os
import statistics
import requests
KEY = "Binance|spot|BTC"
r = requests.get(
"https://api.genesisarbitrage.com/v1/orderbooks/exec-history",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"keys": KEY, "interval": "1h"}, # 360 hours, 15 days
timeout=15,
)
r.raise_for_status()
data = r.json()["data"]
series = data["series"][KEY]
if series is None:
raise SystemExit("market not found: " + KEY)
i = data["volumes_usd"].index(10000) # the $10,000 buy series
buy = series["buy"][i]
known = [x for x in buy if x is not None]
if not known:
raise SystemExit("no data for the period")
print("15-day median, bps:", statistics.median(known))
print("latest point, bps:", buy[-1])
Secara hipotetis, jika median 15 hari adalah 12 basis poin dan titik terbaru 25, eksekusi sekarang dua kali lebih mahal dari biasanya, dan masuk akal menaikkan ambang spread untuk koin ini.
DEX: tangga slippage, pajak token, dan honeypot
Pool DEX tidak punya order book: harga swap berasal dari rumus pool, dan semakin besar transaksi relatif terhadap likuiditas, semakin jauh harga bergeser. Karena itu leg DEX dinilai dengan tangga — slippage pada serangkaian ukuran.
/orderbooks/dex-slippage mengembalikan, per kontrak, slippage beli dan jual pada $100, $500, $1.000, $2.500, $5.000, $10.000, $20.000, $50.000, dan $100.000, pajak token, dan flag honeypot, sama seperti kolom tabel DEX di situs (Slippage DEX). Pada contoh respons di dokumentasi, slippage beli adalah 0,86% pada $10.000, 3,12% pada $50.000, dan 6,05% pada $100.000.
Itu menentukan batas sebuah setup: spread DEX – CEX 2% bertahan dari slippage pool pada $10.000 tetapi tidak pada $50.000, bahkan sebelum fee. null di tangga berarti pool tidak punya likuiditas untuk ukuran itu, dan gas jaringan tidak ada di respons, jadi anggarkan secara terpisah.
tax_buy_pct dan tax_sell_pct adalah pajak beli dan jual token dalam %; null berarti tidak ada sumber dan tidak boleh dibaca sebagai nol. honeypot: no — tidak ada tanda, suspect — sumber tidak sepakat, yes — menjual token mungkin tidak bisa dilakukan.
Untuk pengecekan token manual, lihat Cara memeriksa token sebelum membeli; untuk harga dan likuiditas DEX di samping CEX, lihat API DEX.
Order book di Genesis API: endpoint dan paket
| Tugas | Endpoint |
|---|---|
| Harga eksekusi untuk $500–$10.000 di setiap pasar | /orderbooks/exec |
| Spread sebuah baris setelah eksekusi | /orderbooks/spreads/{dataset} |
| 10 level, wall, depth, dan usia book | /orderbooks/book |
| Book sebuah koin di setiap exchange | /orderbooks/coin/{coin} |
| Riwayat biaya eksekusi | /orderbooks/exec-history |
| Slippage DEX, pajak, dan flag honeypot | /orderbooks/dex-slippage |
Keenamnya termasuk dalam paket API Pro dan Max. Pro seharga $100 per bulan: 5 juta panggilan, 5 request per detik, kesegaran 10 detik. Max seharga $200: 10 juta panggilan, 15 request per detik, 5 detik; di Trial dan Start, endpoint order book mengembalikan 403 plan_restricted.
Parameter dan contoh respons ada di panduan endpoint order book; untuk gambaran data API, lihat API kripto dan pelajaran Data API untuk arbitrase.
Tanya jawab
Mengapa spread di tabel lebih besar dari yang saya dapat saat transaksi?
Spread baris berasal dari transaksi terakhir, sedangkan market order terisi terhadap book, dan semakin besar ukurannya, semakin jauh harga rata-ratanya dari yang terbaik. Fee dan pergerakan harga selama transfer ikut dihitung. Δ order book menunjukkan berapa banyak spread yang tersisa pada ukuran Anda.
Seberapa sering order book diperbarui?
Book berubah dengan setiap order baru dan pembatalan; stream Binance mengirim perubahan setiap 100 atau 1000 ms. Di Genesis API, book tertinggal dari exchange 5–20 detik (usianya ada di age_sec), dan respons diperbarui setiap 10 detik di Pro dan setiap 5 detik di Max.
Apakah Genesis API punya WebSocket untuk order book?
Tidak. Genesis API hanya REST: request HTTP GET dan respons JSON. Stream book real-time datang dari WebSocket exchange sendiri, dan itulah yang dibutuhkan bot yang menempatkan order lewat API trading exchange.
Apakah ada API order book kripto gratis?
Exchange punya endpoint publik: book Binance di /api/v3/depth menjawab tanpa key, tetapi hanya mencakup satu exchange, dan harga eksekusi Anda hitung sendiri. Genesis API tidak punya paket gratis; order book termasuk di Pro seharga $100 per bulan dan Max seharga $200.