On-chain data API: whale transfer, exchange flow और token unlock
संक्षेप में
- On-chain data API blockchain की घटनाएँ पहले से डीकोड करके देता है: कौन सा token, किससे, किसे और कितने डॉलर का गया। कच्चा डेटा node से आता है, indexer उसे टेबल में बदलते हैं, और address label सिर्फ़ अनुमान रहते हैं जो गलत भी हो सकते हैं।
- Trader exchange में जमा और निकासी, बड़े transfer, team wallet की हलचल, perp DEX positions, unlock, claim, hack और बड़े DEX swap पर नज़र रखते हैं। Exchange में जमा हमेशा बिक्री पर नहीं रुकता।
- Genesis API में नौ on-chain सेक्शन Start प्लान से उपलब्ध हैं, जबकि DEX swap, analytics और coin summary के लिए Pro या Max चाहिए। विंडो और flow का योग आपका कोड निकालता है, क्योंकि सेक्शन में समय का पैरामीटर नहीं है।
On-chain data API blockchain की उन घटनाओं का HTTP इंटरफ़ेस है जो पहले ही इकट्ठा, डॉलर में बदली और label की जा चुकी हैं: कौन सा token, किस address से, किस address को और किस transaction में गया। ऐसे API से आप अपना node या indexer चलाए बिना whale transfer, exchange में जमा, token unlock और DEX पर बड़े swap ट्रैक कर सकते हैं। Whale यहाँ वह address है जिसके पास किसी coin की इतनी मात्रा है कि उसके transfer बाज़ार को हिला देते हैं।
On-chain डेटा कहाँ से आता है
डेटा तीन परतों से गुज़रता है: node blocks रखता है, indexer उन्हें event की पंक्तियों में बदलता है, और label डेटाबेस addresses को नाम देता है।
Node: blocks और logs
Blockchain node blocks स्टोर करता है और JSON-RPC से उन्हें देता है। Ethereum और संगत chains पर ERC-20 token का transfer transaction log में Transfer(address indexed _from, address indexed _to, uint256 _value) event के रूप में लिखा जाता है, और मानक सुझाव देता है कि नए token mint होने पर यही event 0x0 को भेजने वाला बनाकर जारी किया जाए (EIP-20)।
eth_getLogs मेथड फ़िल्टर से मेल खाने वाले logs लौटाता है: block की सीमा fromBlock और toBlock, contract का address और event के topics (Ethereum JSON-RPC)। Log में addresses, block नंबर, transaction hash और token की सबसे छोटी इकाइयों में राशि होती है। Block में न डॉलर की कीमत होती है, न मालिक का नाम, न exchange का निशान।
Indexer: logs से टेबल तक
Indexer blocks को क्रम से पढ़ता है, events डीकोड करता है और उन्हें टेबलों में बाँटता है: transfers, swaps, pool में बदलाव। वह राशि को token के decimals घात 10 से भाग देता है (आठ दशमलव अंकों पर यानी 100,000,000 से भाग) और block के समय की कीमत से गुणा करता है; इससे डॉलर मूल्य मिलता है।
फिर thresholds आते हैं: फ़ीड तय राशि से ऊपर के transfer रखता है, और एक address को छोटे transfers की श्रृंखला एक पंक्ति में मिला दी जाती है। कई chains के लिए ऐसी pipeline चलाना अपने आप में एक प्रोजेक्ट है, और on-chain data API उसका नतीजा एक अनुरोध में देता है।
Address label: address के पीछे कौन है
Label वह नाम है जो address से जोड़ा जाता है: "Binance", "project treasury", "market maker"। यह सबूतों के आधार पर दिया जाता है: address किसी जाने-माने exchange wallet को coins भेजता है, प्रोजेक्ट ने अपने addresses खुद प्रकाशित किए हैं, address को vesting contract से tokens मिले हैं। मालिक इनमें से कुछ भी पुष्ट नहीं करता, इसलिए label पुराना या सीधे गलत हो सकता है।
जिस address के पक्ष में सबूत नहीं, वह बेनाम रहता है: Genesis API दस्तावेज़ के उदाहरणों में ऐसा भेजने वाला छोटा address 0xec01…d1a5 दिखाता है।
Traders के लिए कौन सी on-chain घटनाएँ मायने रखती हैं
एक काल्पनिक उदाहरण: एक सुबह में किसी प्रोजेक्ट के coin के $2,000,000 exchanges में गए और उसके team wallet से $500,000 market maker के address पर निकले। हर घटना अकेले कम कहती है; साथ में वे कीमत, open interest और unlock शेड्यूल जाँचने की वजह हैं।
| घटना | क्या दिखता है | आम तौर पर कैसे पढ़ा जाता है |
|---|---|---|
| Exchange में जमा | Coins exchange के address पर पहुँचते हैं | संभावित बिक्री, collateral या फेरबदल |
| Exchange से निकासी | Coins बाहरी address पर जाते हैं | भंडारण, DeFi या दूसरा exchange |
| बड़ा transfer | Addresses के बीच threshold से ऊपर का transfer | Whale अपनी position खिसका रहा है |
| Team wallet | Foundation, treasury या founders के addresses से हलचल | Exchange में जमा आंतरिक हलचल से ज़्यादा वज़न रखता है |
| Perp DEX position | Long या short: आकार, कीमत, प्लेटफ़ॉर्म | Whale का दाँव और liquidation का जोखिम |
| Unlock | रिलीज़ की तारीख, हिस्सा और मूल्य | Coin की नई आपूर्ति |
| Claim | Airdrop, vesting, rewards के tokens | पाने वाले तुरंत बेच सकते हैं |
| Mint और bridge | Token जारी होना, chains के बीच आवाजाही | Stablecoin mint का मतलब पैसे का आना |
| Hack | Protocol, नुकसान, हमले का तरीका | Token और जुड़ी chains के लिए जोखिम |
| DEX swap | दिशा, राशि, pool में हिस्सा, कीमत की चाल | Exchanges के प्रतिक्रिया देने से पहले कीमत में बदलाव |
विकेंद्रीकृत exchanges पर perpetual futures की positions, यानी perp DEX, दिखती हैं क्योंकि ये प्लेटफ़ॉर्म अपना डेटा खुला रखते हैं। Hyperliquid पर info endpoint POST https://api.hyperliquid.xyz/info का clearinghouseState अनुरोध किसी भी address की खुली positions और margin बिना key के लौटाता है (Hyperliquid docs)। CEX दूसरे traders की positions नहीं छापते; वे open interest जैसे कुल आँकड़े देते हैं।
Unlock team, निवेशकों या foundation के tokens का vesting शेड्यूल के अनुसार रिलीज़ होना है, जो उन्हें तय समय-सारणी पर किस्तों में बाँटता है। तारीख पहले से पता होती है, इसलिए बाज़ार बिक्री को घटना से पहले ही कीमत में शामिल कर सकता है।
DEX swap उसी block में pool की कीमत खिसका देता है। एक काल्पनिक उदाहरण: $1,200,000 की liquidity वाले pool में $150,000 की खरीद 150,000 / 1,200,000 × 100 = 12.5% pool लेती है। Pool की कीमत साफ़ खिसकती है, जबकि exchanges पर यह चाल देर से दिखती है या बिल्कुल नहीं दिखती। DEX और CEX की कीमतों की तुलना DEX API लेख में है।
Hack on-chain में protocol के contract से बाहर जाते transfers के रूप में दिखता है। Bridges पर बाकी protocols से ज़्यादा हमले होते हैं क्योंकि उनके contracts में बड़ी रकमें रहती हैं: उल्लेखनीय मामले blockchain bridges लेख में हैं, और किसी exchange से चोरी Bybit hack के विश्लेषण में।
देरी और पुष्टि
Transaction और आपके कोड तक पहुँची पंक्ति के बीच सेकंड से मिनट गुज़रते हैं; यही डेटा की latency है। Flows की दैनिक झलक के लिए यह मुश्किल से मायने रखती है, पर जब आप एक बड़े जमा या swap पर प्रतिक्रिया देते हैं तब नतीजा तय करती है।
Network की पुष्टि
Ethereum पर नया block हर slot में, यानी हर 12 सेकंड में आ सकता है, और लगभग 15 मिनट बाद final हो जाता है (ethereum.org)। Final हुए block को बदला नहीं जा सकता, जब तक भारी मात्रा में ETH न खो जाए। जिस indexer को सिर्फ़ तय हो चुकी तस्वीर चाहिए, वह finalized टैग तक के blocks पढ़ सकता है; node आख़िरी final block को यही नाम देता है।
Exchange जमा तब क्रेडिट करता है जब transaction network की पुष्टियों की न्यूनतम संख्या तक पहुँचता है, और Binance में, उदाहरण के लिए, यह न्यूनतम हर coin का अलग है (Binance FAQ)। इसलिए exchange में जमा on-chain में तब दिखता है जब मालिक उन coins को बेच भी नहीं सकता।
डेटा में देरी
Genesis API दस्तावेज़ के swap उदाहरण में ts = 1794675511 swap का समय है और published_at = 1794675523 प्रकाशन का समय: दोनों में 1794675523 − 1794675511 = 12 सेकंड का अंतर है। इस पर आपके प्लान की data freshness meta.freshness_sec में जुड़ती है (Start पर 30 सेकंड, Pro पर 10, Max पर 5) और आपका polling अंतराल भी।
| चरण | कितना समय | इसका मतलब |
|---|---|---|
| Ethereum block | 12 से का slot | Transaction दिखता है पर final नहीं है |
| Ethereum finality | लगभग 15 मिनट | Block अब नहीं बदलेगा |
| Exchange में क्रेडिट | Exchange की पुष्टियों का न्यूनतम | हर coin का अलग |
| Swap का प्रकाशन | उदाहरण में 12 से | Record अभी final नहीं है |
final स्थिति | swap के कम से कम 5 मिनट बाद | 30 से और 5 मिनट बाद की कीमत पता है |
| Genesis API से डिलीवरी | 30, 10 या 5 से | Start, Pro और Max प्लान |
Swaps के लिए बिना जाँचे records वाली period=live फ़ीड तेज़ है, पर अगर swap असल में liquidity का फेरबदल निकले तो record गायब हो सकता है। final=true पैरामीटर सिर्फ़ जाँचे हुए swaps रखता है, जो कम से कम 5 मिनट देर से आते हैं।
Genesis API में on-chain डेटा
Genesis API Genesis OnChain सेक्शन की फ़ीड लौटाता है: transfer की पंक्तियों में पहले से भेजने और पाने वाले के label, डॉलर और token में राशि, transaction hash और explorer लिंक होते हैं। अनुरोध HTTP GET हैं जिनमें key X-API-Key हेडर में जाती है, और जवाब JSON है जिसमें data फ़ील्ड और meta ब्लॉक है।
| Endpoint | क्या लौटाता है | प्लान |
|---|---|---|
/onchain/{section} | 9 on-chain सेक्शन में से एक | Start, Pro, Max |
/onchain | सभी 9 सेक्शन एक ऑब्जेक्ट में | Start, Pro, Max |
/onchain/dex-swaps | बड़े DEX swap | Pro, Max |
/onchain/analytics | 24h या 7d के योग | Pro, Max |
/onchain/coin/{symbol} | Coin का 7 दिन का सार | Pro, Max |
सेक्शन के नाम फ़ीड के नाम पर हैं: large-transfers, cex-flows, mint-bridge, team-wallets, perp-positions, unlocks, claims, hacks और coin-traffic, जिसमें एक coin के एक लक्ष्य तक transfers की श्रृंखलाएँ रहती हैं। फ़िल्टर min_usd और coin हैं, साथ ही unlocks के लिए when जिसका मान upcoming या past है। समय का कोई पैरामीटर नहीं है, इसलिए विंडो ts फ़ील्ड से निकाली जाती है।
$1,000,000 से ज़्यादा के आने वाले token unlocks का अनुरोध:
curl -G "https://api.genesisarbitrage.com/v1/onchain/unlocks" \
-d when=upcoming -d min_usd=1000000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Unlock की पंक्ति में unlock_percent और unlock_value_usd (हिस्सा और मूल्य), hours_left (घटना तक के घंटे) और allocations (पाने वालों के हिसाब से बँटवारा) होते हैं।
Pro और Max तीन endpoints जोड़ते हैं। /onchain/dex-swaps बड़े swaps को pool की liquidity में हिस्से, अनुमानित price impact और 30 सेकंड तथा 5 मिनट बाद की कीमत की चाल के साथ लौटाता है (दस्तावेज़ में DEX ओवरव्यू)। /onchain/analytics 24h या 7d के योग निकालता है: kpi.cex_in, kpi.cex_out, kpi.cex_net और हर exchange के flows (ऑनचेन एनालिटिक्स)। /onchain/coin/{symbol} किसी coin की 7 दिन की घटनाएँ, swaps और unlocks को उसकी CEX कीमत, OI और funding के साथ इकट्ठा करता है (ऑनचेन कॉइन)।
सिर्फ़ 200 जवाब कोटा खर्च करता है, और Trial पर on-chain endpoints 403 plan_restricted लौटाते हैं। Start 2M कॉल के लिए $50 प्रति माह है, Pro 5M के लिए $100, Max 10M के लिए $200 (Genesis API की कीमतें)। हर पैरामीटर और फ़ील्ड, जवाबों के उदाहरणों के साथ, on-chain endpoints गाइड में है।
कोड के बिना वही फ़ीड Genesis OnChain डैशबोर्ड पर हैं, swaps DEX ओवरव्यू में, और दैनिक व साप्ताहिक योग ऑनचेन एनालिटिक्स में।
Python: एक विंडो में किसी coin का exchanges में जमा
एक काल्पनिक उदाहरण: 6 घंटे में ARB के पाँच transfers exchanges में पहुँचे, $640,000, $520,000, $410,000, $330,000 और $150,000 के। योग 640,000 + 520,000 + 410,000 + 330,000 + 150,000 = 2,050,000 है, यानी $2,000,000 की threshold पार हो जाती है। जैसे ही पहला transfer 6 घंटे से पुराना होता है, वह विंडो से बाहर हो जाता है: 2,050,000 − 640,000 = 1,410,000, और योग फिर threshold से नीचे गिर जाता है।
cex-flows में direction फ़ील्ड नहीं है, इसलिए दिशा label से तय होती है: to_name में exchange का मतलब जमा है, from_name में exchange का मतलब निकासी। जवाब सेक्शन की मौजूदा फ़ीड है, इसलिए स्क्रिप्ट जमा को tx_hash से रखती है और पुराने खुद हटाती है। इस तरह polls के बीच विंडो का योग दो बार नहीं गिना जाता।
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
COIN, MIN_USD = "ARB", 50_000
WINDOW = 6 * 3600 # विंडो, सेकंड में
ALERT_USD = 2_000_000 # जमा का योग जो अलर्ट चलाता है
CEX = ("binance", "okx", "bybit", "coinbase", "kraken")
deposits = {} # tx_hash -> (ts, usd)
alerted = False
def to_exchange(row):
label = (row.get("to_name") or "").lower()
return any(name in label for name in CEX)
while True:
r = requests.get(f"{API}/onchain/cex-flows", headers=HEADERS,
params={"coin": COIN, "min_usd": MIN_USD},
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()
body = r.json()
for row in body["data"]:
if row.get("tx_hash") and to_exchange(row):
deposits[row["tx_hash"]] = (row.get("ts") or 0,
row.get("usd") or 0)
start = time.time() - WINDOW
deposits = {h: v for h, v in deposits.items() if v[0] >= start}
total = sum(usd for _, usd in deposits.values())
print(f"{COIN}: to exchanges in 6 h ${total:,.0f}, "
f"transfers {len(deposits)}")
if total >= ALERT_USD and not alerted:
print("Threshold crossed: check price, OI and funding")
alerted = total >= ALERT_USD
time.sleep(body["meta"]["freshness_sec"])
CEX टपल में label के अंश हैं; वे exchanges जोड़ें जहाँ coin ट्रेड होता है। स्क्रिप्ट सिर्फ़ गिनती और प्रिंट करती है: Genesis API कोई orders नहीं लगाता, और trading का फ़ैसला आपके पास रहता है।
coin और min_usd वाले अनुरोध का जवाब ETag के बिना आता है, इसलिए हर poll एक कॉल खर्च करता है। Start पर विराम 30 सेकंड है, यानी 30 दिनों में 2,592,000 / 30 = 86,400 कॉल, या 2M कोटे का 4.32%। दर्जन भर coins के लिए /onchain/cex-flows फ़ीड बिना फ़िल्टर के लें और खुद बाँटें: पूरा सेट ETag के साथ आता है, और अपरिवर्तित डेटा पर If-None-Match के साथ दोहराया अनुरोध 304 लौटाता है और कोटा खर्च नहीं करता।
min_usd से नीचे के transfers नहीं गिने जाएँगे: एक coin के एक exchange को छोटे transfers की श्रृंखलाएँ coin-traffic में समूहित होती हैं, फ़ील्ड direction, total_usd, count और window_hours के साथ।
Exchange में जमा को कैसे पढ़ें
6 घंटे में exchanges पर पहुँचे ARB के वही $2,050,000 बिक्री की तैयारी, futures का collateral या मालिक के अपने खातों के बीच आवाजाही हो सकते हैं। फ़ीड की एक पंक्ति नहीं बताएगी कि कौन सा।
| परिदृश्य | और क्या दिखता है | कैसे जाँचें |
|---|---|---|
| बिक्री की तैयारी | DEX पर बिक्री, कीमत कमज़ोर | side=sell के साथ /onchain/dex-swaps |
| Futures collateral | Open interest बढ़ता है, funding बदलती है | /market/open-interest, /funding/rates |
| आंतरिक फेरबदल | उसी exchange से मेल खाती निकासी | cex-flows में from_name, explorer |
| Team या fund की बिक्री | भेजने वाला team wallet है | team-wallets, unlocks |
एक coin पर कई घटनाएँ अकेली घटना से ज़्यादा वज़न रखती हैं: exchange में जमा, team wallet से transfer और नज़दीकी unlock। आप इन्हें एक /onchain/coin/{symbol} जवाब में देख सकते हैं, जहाँ घटनाएँ oi_usd और funding_8h वाले cex ब्लॉक के पास होती हैं। तालिका के /market/open-interest और /funding/rates endpoints Trial से उपलब्ध हैं।
अन्य बाज़ार डेटा और काम के लिए स्रोत चुनने का तरीका Crypto API ओवरव्यू में है।
सवाल और जवाब
On-chain डेटा में address label कितने सटीक हैं?
Label सबूतों के आधार पर दिए जाते हैं और address का मालिक उन्हें पुष्ट नहीं करता, इसलिए पूरी सटीकता संभव नहीं है। जितने ज़्यादा transfers किसी address को जाने-माने wallet से जोड़ते हैं, निष्कर्ष उतना भरोसेमंद है, और नए addresses ज़्यादातर बेनाम रहते हैं। किसी भी बड़ी घटना को explorer लिंक से जाँचें।
क्या Genesis API में on-chain इतिहास है?
गहरा आर्काइव नहीं है। सबसे लंबी विंडो 7 दिन की हैं: swaps और analytics के लिए period=7d और 7 दिन का coin summary, जबकि पिछले unlocks when=past से आते हैं। लंबा इतिहास खुद बनाएँ, हर poll पर records को tx_hash या id से सहेजकर।
DEX swaps के लिए pending और final स्थितियों का क्या मतलब है?
यह facts फ़ील्ड है, record की जाँच की स्थिति। pending का मतलब है कि swap प्रकाशित है और उसके बाद की कीमत का इंतज़ार है; publish और 30s बीच के चरण हैं; final का मतलब है कि record जाँचा जा चुका है और 30 सेकंड तथा 5 मिनट बाद की कीमत पता है; unavailable का मतलब है कि तथ्य इकट्ठे नहीं हो सके। स्थिति final होने तक record गायब हो सकता है, इसलिए swaps को id से सहेजें या final=true माँगें।
क्या API से whales को मुफ़्त में ट्रैक कर सकता हूँ?
आप अपने node या सार्वजनिक endpoint से JSON-RPC पर कच्चा डेटा ले सकते हैं, लेकिन तब label, डॉलर राशि और thresholds आपको खुद बनाने होंगे। Genesis API में मुफ़्त प्लान नहीं है: on-chain सेक्शन Start प्लान से $50 प्रति माह पर शुरू होते हैं, DEX swaps और analytics Pro से $100 पर।