आर्बिट्राज के लिए API डेटा: स्प्रेड, order book और funding
संक्षेप में
- ट्रेडर के हर सवाल का अपना endpoint है: कीमत का अंतर
/arbitrage/*मेंspread_pctहै, कॉइन ट्रांसफ़र डिपॉज़िट और निकासी के फ़्लैग के साथnetworkऔरcontractहै, आपके साइज़ का एक्ज़ीक्यूशन/orderbooks/*है, और funding का मामला/funding/*है। - पंक्ति का स्प्रेड आख़िरी ट्रेड से निकलता है। उदाहरण में 2,500 डॉलर पर 1.5% order book से गुज़रने के बाद 0.72% रह जाता है, और 0.1% के दो taker शुल्क के बाद क़रीब 0.52%, यानी लगभग 13 डॉलर।
- हर रिस्पॉन्स में उसका समय होता है:
meta.updated_atस्नैपशॉट बनने का समय है,meta.freshness_secआपके प्लान का रिफ़्रेश स्टेप है, औरage_secवstaleorder book की उम्र बताते हैं। - जोड़ी को चार बिंदुओं पर जांचा जाता है: कीमत का अंतर, ट्रांसफ़र, order book और ताज़गी। किसी एक पर भी फ़ेल होने से एंट्री रद्द हो जाती है।
- CEX आर्बिट्राज, funding और open interest Genesis API के हर प्लान में हैं, on-chain सेक्शन Start से शुरू होते हैं, और order book व DEX डेटा Pro और Max के साथ आते हैं।
Crypto Arbitrage डेटा पांच सवालों का जवाब देता है: कीमत का अंतर है या नहीं, कॉइन ट्रांसफ़र हो सकता है या नहीं, आपके साइज़ के लिए order book कितनी गहरी है, funding मिलती है या नहीं, और बड़े खिलाड़ी क्या कर रहे हैं। Genesis API में हर सवाल का अपना endpoint और रिस्पॉन्स के कुछ फ़ील्ड हैं। पहली रिक्वेस्ट और success, data, meta वाला लिफ़ाफ़ा पाठ 2 में है; यह पाठ इस बारे में है कि कौन से फ़ील्ड और किस क्रम में पढ़ें।
ट्रेडर का सवाल → endpoint → फ़ील्ड
| सवाल | Endpoint | फ़ील्ड |
|---|---|---|
| कीमत का अंतर है या नहीं | /arbitrage/* | spread_pct, price_buy, price_sell |
| कॉइन ट्रांसफ़र हो सकता है या नहीं | वही /arbitrage/spot-spot पंक्ति | withdraw_enabled_buy, deposit_enabled_sell, network, contract |
| book पर्याप्त गहरी है या नहीं | /orderbooks/* | order_delta.spread_pct, order_delta.status |
| funding मिलती है या नहीं | /funding/* | spread_pct, interval_1, interval_2, next_payout_1 |
| बड़े खिलाड़ी क्या कर रहे हैं | /onchain/*, /market/open-interest | direction, total_usd, oi_change_1h |
तारा एक समूह का निशान है: /arbitrage/* में सात endpoint हैं, Spot – Spot से स्टॉक तक, जबकि /orderbooks/* और /funding/* में छह-छह। नीचे के सेक्शन उसी क्रम में हैं जिसमें आप जोड़ी को जांचते हैं।
कीमत का अंतर है या नहीं: spread_pct
Spot — Spot डॉक्स की एक पंक्ति: FUEL, ByBit पर 0.0007029 में खरीदें, Gate पर 0.0007037 में बेचें, spread_pct 0.11। जांच: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%। पंक्ति का स्प्रेड price_buy और price_sell से निकलता है, जो आख़िरी ट्रेड की कीमतें हैं; साइट पर यह कीमत वाला कॉलम है।
DEX – Spot और DEX – Futures डेटासेट में चिह्न मायने रखता है: प्लस का मतलब टोकन DEX पर सस्ता है, माइनस का मतलब महंगा। सातों डेटासेट के पैरामीटर और फ़ील्ड आर्बिट्राज endpoint गाइड में हैं।
spread_pct सिर्फ़ पहले सवाल का जवाब देता है: इसमें न शुल्क है, न ट्रांसफ़र, न order book।
कॉइन ट्रांसफ़र हो सकता है या नहीं: डिपॉज़िट, निकासी, नेटवर्क और कॉन्ट्रैक्ट
दो एक्सचेंज के बीच की स्पॉट जोड़ी में ट्रांसफ़र चाहिए: आप कॉइन एक एक्सचेंज पर खरीदते हैं, निकालते हैं और दूसरे पर जमा करते हैं। इसलिए पंक्ति में पढ़ने के लिए दो फ़्लैग हैं: withdraw_enabled_buy यानी खरीद वाले एक्सचेंज पर निकासी खुली है या नहीं, और deposit_enabled_sell यानी बिक्री वाले एक्सचेंज पर डिपॉज़िट खुला है या नहीं। रिक्वेस्ट में इनके लिए कोई पैरामीटर नहीं है, इसलिए पंक्तियाँ आपका कोड छांटता है।
network और contract बताते हैं कि टोकन वही है या नहीं। अलग-अलग एक्सचेंज पर एक ही टिकर के नीचे अलग कॉइन ट्रेड हो सकते हैं, इसलिए कॉन्ट्रैक्ट पता दोनों एक्सचेंज के निकासी और डिपॉज़िट पेज से मिलाएं। किसी कॉइन के हर नेटवर्क के कॉन्ट्रैक्ट और उन्हें इस्तेमाल करने वाले एक्सचेंज किसी भी प्लान में /coins/search से मिलते हैं (Coin Search)।
DEX डेटासेट में फ़्लैग CEX वाले पक्ष के हैं: deposit_enabled और withdraw_enabled। Cross-chain में टोकन buy.chain और sell.chain नेटवर्क के बीच ब्रिज से जाता है, इसलिए एक्सचेंज फ़्लैग नहीं हैं।
order book पर्याप्त गहरी है या नहीं: पंक्ति का स्प्रेड बनाम एक्ज़ीक्यूशन के बाद का स्प्रेड
मार्केट ऑर्डर order book से गुज़रता है: खरीद सबसे अच्छे ask से ऊपर की ओर लेती है, बिक्री bid नीचे की ओर लेती है। साइज़ जितना बड़ा, औसत कीमत उतनी ख़राब और पंक्ति के स्प्रेड में उतना कम बचता है। Order-book Δ, यानी Pro और Max प्लान में /orderbooks/spreads/{dataset}, आपके साइज़ के लिए जो बचता है वह लौटाता है (डॉक्स)।
उदाहरण: कॉइन LMN, OKX पर 0.4000 में खरीदें, Bitget पर 0.4060 में बेचें। पंक्ति का स्प्रेड: (0.4060 − 0.4000) / 0.4000 × 100 = 1.5%। /orderbooks/spreads/spot-spot को coin=LMN और अलग-अलग volume के साथ मांगने पर:
| साइज़ | खरीद → बिक्री | Order-book Δ | डॉलर में |
|---|---|---|---|
0 | 0.4002 → 0.4058 | 1.3993% | — |
| 500 डॉलर | 0.4004 → 0.4055 | 1.2737% | 6.37 डॉलर |
| 2,500 डॉलर | 0.4012 → 0.4041 | 0.7228% | 18.07 डॉलर |
| 10,000 डॉलर | — | exhausted | — |
volume=0 OKX का सबसे अच्छा ask और Bitget का सबसे अच्छा bid इस्तेमाल करता है: सबसे अच्छे ऑर्डर आख़िरी ट्रेड से बदतर बैठते हैं, इसलिए सबसे छोटे साइज़ पर भी 0.1 प्रतिशत अंक चले जाते हैं। 2,500 डॉलर पर औसत खरीद कीमत 0.4012 और औसत बिक्री कीमत 0.4041 है: (0.4041 − 0.4012) / 0.4012 × 100 ≈ 0.7228%। 10,000 डॉलर पर Bitget के bid ख़त्म हो गए और order_delta.status exhausted है।
हर एक्सचेंज taker शुल्क लेता है; उदाहरण में 0.1% माना गया है (maker और taker)। 2,500 डॉलर पर आपके पास 0.7228 − 2 × 0.1 = 0.5228% बचता है, यानी 2,500 × 0.5228 / 100 ≈ 13.07 डॉलर। निकासी शुल्क रिस्पॉन्स में नहीं हैं: उन्हें एक्सचेंज के निकासी पेज पर देखें और अलग से घटाएं।
Trial और Start में order book endpoint 403 plan_restricted लौटाते हैं, इसलिए book को एक्सचेंज टर्मिनल में जांचें। एक्ज़ीक्यूशन कीमत और स्लिपेज Crypto order book API में समझाए गए हैं, और छहों endpoint order book endpoint गाइड में।
funding मिलती है या नहीं: स्प्रेड, अंतराल और भुगतान
Funding आर्बिट्राज यानी जहां funding rate ऊंची है वहां शॉर्ट और जहां नीची है वहां लॉन्ग: कीमत की चाल से नतीजा मुश्किल से बदलता है, और दरों का अंतर जमा होता है। उम्मीदवार किसी भी प्लान में /funding/spread से आते हैं: best में सबसे अच्छी एक्सचेंज जोड़ी और उसका spread_pct (Funding spread)।
जोड़ी का स्प्रेड यह नहीं बताता कि भुगतान कब और कितनी बार होते हैं। interval_1 और interval_2 दोनों एक्सचेंज के funding अंतराल हैं, और next_payout_1 व next_payout_2 अगले भुगतान का समय UTC में: funding सिर्फ़ वह पोज़िशन पाती है जो सेटलमेंट के क्षण पर खुली हो। अलग अंतराल वाली दरों की तुलना 8 घंटे पर सामान्य करके की जाती है, यही /funding/rates का funding_8h_pct फ़ील्ड है।
उदाहरण: 8 घंटे में 0.03% का स्प्रेड, हर पैर पर 5,000 डॉलर की पोज़िशन। एक सेटलमेंट से 5,000 × 0.03 / 100 = 1.5 डॉलर मिलते हैं। चार ट्रेड, यानी दोनों पैर खोलना और बंद करना, 0.1% taker शुल्क पर 4 × 5,000 × 0.1 / 100 = 20 डॉलर के होते हैं। शुल्क 20 / 1.5 ≈ 13.3 सेटलमेंट के बाद वसूल होता है: यानी 14 आठ-घंटे वाले सेटलमेंट, लगभग पांच दिन, अगर दरें टिकी रहें।
इतिहास दिखाता है कि अंतर टिकता है या नहीं: Pro और Max में coin के साथ /funding/analytics/summary हर एक्सचेंज के लिए हर अवधि का sum (जमा funding), cov (कवरेज) और flips (चिह्न बदलना) लौटाता है। विवरण Funding rate API और funding endpoint गाइड में हैं।
बड़े खिलाड़ी क्या कर रहे हैं: on-chain और open interest
On-chain डेटा और open interest बताते हैं कि आपके एक्ज़ीक्यूट करने से पहले जोड़ी क्यों बंद हो सकती है। बिक्री वाले एक्सचेंज में कॉइन का आना यानी ऐसे विक्रेता जो आपके ट्रांसफ़र से पहले पहुंच जाते हैं। open interest का बढ़ना यानी नई लीवरेज वाली पोज़िशन, और उनके ख़िलाफ़ तेज़ चाल लिक्विडेशन लाती है।
| आप क्या देखते हैं | रिक्वेस्ट | फ़ील्ड | प्लान |
|---|---|---|---|
| एक्सचेंज में और से कॉइन का प्रवाह | /onchain/coin-traffic | direction, target, total_usd | Start, Pro, Max |
| टोकन अनलॉक | /onchain/unlocks | unlock_value_usd, hours_left | Start, Pro, Max |
| एक्सचेंज के अनुसार open interest | /market/open-interest | oi_usd, oi_change_1h, price_change_1h | सभी |
Genesis Onchain डॉक्स का नमूना रिस्पॉन्स 5.69 घंटे में Gate पर 18 LAB ट्रांसफ़र दिखाता है, कुल 573,796.98 डॉलर, और direction deposit है। अगर उस क्षण LAB की कोई जोड़ी Gate पर बिक रही हो, तो ऐसा प्रवाह साइज़ घटाने या एंट्री छोड़ने की वजह है। अधिक On-chain data API और Open interest API में।
डेटा की ताज़गी और टाइमस्टैम्प
हर रिस्पॉन्स में उसका समय होता है: meta.updated_at स्नैपशॉट बनने का unix समय है, और meta.freshness_sec आपके प्लान का रिफ़्रेश स्टेप: Trial में 60 सेकंड, Start में 30, Pro में 10 और Max में 5। स्नैपशॉट की उम्र है मौजूदा समय घटा updated_at (डेटा की ताज़गी)।
उदाहरण: Trial प्लान, रिस्पॉन्स 1783802455 पर आया और updated_at 1783802410 है। स्नैपशॉट की उम्र 1783802455 − 1783802410 = 45 सेकंड है: उसकी जोड़ियां लगभग एक मिनट पुरानी कीमतों से निकली थीं, और कुछ एक्सचेंज पर अब तक ख़त्म हो चुकी हो सकती हैं।
Order book की अपनी घड़ी है: /orderbooks/book और /orderbooks/coin/{coin} में हर book का book_ts, age_sec (सेकंड में उम्र) और stale: true होता है, जब वह 30 सेकंड से पुरानी हो। Book एक्सचेंज से 5–20 सेकंड पीछे रहती हैं, इसलिए दोनों पैरों की book की उम्र जांचें: ताज़ा और पुरानी book के बीच कीमत का अंतर समय का अंतर हो सकता है।
एक फ़ील्ड काफ़ी क्यों नहीं: चार-बिंदु जांच
हर फ़ील्ड एक सवाल बंद करता है, और एंट्री तभी हो सकती है जब सब बंद हों। निकासी बंद होने पर 3% का स्प्रेड कॉइन को खरीद वाले एक्सचेंज पर अटका देता है। exhausted के साथ आपका साइज़ नहीं भरेगा। 50 सेकंड पुराने स्नैपशॉट के साथ जोड़ी पहले ही जा चुकी हो सकती है।
| बिंदु | फ़ील्ड | जोड़ी फ़ेल होती है अगर |
|---|---|---|
| 1. कीमत का अंतर | spread_pct | स्प्रेड घटा दो शुल्क थ्रेशोल्ड से कम हो |
| 2. ट्रांसफ़र | withdraw_enabled_buy, deposit_enabled_sell, contract | निकासी या डिपॉज़िट बंद हो, या कॉन्ट्रैक्ट न मिले |
| 3. Order book | order_delta.status, order_delta.spread_pct | स्टेटस ok न हो या जो बचा वह थ्रेशोल्ड से कम हो |
| 4. ताज़गी | meta.updated_at, age_sec, stale | स्नैपशॉट या कोई book थ्रेशोल्ड से पुरानी हो |
फ़ंक्शन /arbitrage/spot-spot की एक data पंक्ति, उसी एक्सचेंज जोड़ी का order_delta ऑब्जेक्ट (Trial और Start में None) और रिस्पॉन्स का meta लेता है। थ्रेशोल्ड उदाहरण के लिए हैं: उन्हें अपने शुल्क और प्लान के हिसाब से बदलें।
import time
FEE = 0.1 # assumed taker fee per leg, %
MIN_NET = 0.3 # at least 0.3% left after fees
MAX_AGE = 60 # snapshot no older than 60 seconds
def check(row, od, meta):
"""The points a Spot – Spot pair failed."""
fails = []
if row["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("1: spread does not cover the fees")
if not row["withdraw_enabled_buy"]:
fails.append("2: withdrawals closed on the buy exchange")
if not row["deposit_enabled_sell"]:
fails.append("2: deposits closed on the sell exchange")
if od is None:
fails.append("3: book not checked (Trial or Start)")
elif od["status"] != "ok":
fails.append("3: book — " + od["status"])
elif od["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("3: too little left after the book")
if time.time() - meta["updated_at"] > MAX_AGE:
fails.append("4: snapshot older than MAX_AGE seconds")
return fails
ख़ाली सूची का मतलब है कि जोड़ी चारों बिंदु पार कर गई। 2,500 डॉलर पर LMN जोड़ी पार कर जाती है: पंक्ति पर 1.5 − 0.2 = 1.3%, book के बाद 0.7228 − 0.2 = 0.5228%, और 45 सेकंड पुराना स्नैपशॉट। 10,000 डॉलर पर फ़ंक्शन "3: book — exhausted" लौटाता है। कोड कॉन्ट्रैक्ट की पुष्टि नहीं कर सकता: पता आप एक्सचेंज के निकासी और डिपॉज़िट पेज पर जांचते हैं, और दोनों पैरों की book की उम्र /orderbooks/book से आती है।
साइट की टेबल पर यही जांच बिना कोड के स्प्रेड, गहराई, वॉल्यूम — टेबल पढ़ना पाठ में है, और लूप में API पोल करना पाठ 4 में।
कौन सा डेटा किस प्लान में मिलता है
| प्लान | ताज़गी | आर्बिट्राज डेटा |
|---|---|---|
| Trial, 20 डॉलर महीना | 60 से | Spot – Spot, Spot – Futures, Futures – Futures, funding दरें और स्प्रेड, open interest, Fair – Last, पंप, कॉइन खोज |
| Start, 50 डॉलर | 30 से | Trial का सब कुछ, साथ में स्टॉक, on-chain सेक्शन /onchain/{section}, exact और dutch मोड में प्रेडिक्शन आर्बिट्राज |
| Pro, 100 डॉलर | 10 से | सभी endpoint: order book और Order-book Δ, DEX – Spot, DEX – Futures, Cross-chain, funding एनालिटिक्स |
| Max, 200 डॉलर | 5 से | Pro जैसे ही endpoint, प्रति सेकंड 15 रिक्वेस्ट के साथ |
आपके प्लान से बाहर का endpoint 403 plan_restricted लौटाता है, और वह रिस्पॉन्स कोटा नहीं खाता। कॉल कोटा और प्रति सेकंड रिक्वेस्ट की सीमाएं Genesis API की क़ीमतें पेज पर हैं।
अभ्यास
एक जोड़ी लें
Spot — Spot डॉक्स में «आज़माएं» फ़ॉर्म खोलें, अपनी कुंजी चिपकाएं और 1% या उससे ज़्यादा स्प्रेड वाली पंक्ति चुनें।
बिंदु 1 और 2 जांचें
spread_pctमें से 0.1% के दो मान लिए गए शुल्क घटाएं औरwithdraw_enabled_buyवdeposit_enabled_sellदेखें।contractको इस कॉइन के/coins/searchरिस्पॉन्स से मिलाएं।बिंदु 3 जांचें
Pro या Max पर इस कॉइन और
volume=1000के साथ/orderbooks/spreads/spot-spotमांगें और उसी एक्सचेंज जोड़ी की पंक्ति ढूंढें। Trial और Start पर order book एक्सचेंज टर्मिनल में खोलें।बिंदु 4 जांचें
मौजूदा unix समय में से
meta.updated_atघटाएं: टर्मिनल मेंdate +%sउसे छापता है।निष्कर्ष लिखें
कौन सा बिंदु जोड़ी को सबसे पहले ख़ारिज करता, और 1,000 डॉलर पर स्प्रेड में कितना बचता।
सवाल और जवाब
Crypto Arbitrage के लिए कौन सा डेटा चाहिए?
अलग-अलग एक्सचेंज पर कॉइन की कीमतें और उनके बीच का स्प्रेड, डिपॉज़िट और निकासी की स्थिति नेटवर्क और कॉन्ट्रैक्ट के साथ, आपके साइज़ का एक्ज़ीक्यूशन निकालने के लिए order book, और स्नैपशॉट का समय। Funding आर्बिट्राज में दरें, अंतराल और भुगतान का समय जुड़ता है। Genesis API में ये /arbitrage/*, /orderbooks/* और /funding/* हैं।
क्या Genesis API से ट्रेड किया जा सकता है?
नहीं। Genesis API सिर्फ़ डेटा पढ़ता है और ऑर्डर नहीं लगाता: ट्रेड आप ख़ुद एक्सचेंज पर खोलते हैं।