Genesis Arbitrage

Genesis Arbitrage · · 11 मिनट में पढ़ें

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/analytics24h या 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-positionsperp DEX पर बड़ी पोज़िशनPerp. DEX Positions
unlocksटोकन अनलॉकUnlocks
claimsक्लेमClaims
coin-trafficएक कॉइन के एक टारगेट तक ट्रांसफ़र की सीरीज़Coin Traffic
hacksहैक और एक्सप्लॉइटHacks / Exploits

हर ब्लॉक क्या दिखाता है और किन सिग्नल पर नज़र रखनी है, यह Genesis OnChain डैशबोर्ड गाइड में है, पैरामीटर डॉक्यूमेंटेशन में। बिना section के /onchain पर रिक्वेस्ट data में एक ऑब्जेक्ट लौटाती है: key सेक्शन का नाम है, value उसकी पंक्तियाँ। तब फ़िल्टर सभी सेक्शन पर लागू होते हैं।

पैरामीटरटाइपक्या करता है
min_usdnumberइवेंट की न्यूनतम राशि, USD
coinstringएक कॉइन की पंक्तियाँ; hacks में कॉइन नहीं होता, इसलिए खाली सूची लौटती है
whenstringसिर्फ़ unlocks के लिए: upcoming या past
sectionstring/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_addresscoin-trafficदिशा deposit, withdrawal या transfer और फ़्लो का टारगेट
total_usd / count / window_hours, transfers[]coin-trafficसीरीज़ का कुल, ट्रांसफ़र की संख्या, घंटों में विंडो और सबसे बड़े ट्रांसफ़र
side / size / price / platformperp-positionsLong या Short, साइज़, कीमत, प्लेटफ़ॉर्म
unlock_percent / unlock_value_usd / hours_left / allocationsunlocksअनलॉक का हिस्सा और वैल्यू, बचे घंटे, आवंटन
classification / technique / returned_fundshacksवर्गीकरण, हमले की तकनीक, लौटाई गई रकम

DEX स्वैप: /onchain/dex-swaps

Pro और Max प्लान। यह endpoint बड़े स्वैप की फ़ीड लौटाता है, DEX ओवरव्यू स्क्रीन की तरह: हर स्वैप दिखाता है कि उसने पूल की लिक्विडिटी का कितना हिस्सा लिया, उससे कीमत में कितनी हलचल की उम्मीद है और 30 सेकंड व 5 मिनट बाद क्या हुआ। रिस्पॉन्स स्कीमा डॉक्यूमेंटेशन में है।

पैरामीटरटाइपक्या करता है
periodstringlive — पिछले 15 मिनट, डिफ़ॉल्ट; 1h, 6h, 24h या 7d
chainstringनेटवर्क
sidestringbuy या sell
dexstringDEX; कई के लिए कॉमा से अलग करें
min_usdnumberस्वैप की न्यूनतम राशि, USD
min_impactnumberपूल पर न्यूनतम निरपेक्ष इम्पैक्ट, %
finalbooleantrue — सिर्फ़ जाँचे हुए स्वैप
tokenstringटोकन का टिकर
qstringटोकन, नाम, एड्रेस, ट्रेडर, हैश, DEX और नेटवर्क में खोज
फ़ील्डटाइपमतलब
idstringस्थिर पहचानकर्ता: चेन, ट्रांज़ैक्शन, टोकन
tierstringपूल की लिक्विडिटी के अनुसार टियर: T1 ($30,000–100,000) से T4 ($10M से अधिक) तक
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber या nullपूल की लिक्विडिटी, उसमें स्वैप का हिस्सा और अनुमानित कीमत इम्पैक्ट, %
price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber या null30 सेकंड और 5 मिनट बाद की कीमत और स्वैप के 5 मिनट बाद तक कीमत की हलचल
factsstringजाँच की स्थिति: pending, publish, 30s, final या unavailable
trader_name / trader_addressstring या 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 के लिए लौटाती है, जिसमें कुल आँकड़े, घंटे-वार बकेट, एक्सचेंज फ़्लो, अनलॉक, हैक, फ़ोकस वाले कॉइन और इवेंट फ़ीड होते हैं। सभी फ़ील्ड डॉक्यूमेंटेशन में हैं।

फ़ील्डटाइपमतलब
kpiobjectकुल आँकड़े: events, usd, tokens, cex_in, cex_out, cex_net
hourlyobject24h के लिए 1 घंटे और 7d के लिए 6 घंटे के कदम वाले बकेट
exchange_flowsobjectहर एक्सचेंज के लिए: in_usd, out_usd, net
tokensarrayसबसे बड़े इवेंट और CEX संदर्भ के साथ फ़ोकस वाले 40 तक कॉइन
eventsarrayअवधि की इवेंट फ़ीड, 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 सेकंड में एक बार दोबारा बनता है। फ़ील्ड डॉक्यूमेंटेशन में हैं।

फ़ील्डटाइपमतलब
cexobject या nullकीमत, OI, 8 घंटे का funding, सबसे अच्छा स्प्रेड, नेटवर्क, जमा और निकासी; null अगर कॉइन समर्थित CEX पर नहीं है
kpiobject7 दिन के कुल आँकड़े: इवेंट, cex_in, cex_out, स्वैप, dex_buy, dex_sell
by_sectionobjectसेक्शन के अनुसार इवेंट की गिनती, large_tx और cex_deposits जैसी key के साथ
events / swapsarrayइवेंट और स्वैप, 2000 तक; पूरी गिनती events_total और swaps_total में
unlocks.upcoming / unlocks.pastarrayआने वाले और पिछले अनलॉक
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…"
}
  1. कॉइन और थ्रेशोल्ड तय करें

    coin और min_usd रिस्पॉन्स में एक कॉइन के बड़े ट्रांसफ़र ही रखते हैं।

  2. जमा और निकासी अलग करें

    to_name में एक्सचेंज जमा है, from_name में निकासी। लेबल को सबस्ट्रिंग से, अक्षरों का केस अनदेखा करके मिलाएँ।

  3. विंडो और नए ट्रांसफ़र गिनें

    पिछले घंटे की पंक्तियाँ ts से जोड़ें, और नोटिफ़िकेशन सिर्फ़ नए tx_hash मानों पर दें।

  4. अपने प्लान की ताज़गी पर पोल करें

    रिक्वेस्ट के बीच 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 एक कॉइन चुनता है।