Genesis API में on-chain डेटा: ट्रांसफ़र, फ़्लो, अनलॉक और DEX स्वैप
संक्षेप में
- /onchain/{section} endpoint Genesis OnChain की नौ फ़ीड में से कोई भी लौटाता है, बड़े ट्रांसफ़र से लेकर हैक तक, Start, Pro और Max प्लान पर। बिना section के /onchain पर रिक्वेस्ट सभी फ़ीड एक ऑब्जेक्ट में लौटाती है।
- बड़े DEX स्वैप, 24 घंटे या 7 दिन का एनालिटिक्स और कॉइन की 7 दिन की समरी Pro और Max प्लान पर उपलब्ध हैं।
- एड्रेस लेबल एट्रिब्यूशन हैं, पक्की जानकारी नहीं। एक्सचेंज पर ट्रांसफ़र का मतलब हमेशा बिक्री नहीं होता, और स्वैप का रिकॉर्ड जाँच के बाद हट सकता है।
Genesis API के on-chain endpoint Genesis OnChain सेक्शन का डेटा लौटाते हैं: टोकन के बड़े ट्रांसफ़र, एक्सचेंज में जमा और निकासी, टीम वॉलेट की हलचल, perp DEX की पोज़िशन, टोकन अनलॉक, क्लेम और हैक, साथ ही DEX पर बड़े स्वैप। हर पंक्ति में भेजने वाले और पाने वाले के लेबल, डॉलर में राशि और एक्सप्लोरर लिंक पहले से होते हैं। अपना ब्लॉकचेन इंडेक्सर बनाए बिना, अपने कोड से व्हेल और एक्सचेंज फ़्लो पर नज़र रखने के लिए यह काफ़ी है।
Endpoint और प्लान
| Endpoint | क्या लौटाता है | API प्लान |
|---|---|---|
/onchain/{section} | Genesis OnChain के नौ सेक्शन में से एक | Start, Pro, Max |
/onchain | सभी नौ सेक्शन एक ऑब्जेक्ट में | Start, Pro, Max |
/onchain/dex-swaps | बड़े DEX स्वैप | Pro, Max |
/onchain/analytics | 24h या 7d का OnChain एनालिटिक्स | Pro, Max |
/onchain/coin/{symbol} | एक कॉइन की 7 दिन की समरी | Pro, Max |
Trial पर हर on-chain endpoint 403 plan_restricted लौटाता है। ताज़गी Start पर 30 सेकंड, Pro पर 10 सेकंड और Max पर 5 सेकंड है, और यही मान meta.freshness_sec में आता है। API key और पहली रिक्वेस्ट क्विकस्टार्ट में हैं, कोटा Genesis API की लिमिट में।
/onchain/{section} के नौ सेक्शन
section | अंदर क्या है | डैशबोर्ड ब्लॉक |
|---|---|---|
large-transfers | टोकन के बड़े ट्रांसफ़र | Large Transfers |
cex-flows | एक्सचेंज में जमा और वहाँ से निकासी | CEX Deposits / Withdrawals |
mint-bridge | टोकन मिंट और ब्रिज ट्रांसफ़र | Mint / Bridge |
team-wallets | टीम वॉलेट की हलचल | Team Transfers |
perp-positions | perp DEX पर बड़ी पोज़िशन | Perp. DEX Positions |
unlocks | टोकन अनलॉक | Unlocks |
claims | क्लेम | Claims |
coin-traffic | एक कॉइन के एक टारगेट तक ट्रांसफ़र की सीरीज़ | Coin Traffic |
hacks | हैक और एक्सप्लॉइट | Hacks / Exploits |
हर ब्लॉक क्या दिखाता है और किन सिग्नल पर नज़र रखनी है, यह Genesis OnChain डैशबोर्ड गाइड में है, पैरामीटर डॉक्यूमेंटेशन में। बिना section के /onchain पर रिक्वेस्ट data में एक ऑब्जेक्ट लौटाती है: key सेक्शन का नाम है, value उसकी पंक्तियाँ। तब फ़िल्टर सभी सेक्शन पर लागू होते हैं।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
min_usd | number | इवेंट की न्यूनतम राशि, USD |
coin | string | एक कॉइन की पंक्तियाँ; hacks में कॉइन नहीं होता, इसलिए खाली सूची लौटती है |
when | string | सिर्फ़ unlocks के लिए: upcoming या past |
section | string | /onchain?section=… रिक्वेस्ट के लिए सेक्शन |
when का कोई भी दूसरा मान 400 bad_request लौटाता है। नीचे coin-traffic सेक्शन है, data ऐरे का एक आइटम:
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783802410,
"token": "LAB",
"direction": "deposit",
"target": "Gate-io",
"target_address": "0x8782163068c7cd74D2510768a61135C1e4Eb07b3",
"total_usd": 573796.98,
"count": 18,
"window_hours": 5.69,
"avg_usd": 31878,
"largest_usd": 59891.78,
"transfers": [
{
"ts": 1783788640,
"usd": 59891.78,
"from_name": "0xec01…d1a5",
"tx_hash": "0xbf44850a7dc16086c08cfb…",
"chain": "bsc",
…
}
]
}
सेक्शन के फ़ील्ड
large-transfers, cex-flows, mint-bridge, team-wallets और claims सेक्शन ट्रांसफ़र से बने हैं; बाकी के अपने फ़ील्ड हैं।
| फ़ील्ड | कहाँ | मतलब |
|---|---|---|
ts, links | सभी सेक्शन | इवेंट का समय unix सेकंड में और तैयार लिंक text + url |
token / token_name | ट्रांसफ़र, coin-traffic | टोकन का टिकर और पूरा नाम |
chain / chain_name, usd / amount | ट्रांसफ़र | नेटवर्क, राशि USD में और टोकन में |
from_* / to_* | ट्रांसफ़र | भेजने वाला और पाने वाला: लेबल, एड्रेस, एक्सप्लोरर लिंक |
tx_hash / explorer_url / arkham_url | ट्रांसफ़र | ट्रांज़ैक्शन हैश, एक्सप्लोरर और Arkham लिंक |
direction, target / target_address | coin-traffic | दिशा deposit, withdrawal या transfer और फ़्लो का टारगेट |
total_usd / count / window_hours, transfers[] | coin-traffic | सीरीज़ का कुल, ट्रांसफ़र की संख्या, घंटों में विंडो और सबसे बड़े ट्रांसफ़र |
side / size / price / platform | perp-positions | Long या Short, साइज़, कीमत, प्लेटफ़ॉर्म |
unlock_percent / unlock_value_usd / hours_left / allocations | unlocks | अनलॉक का हिस्सा और वैल्यू, बचे घंटे, आवंटन |
classification / technique / returned_funds | hacks | वर्गीकरण, हमले की तकनीक, लौटाई गई रकम |
DEX स्वैप: /onchain/dex-swaps
Pro और Max प्लान। यह endpoint बड़े स्वैप की फ़ीड लौटाता है, DEX ओवरव्यू स्क्रीन की तरह: हर स्वैप दिखाता है कि उसने पूल की लिक्विडिटी का कितना हिस्सा लिया, उससे कीमत में कितनी हलचल की उम्मीद है और 30 सेकंड व 5 मिनट बाद क्या हुआ। रिस्पॉन्स स्कीमा डॉक्यूमेंटेशन में है।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
period | string | live — पिछले 15 मिनट, डिफ़ॉल्ट; 1h, 6h, 24h या 7d |
chain | string | नेटवर्क |
side | string | buy या sell |
dex | string | DEX; कई के लिए कॉमा से अलग करें |
min_usd | number | स्वैप की न्यूनतम राशि, USD |
min_impact | number | पूल पर न्यूनतम निरपेक्ष इम्पैक्ट, % |
final | boolean | true — सिर्फ़ जाँचे हुए स्वैप |
token | string | टोकन का टिकर |
q | string | टोकन, नाम, एड्रेस, ट्रेडर, हैश, DEX और नेटवर्क में खोज |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
id | string | स्थिर पहचानकर्ता: चेन, ट्रांज़ैक्शन, टोकन |
tier | string | पूल की लिक्विडिटी के अनुसार टियर: T1 ($30,000–100,000) से T4 ($10M से अधिक) तक |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number या null | पूल की लिक्विडिटी, उसमें स्वैप का हिस्सा और अनुमानित कीमत इम्पैक्ट, % |
price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number या null | 30 सेकंड और 5 मिनट बाद की कीमत और स्वैप के 5 मिनट बाद तक कीमत की हलचल |
facts | string | जाँच की स्थिति: pending, publish, 30s, final या unavailable |
trader_name / trader_address | string या null | ट्रेडर का लेबल और एड्रेस |
नीचे के उदाहरण में, $4,120,000 की लिक्विडिटी वाले पूल में $412,500 के स्वैप ने 412,500 / 4,120,000 × 100 = 10.01% पूल लिया। अनुमानित इम्पैक्ट 4.8% है, और 5 मिनट बाद कीमत 1.9% हिल चुकी थी।
curl -G "https://api.genesisarbitrage.com/v1/onchain/dex-swaps" \
-d period=1h -d min_usd=100000 -d final=true \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "ethereum:0x5f3c…e1:0x6982…1933",
"ts": 1794675511,
"token": "PEPE",
"chain": "ethereum",
"side": "buy",
"usd": 412500,
"dex": "Uniswap",
"pool_label": "PEPE/WETH 0.3%",
"tier": "T3",
"pool_liquidity_usd": 4120000,
"size_pct_liquidity": 10.01,
"impact_est_pct": 4.8,
"move_after_5m_pct": 1.9,
"facts": "final",
"explorer_url": "https://etherscan.io/tx/0x5f3c…e1"
}
OnChain एनालिटिक्स: /onchain/analytics
यह भी Pro और Max पर। एक कॉल Genesis OnChain Analytics स्क्रीन period=24h (डिफ़ॉल्ट) या 7d के लिए लौटाती है, जिसमें कुल आँकड़े, घंटे-वार बकेट, एक्सचेंज फ़्लो, अनलॉक, हैक, फ़ोकस वाले कॉइन और इवेंट फ़ीड होते हैं। सभी फ़ील्ड डॉक्यूमेंटेशन में हैं।
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
kpi | object | कुल आँकड़े: events, usd, tokens, cex_in, cex_out, cex_net |
hourly | object | 24h के लिए 1 घंटे और 7d के लिए 6 घंटे के कदम वाले बकेट |
exchange_flows | object | हर एक्सचेंज के लिए: in_usd, out_usd, net |
tokens | array | सबसे बड़े इवेंट और CEX संदर्भ के साथ फ़ोकस वाले 40 तक कॉइन |
events | array | अवधि की इवेंट फ़ीड, 600 तक |
cex_net जमा घटा निकासी है: उदाहरण में 312,456,789 − 287,654,321 = 24,802,468, यानी एक्सचेंजों से निकले से $24.8M ज़्यादा उन पर आया।
curl -G "https://api.genesisarbitrage.com/v1/onchain/analytics" \
-d period=24h \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"period": "24h",
"kpi": {
"events": 1284,
"usd": 912345678,
"tokens": 211,
"cex_in": 312456789,
"cex_out": 287654321,
"cex_net": 24802468
},
"exchange_flows": {
"Binance": {
"in_usd": 98123456, "out_usd": 87654321, "net": 10469135
}
},
"tokens": [ … ],
"events": [ … ]
}
OnChain कॉइन: /onchain/coin/{symbol}
Pro और Max को एक कॉइन की 7 दिन की समरी भी मिलती है, कॉइन पेज की तरह: on-chain इवेंट, DEX स्वैप, अनलॉक और CEX संदर्भ। टिकर पाथ में जाता है, 1 से 32 अक्षर, और रिस्पॉन्स ज़्यादा से ज़्यादा हर 10 सेकंड में एक बार दोबारा बनता है। फ़ील्ड डॉक्यूमेंटेशन में हैं।
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
cex | object या null | कीमत, OI, 8 घंटे का funding, सबसे अच्छा स्प्रेड, नेटवर्क, जमा और निकासी; null अगर कॉइन समर्थित CEX पर नहीं है |
kpi | object | 7 दिन के कुल आँकड़े: इवेंट, cex_in, cex_out, स्वैप, dex_buy, dex_sell |
by_section | object | सेक्शन के अनुसार इवेंट की गिनती, large_tx और cex_deposits जैसी key के साथ |
events / swaps | array | इवेंट और स्वैप, 2000 तक; पूरी गिनती events_total और swaps_total में |
unlocks.upcoming / unlocks.past | array | आने वाले और पिछले अनलॉक |
curl "https://api.genesisarbitrage.com/v1/onchain/coin/PEPE" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"symbol": "PEPE",
"cex": {
"price": 0.00001,
"oi_usd": 412000000,
"funding_8h": 0.0081,
"best_spread": 0.42,
"deposit": true,
"withdraw": true,
"nets": ["ETH", "BSC"]
},
"kpi": {
"events": 38, "cex_in": 21000000,
"cex_out": 18500000, "swaps": 54
},
"events_total": 38,
"swaps_total": 54
}
काल्पनिक उदाहरण: cex-flows से कॉइन का एक्सचेंजों में जमा
लक्ष्य यह जानना है कि पिछले एक घंटे में एक कॉइन का कितना हिस्सा एक्सचेंजों पर गया, और हर बड़े जमा पर नोटिफ़िकेशन पाना। cex-flows में दिशा लेबल से पता चलती है: to_name में एक्सचेंज का मतलब जमा है, from_name में एक्सचेंज का मतलब निकासी।
एक घंटे में ARB के चार जमा दिखे: $412,000, $260,000, $180,000 और $148,000, कुल $412,000 + $260,000 + $180,000 + $148,000 = $1,000,000। एक निकासी $150,000 की थी। एक्सचेंजों पर नेट फ़्लो $1,000,000 − $150,000 = $850,000 है: आना जाने से ज़्यादा है। पहले जमा की काल्पनिक पंक्ति ऐसी दिखती है:
{
"ts": 1794675511,
"token": "ARB",
"chain": "arbitrum_one",
"usd": 412000,
"amount": 1030000,
"from_name": "0x7a2f…c31b",
"to_name": "Binance Deposit",
"tx_hash": "0x9c1e…",
"explorer_url": "https://arbiscan.io/tx/0x9c1e…"
}
कॉइन और थ्रेशोल्ड तय करें
coinऔरmin_usdरिस्पॉन्स में एक कॉइन के बड़े ट्रांसफ़र ही रखते हैं।जमा और निकासी अलग करें
to_nameमें एक्सचेंज जमा है,from_nameमें निकासी। लेबल को सबस्ट्रिंग से, अक्षरों का केस अनदेखा करके मिलाएँ।विंडो और नए ट्रांसफ़र गिनें
पिछले घंटे की पंक्तियाँ
tsसे जोड़ें, और नोटिफ़िकेशन सिर्फ़ नएtx_hashमानों पर दें।अपने प्लान की ताज़गी पर पोल करें
रिक्वेस्ट के बीच
meta.freshness_secरुकें;429और503परRetry-Afterसेकंड प्रतीक्षा करें।
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", 100_000
CEX = ("binance", "okx", "bybit", "coinbase") # लेबल के सबस्ट्रिंग
seen = set()
def is_cex(label):
return any(name in (label or "").lower() 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()
hour_ago = time.time() - 3600
inflow = outflow = 0.0
for row in body["data"]:
if (row.get("ts") or 0) < hour_ago:
continue
usd = row.get("usd") or 0
if is_cex(row.get("to_name")): # एक्सचेंज में जमा
inflow += usd
if row.get("tx_hash") not in seen:
seen.add(row.get("tx_hash"))
print(f"{COIN} → {row['to_name']}: ${usd:,.0f}")
elif is_cex(row.get("from_name")): # निकासी
outflow += usd
print(f"last hour: to exchanges ${inflow:,.0f}, "
f"net flow ${inflow - outflow:,.0f}")
time.sleep(body["meta"]["freshness_sec"])
स्क्रिप्ट सिर्फ़ डेटा पढ़ती है और नोटिफ़िकेशन छापती है; कॉइन के साथ क्या करना है, यह आपका फ़ैसला है। एक ही एक्सचेंज पर छोटे ट्रांसफ़र की सीरीज़ coin-traffic सेक्शन में समूहित हैं, जहाँ दिशा direction फ़ील्ड में पहले से है। सभी कॉइन का कुल /onchain/analytics से kpi.cex_in, kpi.cex_out और kpi.cex_net में मिलता है, और on-chain डेटा के उपयोगों का परिचय on-chain data API लेख में है।
सवाल और जवाब
on-chain डेटा के लिए कौन-सा प्लान चाहिए?
/onchain/{section} के नौ सेक्शन Start, Pro और Max पर खुले हैं। DEX स्वैप, एनालिटिक्स और कॉइन समरी सिर्फ़ Pro और Max पर हैं, और Trial पर on-chain endpoint 403 plan_restricted लौटाते हैं।
क्या 7 दिन से पुरानी हिस्ट्री है?
सबसे लंबी विंडो स्वैप और एनालिटिक्स के लिए period=7d और कॉइन समरी में 7 दिन हैं; Genesis API में अलग आर्काइव नहीं है। लंबी हिस्ट्री के लिए हर पोल पर रिकॉर्ड खुद सहेजें।
रिस्पॉन्स से स्वैप क्यों गायब हो गया?
जाँच में ट्रेड की जगह लिक्विडिटी की अदला-बदली मिली और रिकॉर्ड हटा दिया गया। सहेजे हुए स्वैप को id से मिलाएँ या सिर्फ़ final=true माँगें।
आने वाले टोकन अनलॉक कैसे पाएँ?
/onchain/unlocks?when=upcoming माँगें। हर पंक्ति में unlock_percent और unlock_value_usd हैं, यानी अनलॉक का हिस्सा और वैल्यू, और hours_left यानी उसमें बचे घंटे। min_usd वैल्यू की सीमा तय करता है, coin एक कॉइन चुनता है।