Genesis Arbitrage

Genesis Arbitrage · · 11 دقائق قراءة

بيانات أونتشين في Genesis API: التحويلات والتدفقات وفتح الأقفال وعمليات DEX

باختصار

  • تُرجع نقطة النهاية /onchain/{section} أيًّا من خلاصات Genesis OnChain التسع، من التحويلات الكبيرة إلى الاختراقات، في خطط Start وPro وMax. الطلب إلى /onchain بدون قسم يُرجع كل الخلاصات في كائن واحد.
  • عمليات DEX الكبيرة وتحليلات 24 ساعة أو 7 أيام وملخص العملة لمدة 7 أيام متاحة في خطتي Pro وMax.
  • تسميات العناوين نسبٌ تقديري وليست ضمانًا. التحويل إلى منصة لا يعني دائمًا بيعًا، وقد يختفي سجل عملية DEX بعد التحقق.

تُرجع نقاط نهاية أونتشين في Genesis API بيانات قسم Genesis OnChain: تحويلات التوكنات الكبيرة، وإيداعات المنصات وسحوباتها، وحركة محافظ الفرق، ومراكز DEX الدائمة، وفتح أقفال التوكنات، والمطالبات، والاختراقات، إضافة إلى العمليات الكبيرة على DEX. كل صف يحمل تسميتي المرسل والمستقبل والمبلغ بالدولار وروابط المستكشف. وهذا يكفي لمتابعة الحيتان وتدفقات المنصات من كودك الخاص دون فهرس بلوكتشين خاص بك.

نقاط النهاية والخطط

نقطة النهايةما تُرجعهخطط API
/onchain/{section}أحد أقسام Genesis OnChain التسعةStart, Pro, Max
/onchainالأقسام التسعة في كائن واحدStart, Pro, Max
/onchain/dex-swapsعمليات DEX الكبيرةPro, Max
/onchain/analyticsتحليلات OnChain لـ 24h أو 7dPro, Max
/onchain/coin/{symbol}ملخص عملة واحدة لمدة 7 أيامPro, Max

في خطة Trial تُرجع كل نقاط نهاية أونتشين الخطأ 403 plan_restricted. الحداثة 30 ث في Start و10 ث في Pro و5 ث في Max، وتصل القيمة نفسها في meta.freshness_sec. المفتاح وأول طلب مشروحان في البداية السريعة، والحصص في حدود Genesis API.

الأقسام التسعة في /onchain/{section}

sectionالمحتوىكتلة اللوحة
large-transfersتحويلات التوكنات الكبيرةLarge Transfers
cex-flowsالإيداعات في المنصات والسحوبات منهاCEX Deposits / Withdrawals
mint-bridgeسك التوكنات وتحويلات الجسورMint / Bridge
team-walletsحركة محافظ الفرقTeam Transfers
perp-positionsالمراكز الكبيرة على DEX الدائمةPerp. DEX Positions
unlocksفتح أقفال التوكناتUnlocks
claimsالمطالباتClaims
coin-trafficسلاسل تحويلات عملة واحدة إلى هدف واحدCoin Traffic
hacksالاختراقات والاستغلالاتHacks / Exploits

ما تعرضه كل كتلة وأي إشارات تستحق المراقبة مشروح في دليل لوحة Genesis OnChain، والمعاملات في التوثيق. الطلب إلى /onchain بدون قسم يُرجع في data كائنًا: المفتاح اسم القسم والقيمة صفوفه. وتُطبَّق المرشحات حينها على كل الأقسام.

المعاملالنوعالوظيفة
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التحويلاتالشبكة والمبلغ بالدولار وبعدد التوكنات
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. تُرجع نقطة النهاية خلاصة العمليات الكبيرة، مثل شاشة نظرة عامة على DEX: تُظهر كل عملية أي حصة من سيولة المجمع استهلكت، وأي حركة سعرية يُتوقع أن تسببها، وما حدث بعد 30 ثانية وبعد 5 دقائق. مخطط الاستجابة في التوثيق.

المعاملالنوعالوظيفة
periodstringlive — آخر 15 دقيقة، وهو الافتراضي؛ أو 1h أو 6h أو 24h أو 7d
chainstringالشبكة
sidestringbuy أو sell
dexstringالـ DEX؛ بفواصل لعدة منصات
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 أو nullالسعر بعد 30 ث وبعد 5 د وحركة السعر خلال 5 دقائق بعد العملية
factsstringحالة التحقق: pending أو publish أو 30s أو final أو unavailable
trader_name / trader_addressstring أو nullتسمية المتداول وعنوانه

في المثال التالي، استهلكت عملية بقيمة $412,500 في مجمع سيولته $4,120,000 ما نسبته 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 لـ period=24h (الافتراضي) أو 7d، مع الإجماليات والفترات الساعية وتدفقات المنصات وفتح الأقفال والاختراقات والعملات قيد التركيز وخلاصة الأحداث. كل الحقول في التوثيق.

الحقلالنوعالمعنى
kpiobjectالإجماليات: events وusd وtokens وcex_in وcex_out وcex_net
hourlyobjectفترات بخطوة ساعة لـ 24h و6 ساعات لـ 7d
exchange_flowsobjectلكل منصة: in_usd وout_usd وnet
tokensarrayحتى 40 عملة قيد التركيز مع أكبر حدث وسياق CEX
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 أيام لعملة واحدة، مثل صفحة العملة: أحداث أونتشين وعمليات DEX وفتح الأقفال وسياق CEX. يوضع الرمز في المسار بطول 1 إلى 32 حرفًا، وتُعاد بناء الاستجابة مرة واحدة كل 10 ثوانٍ على الأكثر. الحقول في التوثيق.

الحقلالنوعالمعنى
cexobject أو nullالسعر وOI ومعدل التمويل لـ 8 ساعات وأفضل فرق والشبكات والإيداع والسحب؛ null إن لم تكن العملة على منصات CEX المدعومة
kpiobjectإجماليات 7 أيام: الأحداث وcex_in وcex_out والعمليات وdex_buy وdex_sell
by_sectionobjectعدد الأحداث حسب القسم، بمفاتيح مثل large_tx وcex_deposits
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):  # تجاوز الحد أو إعادة بناء
        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، وتجد نظرة عامة على استخدامات بيانات أونتشين في مقال API بيانات أونتشين.

أسئلة وأجوبة

أي خطة أحتاج لبيانات أونتشين؟

أقسام /onchain/{section} التسعة متاحة في Start وPro وMax. أما عمليات DEX والتحليلات وملخص العملة ففي Pro وMax فقط، وفي Trial تُرجع نقاط نهاية أونتشين 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 عملة واحدة.