Genesis API के order book endpoint: execution price, ऑर्डर-बुक Δ, बुक, इतिहास और DEX
संक्षेप में
- API Pro और Max प्लान के छह order book endpoint वही डेटा देते हैं जो साइट «ऑर्डर से Δ» कॉलम, «ऑर्डर बुक» विंडो और Genesis Charts में दिखाती है।
- Execution price $500, $1,000, $2,500, $5,000 या $10,000 के मार्केट ट्रेड की औसत कीमत है;
nullका मतलब है कि उस वॉल्यूम के लिए बुक बहुत पतली है। - बुक एक्सचेंज से 5–20 सेकंड पीछे रहती हैं:
age_secऔरstaleदेखें, और ट्रेड से पहले एक्सचेंज टर्मिनल में बुक जाँचें।
Genesis API का order book API छह endpoint है, जो दिखाते हैं कि तय आकार के ट्रेड पर स्प्रेड का कितना हिस्सा बचता है। ये किसी वॉल्यूम का execution price, आर्बिट्राज पंक्तियों का ऑर्डर-बुक Δ, ऑर्डर बुक और उसकी depth, slippage इतिहास और DEX slippage लौटाते हैं — वही डेटा जो साइट के «ऑर्डर से Δ» कॉलम और Genesis Charts में है।
छह order book endpoint
| Endpoint | क्या लौटाता है | ज़रूरी | डॉक्स |
|---|---|---|---|
/orderbooks/exec | हर मार्केट पर एक वॉल्यूम की खरीद और बिक्री कीमत | volume | निष्पादन कीमतें |
/orderbooks/spreads/{dataset} | आर्बिट्राज डेटासेट में एक कॉइन की पंक्तियों का ऑर्डर-बुक Δ | coin | ऑर्डर-बुक Δ |
/orderbooks/book | एक मार्केट की बुक: 10 स्तर, दीवारें, depth, आयु | exchange, market, coin | बाज़ार ऑर्डर बुक |
/orderbooks/coin/{coin} | हर एक्सचेंज और मार्केट पर कॉइन की बुक | पाथ में coin | कॉइन ऑर्डर बुक |
/orderbooks/exec-history | slippage इतिहास, एक रिक्वेस्ट में 8 मार्केट तक | keys, interval | निष्पादन इतिहास |
/orderbooks/dex-slippage | हर कॉन्ट्रैक्ट का slippage, टैक्स और honeypot फ़्लैग | — | DEX स्लिपेज |
छहों API प्लान Pro ($100 प्रति माह) और Max ($200) में शामिल हैं; Trial और Start पर 403 plan_restricted मिलता है। /orderbooks/exec में और इतिहास के keys पैरामीटर में मार्केट Exchange|market|COIN रूप में लिखा जाता है, जैसे Binance|spot|BTC। नीचे के जवाब के उदाहरण data फ़ील्ड को छोटा करके दिखाते हैं।
Order book डेटा का परिचय order book API लेख में है।
किसी वॉल्यूम का execution price
Execution price वह औसत कीमत है जिस पर तय आकार का मार्केट ऑर्डर बुक से गुज़रता है: खरीद asks लेती है, बिक्री bids पर लगती है, इसलिए यह ट्रेड द्वारा खाए गए ऑर्डरों का VWAP है। /orderbooks/exec इसे ग्रिड के एक वॉल्यूम पर हर मार्केट के लिए लौटाता है।
| पैरामीटर | प्रकार | क्या करता है |
|---|---|---|
volume | संख्या | USD में वॉल्यूम: 500, 1000, 2500, 5000 या 10000, ज़रूरी |
exchange | स्ट्रिंग | एक्सचेंज से फ़िल्टर; कई के लिए कॉमा से अलग करें |
market | स्ट्रिंग | spot या futures |
coin | स्ट्रिंग | कॉइन टिकर, जैसे 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],
…
}
}
हर मार्केट key का मान [खरीद कीमत, बिक्री कीमत] है। कीमत की जगह null का मतलब है कि उस वॉल्यूम के लिए बुक बहुत पतली है: उदाहरण में Ourbit पर SHELL के bids $1,000 की बिक्री नहीं सोख सकते। फ़िल्टर के बिना जवाब में सारे मार्केट होते हैं, इसलिए एक कॉइन चाहिए तो coin दें।
ऑर्डर-बुक Δ: बुक से गुज़रने के बाद का स्प्रेड
ऑर्डर-बुक Δ आर्बिट्राज पंक्ति का वह स्प्रेड है जो तय वॉल्यूम के लिए ऑर्डर बुक से दोबारा निकाला गया हो। /orderbooks/spreads/{dataset} चुने गए डेटासेट में एक कॉइन की हर पंक्ति लेता है और हर एक में order_delta ऑब्जेक्ट जोड़ता है, साइट के कॉलम वाले ही सूत्रों से।
| पैरामीटर | प्रकार | क्या करता है |
|---|---|---|
{dataset} | स्ट्रिंग, पाथ में | spot-spot, spot-futures, futures-futures, dex-spot या dex-futures |
coin | स्ट्रिंग | कॉइन टिकर, ज़रूरी |
volume | संख्या | डिफ़ॉल्ट 0 — बुक की सबसे अच्छी कीमतें; या 500, 1000, 2500, 5000, 10000 |
CEX जोड़ों में खरीद exchange_buy के asks से गुज़रती है और बिक्री exchange_sell के bids में जाती है। order_delta में buy_price और sell_price होते हैं, और नतीजा कभी पंक्ति के spread_pct से ऊपर नहीं जाता।
DEX पंक्तियों में स्प्रेड का चिह्न CEX की तरफ़ तय करता है: spread_pct ≥ 0 हो तो टोकन CEX bids में बेचा जाता है, ऋणात्मक हो तो asks से खरीदा जाता है। order_delta में side और cex_price, यानी CEX का execution price, होता है; अगर बुक से गुज़रने के बाद चिह्न पलट जाए तो Δ 0 होता है।
status फ़ील्ड: ok — गणना हुई, no_book — बुक नहीं है, exhausted — बुक वॉल्यूम नहीं भर पाई।
एक काल्पनिक उदाहरण: कॉइन XYZ, MEXC पर 2.000 में खरीद, Gate पर 2.016 में बिक्री, पंक्ति का स्प्रेड 0.8%। $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"
}
}
पंक्ति के बाकी फ़ील्ड /arbitrage/spot-spot जैसे हैं। पंक्ति का स्प्रेड: (2.016 − 2.000) / 2.000 × 100 = 0.8%।
$5,000 पर MEXC की बुक से खरीद का औसत 2.004 आता है और Gate की बुक में बिक्री 2.010 पर होती है: (2.010 − 2.004) / 2.004 × 100 ≈ 0.2994%। इस आकार पर 0.8% में से लगभग 0.3% बचता है — फ़ीस और ट्रांसफ़र से पहले करीब $15: 5,000 × 0.002994 ≈ 14.97।
Python उदाहरण: बुक से पहले और बाद का स्प्रेड
स्क्रिप्ट Spot – Spot डेटासेट में BTC के लिए $5,000 पर पंक्ति का स्प्रेड और बुक के बाद का स्प्रेड साथ-साथ छापती है। key पर्यावरण चर GENESIS_API_KEY से आती है; 429 और 503 पर स्क्रिप्ट Retry-After सेकंड रुकती है।
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 या डेटा का दोबारा बनना
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API व्यस्त है, बाद में फिर कोशिश करें")
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 या exhausted
print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
f'{row["spread_pct"]}% → {after}')
लूप में meta.freshness_sec सेकंड में एक बार से ज़्यादा poll न करें: Pro पर 10 सेकंड, Max पर 5 सेकंड। कोटा और लिमिट Genesis API की लिमिट गाइड में हैं।
बाज़ार ऑर्डर बुक और कॉइन ऑर्डर बुक
/orderbooks/book एक मार्केट की बुक लौटाता है, साइट की «ऑर्डर बुक» विंडो की तरह। तीन ज़रूरी पैरामीटर मार्केट तय करते हैं: exchange (अक्षर-भेद नहीं), market (spot या futures) और coin। /orderbooks/coin/{coin} कॉइन के हर एक्सचेंज और मार्केट के लिए इन्हीं ऑब्जेक्ट की ऐरे लौटाता है।
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
}
| फ़ील्ड | मतलब |
|---|---|
best_bid, best_ask | सबसे अच्छा bid और ask |
bids, asks | ऊपर के 10 स्तर: [कीमत, USD में राशि] |
walls_bid, walls_ask | सबसे बड़ी दीवारें: [कीमत, USD में राशि] |
depth_bid_usd, depth_ask_usd | सबसे अच्छी कीमत के ±50% के भीतर हर तरफ़ की depth, USD में |
book_ts, age_sec, stale | बुक का समय और सेकंड में उसकी आयु; stale — 30 सेकंड से पुरानी |
source, depth_limited | बुक का स्रोत (ws या rest) और सीमित-depth फ़्लैग |
depth_bid_usd और depth_ask_usd में market depth बुक की एक तरफ़ पड़े ऑर्डरों के डॉलर हैं: उदाहरण में Binance पर BTC के सबसे अच्छे ask से +50% के भीतर लगभग $58.8M के asks हैं।
depth_limited: true हो तो एक्सचेंज अधूरी बुक प्रकाशित करता है और बड़ा वॉल्यूम पूरा न भर पाए। उस एक्सचेंज, मार्केट और कॉइन की बुक न हो तो 404 मिलता है।
निष्पादन इतिहास
/orderbooks/exec-history Genesis Charts का slippage इतिहास है: ग्रिड के हर वॉल्यूम पर निष्पादन की लागत, बुक के मध्य से बेसिस पॉइंट में (1 bp = 0.01%)। एक रिक्वेस्ट में keys में कॉमा से अलग 8 मार्केट तक दिए जा सकते हैं; interval ज़रूरी है।
interval | पॉइंट का अंतराल | 360 पॉइंट कितना कवर करते हैं |
|---|---|---|
1m | 1 मिनट | 6 घंटे |
15m | 15 मिनट | 3.75 दिन |
1h | 1 घंटा | 15 दिन |
1d | 1 दिन | लगभग एक साल |
डेटा 6 सितंबर 2026 से जमा हो रहा है, इसलिए दैनिक सीरीज़ उसी तारीख़ से भरी है।
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 और sell में पाँच-पाँच सीरीज़ हैं, volumes_usd के हर वॉल्यूम की एक, और हर सीरीज़ में सबसे पुराने से नए तक 360 मान। आख़िरी पॉइंट last_bucket_ts का है, और पॉइंट i last_bucket_ts − (points − 1 − i) × step_sec का। खरीद के मान धनात्मक और बिक्री के ऋणात्मक हैं: ट्रेड की औसत कीमत बुक के मध्य से ऊपर और नीचे रहती है।
सीरीज़ [5, 7, 9, …] $10,000 की खरीद है: उसके पहले पॉइंट 5–9 bp, यानी मध्य से 0.05–0.09% ऊपर, पड़ते हैं। सीरीज़ में null का मतलब डेटा नहीं है या बुक नहीं भरी; मार्केट ऑब्जेक्ट की जगह null का मतलब अज्ञात key है।
DEX slippage
/orderbooks/dex-slippage सेटअप के DEX हिस्से का ब्योरा देता है: $100 से $100,000 तक खरीद और बिक्री का slippage, टोकन टैक्स और हर कॉन्ट्रैक्ट का honeypot फ़्लैग — साइट की DEX तालिका के कॉलम जैसा ही। फ़िल्टर: contract (कई के लिए कॉमा से) और 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
}
]
}
Slippage ऐरे sizes_usd ग्रिड के क्रम में हैं: उदाहरण में $5,000 की खरीद पर 0.58% और $100,000 की खरीद पर 6.05% slippage है। ऐरे में null का मतलब है कि उस आकार के लिए पूल में लिक्विडिटी नहीं है।
tax_buy_pct और tax_sell_pct टोकन का खरीद और बिक्री टैक्स हैं, %; null का मतलब स्रोत नहीं है, 0% नहीं। honeypot: no; suspect — स्रोत असहमत हैं; yes — बिक्री असंभव हो सकती है।
सेटअप को बुक से कैसे जाँचें
आर्बिट्राज पंक्ति चुनें
/arbitrage/spot-spotया किसी और डेटासेट में सेटअप ढूँढें — आर्बिट्राज endpoint देखें। कॉइन, एक्सचेंज औरspread_pctनोट करें।बुक से स्प्रेड दोबारा निकालें
उसी कॉइन और अपने ट्रेड के आकार के साथ
/orderbooks/spreads/spot-spotमाँगें औरspread_pctकी तुलनाorder_delta.spread_pctसे करें।फ़्रेशनेस और depth जाँचें
दोनों legs के लिए
/orderbooks/bookबुलाएँ:age_sec,staleऔरdepth_limitedबताते हैं कि आँकड़ों पर भरोसा करें या नहीं, और दीवारें दिखाती हैं कि कीमत कहाँ अटक सकती है।इतिहास से तुलना करें
/orderbooks/exec-historyदिखाता है कि यह slippage इस मार्केट के लिए सामान्य है या नहीं:1m6 घंटे और1h15 दिन कवर करता है।DEX leg का टैक्स जाँचें
DEX – Spot और DEX – Futures सेटअप के लिए पंक्ति के कॉन्ट्रैक्ट पर
/orderbooks/dex-slippageमाँगें: slippage, टैक्स औरhoneypot।
सवाल और जवाब
ऑर्डर-बुक Δ सामान्य स्प्रेड से कैसे अलग है?
पंक्ति का spread_pct एक्सचेंजों की आख़िरी कीमतें लेता है; ऑर्डर-बुक Δ तय वॉल्यूम पर मार्केट ट्रेड की औसत कीमतें लेता है। दोनों का अंतर वही है जो बुक खा जाती है।
कीमत की जगह null क्यों मिलता है?
/orderbooks/exec में उस वॉल्यूम के लिए बुक में ऑर्डर कम हैं; ऑर्डर-बुक Δ में यही स्थिति exhausted स्टेटस है। निष्पादन इतिहास में null का मतलब उस पॉइंट पर डेटा नहीं है, और DEX slippage में पूल में लिक्विडिटी नहीं है।
क्या $10,000 से ऊपर का निष्पादन निकाला जा सकता है?
/orderbooks/exec और ऑर्डर-बुक Δ का ग्रिड $500 से $10,000 तक तय है। बड़े आकार के लिए /orderbooks/book में depth और दीवारें देखें; DEX leg के लिए /orderbooks/dex-slippage $100,000 तक जाता है।