Genesis Arbitrage

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

API بيانات أونتشين: تحويلات الحيتان وتدفقات المنصات وفتح أقفال التوكنات

باختصار

  • يعيد API بيانات أونتشين أحداث البلوكتشين مفككة جاهزة: أي توكن انتقل، ومن أي عنوان، وإلى أي عنوان، وبكم دولاراً. تأتي البيانات الخام من العُقد، وتحوّلها المفهرسات إلى جداول، وتبقى تسميات العناوين نسبةً قد تكون خاطئة.
  • يراقب المتداولون إيداعات المنصات وسحوباتها، والتحويلات الكبيرة، وتحركات محافظ الفرق، ومراكز DEX الدائمة، وفتح الأقفال، والمطالبات، والاختراقات، وعمليات التبديل الكبيرة على DEX. الإيداع في منصة لا ينتهي دائماً ببيع.
  • في Genesis API تتوفر أقسام أونتشين التسعة من خطة Start، بينما تحتاج عمليات تبديل DEX والتحليلات وملخص العملة إلى Pro أو Max. يحسب كودك النافذة الزمنية وإجماليات التدفقات، لأن الأقسام بلا معامل للوقت.

API بيانات أونتشين هو واجهة HTTP لأحداث البلوكتشين التي جُمعت وحُوّلت إلى دولارات ووُضعت عليها تسميات: أي توكن انتقل، ومن أي عنوان، وإلى أي عنوان، وفي أي معاملة. بهذا الـ API يمكنك تتبع تحويلات الحيتان وإيداعات المنصات وفتح أقفال التوكنات وعمليات التبديل الكبيرة على DEX دون تشغيل عقدة أو مفهرس خاص بك. الحوت هنا عنوان يملك من العملة ما يكفي لتحريك السوق بتحويلاته.

من أين تأتي بيانات أونتشين

تمر البيانات بثلاث طبقات: عقدة تخزّن الكتل، ومفهرس يحوّلها إلى صفوف أحداث، وقاعدة تسميات تمنح العناوين أسماءها.

العقدة: الكتل والسجلات

تخزّن عقدة البلوكتشين الكتل وتخدمها عبر JSON-RPC. في إيثريوم والسلاسل المتوافقة معها، يُكتب تحويل توكن ERC-20 في سجل المعاملة على شكل الحدث Transfer(address indexed _from, address indexed _to, uint256 _value)، ويوصي المعيار بإصدار الحدث نفسه مع 0x0 مرسِلاً عند سك توكنات جديدة (EIP-20).

تعيد الدالة eth_getLogs السجلات المطابقة لمرشح: نطاق كتل fromBlock وtoBlock، وعنوان عقد address، وموضوعات الحدث topics (Ethereum JSON-RPC). يحتوي السجل على العناوين ورقم الكتلة وهاش المعاملة والمبلغ بأصغر وحدات التوكن. ولا يوجد في الكتلة سعر بالدولار ولا اسم مالك ولا علامة منصة.

المفهرس: من السجلات إلى الجداول

يقرأ المفهرس الكتل بالترتيب، ويفك ترميز الأحداث، ويوزعها على جداول: تحويلات وتبديلات وتغيّرات في المجمعات. يقسم المبلغ على 10 مرفوعة إلى أس decimals للتوكن (مع ثمانية منازل عشرية يعني ذلك القسمة على 100,000,000) ثم يضربه في السعر وقت الكتلة، فينتج المبلغ بالدولار.

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

تسميات العناوين: من يقف خلف العنوان

التسمية اسم يُلحق بعنوان: «Binance» أو «خزينة المشروع» أو «صانع سوق». تُمنح استناداً إلى قرائن: العنوان يحوّل العملات إلى محفظة منصة معروفة، أو نشر المشروع عناوينه بنفسه، أو استلم العنوان توكنات من عقد استحقاق. لا يؤكد المالك شيئاً من هذا، ولذلك قد تكون التسمية قديمة أو خاطئة ببساطة.

العنوان الذي لا توجد عنه قرائن يبقى بلا اسم: في أمثلة توثيق Genesis API يظهر مرسِل كهذا بعنوان مختصر 0xec01…d1a5.

أي أحداث أونتشين تهم المتداولين

مثال افتراضي: خلال صباح واحد ذهب 2,000,000$ من عملة مشروع ما إلى المنصات، وخرج 500,000$ من محفظة فريقه إلى عنوان صانع سوق. كل حدث وحده يقول القليل؛ أما معاً فهما سبب لفحص السعر والفائدة المفتوحة وجدول فتح الأقفال.

الحدثما تراهكيف يُقرأ عادةً
إيداع في منصةوصول عملات إلى عنوان منصةبيع محتمل أو ضمان أو إعادة ترتيب
سحب من منصةخروج عملات إلى عنوان خارجيتخزين أو DeFi أو منصة أخرى
تحويل كبيرتحويل فوق العتبة بين عنوانينحوت ينقل مركزه
محفظة الفريقتحركات من عناوين المؤسسة أو الخزينة أو المؤسسينالإيداع في منصة أثقل من التحرك الداخلي
مركز على DEX دائمشراء أو بيع: الحجم والسعر والمنصةرهان حوت وخطر التصفية
فتح أقفالتاريخ الإفراج وحصته وقيمتهعرض جديد من العملة
مطالبةتوكنات من إيردروب أو استحقاق أو مكافآتيستطيع المستلمون البيع فوراً
سك وجسرإصدار توكنات، وانتقال بين السلاسلسك العملات المستقرة يعني دخول أموال
اختراقالبروتوكول والخسائر وأسلوب الهجومخطر على التوكن والسلاسل المرتبطة
تبديل على DEXالجانب والمبلغ وحصة المجمع وحركة السعرتحرك السعر قبل أن تتفاعل المنصات

مراكز البورصات اللامركزية للعقود الدائمة، أي perp DEX، مرئية لأن هذه المنصات تُبقي بياناتها مفتوحة. على Hyperliquid تعيد نقطة النهاية info بالطلب POST https://api.hyperliquid.xyz/info مع طلب clearinghouseState المراكز المفتوحة والهامش لأي عنوان، دون مفتاح (وثائق Hyperliquid). أما منصات CEX فلا تنشر مراكز المتداولين الآخرين؛ بل تعطي أرقاماً مجمّعة مثل الفائدة المفتوحة.

فتح الأقفال هو الإفراج عن توكنات الفريق أو المستثمرين أو المؤسسة وفق جدول استحقاق يوزعها على دفعات بموعد محدد. التاريخ معروف مسبقاً، ولذلك قد يُسعّر السوق البيع قبل الحدث.

يحرّك تبديل DEX سعر المجمع في الكتلة نفسها. مثال افتراضي: شراء بـ 150,000$ في مجمع سيولته 1,200,000$ (السيولة) يستهلك 150,000 / 1,200,000 × 100 = 12.5% من المجمع. يتحرك سعر المجمع بوضوح، بينما يظهر الأثر في المنصات لاحقاً أو لا يظهر. تُقارن أسعار DEX وCEX في مقال API الـ DEX.

يظهر الاختراق في أونتشين على شكل تحويلات خارجة من عقد البروتوكول. الجسور أكثر عرضة للهجوم من غيرها من البروتوكولات لأن عقودها تحتفظ بمبالغ كبيرة: الحالات البارزة في مقال جسور البلوكتشين، وسرقة منصة في تحليل اختراق Bybit.

التأخير والتأكيد

بين المعاملة والصف الذي يصل إلى كودك تمر ثوانٍ إلى دقائق؛ هذا هو زمن التأخير في البيانات. لا يهم كثيراً في نظرة يومية على التدفقات، لكنه يحسم النتيجة عندما تتفاعل مع إيداع كبير واحد أو تبديل واحد.

تأكيد الشبكة

في إيثريوم قد تظهر كتلة جديدة مرة كل فترة slot، أي كل 12 ثانية، وتصبح نهائية بعد نحو 15 دقيقة (ethereum.org). لا يمكن تغيير الكتلة النهائية إلا بخسارة كمية ضخمة من ETH. يستطيع المفهرس الذي يحتاج الصورة المستقرة فقط قراءة الكتل حتى الوسم finalized، وهو الاسم الذي تعطيه العقدة لآخر كتلة نهائية.

تضيف المنصة الإيداع إلى الرصيد عندما تبلغ المعاملة حداً أدنى من تأكيدات الشبكة، وهذا الحد عند Binance مثلاً يختلف لكل عملة (الأسئلة الشائعة في Binance). لذلك يظهر الإيداع في المنصة في أونتشين قبل أن يتمكن المالك من بيع تلك العملات.

تأخير البيانات

في مثال التبديل من توثيق Genesis API، ts = 1794675511 هو وقت التبديل وpublished_at = 1794675523 هو وقت النشر: بينهما 1794675523 − 1794675511 = 12 ثانية. يُضاف إلى ذلك حداثة البيانات في خطتك ضمن meta.freshness_sec (30 ثانية في Start و10 في Pro و5 في Max) وفاصل الاستطلاع لديك.

المرحلةالمدةماذا تعني
كتلة إيثريومslot مدته 12 ثالمعاملة ظاهرة لكنها غير نهائية
نهائية إيثريومنحو 15 دقيقةالكتلة لن تتغير بعد الآن
إضافة المنصة للرصيدالحد الأدنى للتأكيدات لدى المنصةيختلف لكل عملة
نشر التبديل12 ث في المثالالسجل لم يصبح final بعد
حالة finalبعد 5 دقائق من التبديل على الأقليُعرف السعر بعد 30 ث وبعد 5 دقائق
تسليم Genesis API30 أو 10 أو 5 ثخطط Start وPro وMax

للتبديلات، خلاصة period=live مع السجلات غير المتحقق منها أسرع، لكن السجل قد يختفي إذا تبيّن أن التبديل إعادة توزيع للسيولة. المعامل final=true يُبقي التبديلات المتحقق منها فقط، وتصل بعد 5 دقائق على الأقل.

بيانات أونتشين في Genesis API

يعيد Genesis API خلاصات قسم Genesis OnChain: صفوف التحويلات تحمل مسبقاً تسميات المرسِل والمستلم، والمبلغ بالدولار وبالتوكن، وهاش المعاملة ورابط المستكشف. الطلبات HTTP GET بالمفتاح في الترويسة X-API-Key، والاستجابة JSON فيها حقل data وكتلة meta.

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

سُمّيت الأقسام باسم الخلاصات: large-transfers وcex-flows وmint-bridge وteam-wallets وperp-positions وunlocks وclaims وhacks وcoin-traffic، وهذا الأخير يحتوي سلاسل تحويلات عملة واحدة إلى وجهة واحدة. المرشحات هي min_usd وcoin، إضافة إلى when بقيمة upcoming أو past لفتح الأقفال. لا يوجد معامل للوقت، فتُحسب النافذة من الحقل ts.

طلب فتح أقفال توكنات قادمة بقيمة تفوق 1,000,000$:

curl -G "https://api.genesisarbitrage.com/v1/onchain/unlocks" \
  -d when=upcoming -d min_usd=1000000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

يحتوي صف فتح الأقفال على unlock_percent وunlock_value_usd (الحصة والقيمة) وhours_left (الساعات حتى الحدث) وallocations (التوزيع حسب المستلمين).

تضيف Pro وMax ثلاث نقاط نهاية. تعيد /onchain/dex-swaps التبديلات الكبيرة مع حصة السيولة في المجمع والتأثير التقديري على السعر وحركة السعر بعد 30 ثانية و5 دقائق (نظرة عامة على DEX في التوثيق). وتحسب /onchain/analytics الإجماليات لمدة 24h أو 7d: kpi.cex_in وkpi.cex_out وkpi.cex_net والتدفقات لكل منصة (تحليلات OnChain). وتجمع /onchain/coin/{symbol} أحداث العملة وتبديلاتها وفتح أقفالها خلال 7 أيام مع سعرها في CEX وOI والتمويل (عملة OnChain).

الاستجابة 200 وحدها تستهلك الحصة، وفي Trial تعيد نقاط نهاية أونتشين الخطأ 403 plan_restricted. تكلّف Start مبلغ 50$ شهرياً مقابل 2M طلب، وPro مبلغ 100$ مقابل 5M، وMax مبلغ 200$ مقابل 10M (أسعار Genesis API). كل معامل وحقل مع أمثلة الاستجابات في دليل نقاط نهاية أونتشين.

بلا كود، الخلاصات نفسها في لوحة Genesis OnChain، والتبديلات في نظرة عامة على DEX، والإجماليات اليومية والأسبوعية في تحليلات OnChain.

Python: إيداعات عملة في المنصات خلال نافذة زمنية

مثال افتراضي: خلال 6 ساعات وصلت خمسة تحويلات ARB إلى المنصات، بقيمة 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$. وما إن يصبح أول تحويل أقدم من 6 ساعات حتى يخرج من النافذة: 2,050,000 − 640,000 = 1,410,000، فينزل المجموع تحت العتبة مجدداً.

لا يوجد في cex-flows حقل direction، فيُستخرج الاتجاه من التسميات: منصة في to_name تعني إيداعاً، ومنصة في from_name تعني سحباً. الاستجابة هي الخلاصة الحالية للقسم، لذلك يحتفظ السكربت بالإيداعات حسب tx_hash ويُسقط القديمة بنفسه. بهذا لا يُحتسب مجموع النافذة مرتين عبر عمليات الاستطلاع.

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):  # حد المعدل أو إعادة البناء
        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 على أجزاء من التسميات؛ أضف المنصات التي تُتداول فيها العملة. السكربت يعدّ ويطبع فقط: Genesis API لا يضع أوامر، وقرار التداول يبقى لك.

تأتي استجابة الطلب مع coin وmin_usd بلا ETag، فيستهلك كل استطلاع طلباً. في Start تبلغ الفترة 30 ثانية، أي 2,592,000 / 30 = 86,400 طلب خلال 30 يوماً، أو 4.32% من حصة 2M. وإذا كانت لديك نحو اثنتي عشرة عملة، فاجلب خلاصة /onchain/cex-flows بلا مرشحات وقسّمها بنفسك: المجموعة الكاملة تأتي مع ETag، والطلب المكرر مع If-None-Match على بيانات لم تتغير يعيد 304 دون استهلاك الحصة.

التحويلات الأقل من min_usd لن تُحتسب: سلاسل التحويلات الصغيرة لعملة واحدة إلى منصة واحدة تُجمَّع في coin-traffic بالحقول direction وtotal_usd وcount وwindow_hours.

كيف تقرأ إيداعاً في منصة

قد تكون 2,050,000$ من ARB نفسها التي وصلت إلى المنصات خلال 6 ساعات تحضيراً للبيع، أو ضماناً للعقود الآجلة، أو انتقالاً بين حسابات المالك نفسه. صف واحد في الخلاصة لن يخبرك أيّها.

السيناريوماذا ترى أيضاًكيف تتحقق
التحضير للبيعمبيعات على DEX وضعف في السعر/onchain/dex-swaps مع side=sell
ضمان للعقود الآجلةتنمو الفائدة المفتوحة، ويتغير التمويل/market/open-interest و/funding/rates
إعادة ترتيب داخليةسحب مطابق من المنصة نفسهاfrom_name في cex-flows والمستكشف
بيع الفريق أو الصندوقالمرسِل محفظة فريقteam-wallets وunlocks

عدة أحداث على عملة واحدة أثقل من حدث منفرد: إيداع في منصة، وتحويل من محفظة الفريق، وفتح أقفال قريب. يمكنك رؤيتها في استجابة /onchain/coin/{symbol} واحدة، حيث تقع الأحداث بجوار كتلة cex التي فيها oi_usd وfunding_8h. نقطتا النهاية /market/open-interest و/funding/rates من الجدول متاحتان من Trial.

بقية بيانات السوق وطريقة اختيار المصدر للمهمة في نظرة API العملات الرقمية العامة.

أسئلة وأجوبة

ما مدى دقة تسميات العناوين في بيانات أونتشين؟

تُمنح التسميات استناداً إلى قرائن ولا يؤكدها مالك العنوان، لذلك لا يمكن ضمان دقة كاملة. كلما ربطت تحويلات أكثر عنواناً بمحفظة معروفة زادت موثوقية الاستنتاج، وتبقى العناوين الجديدة بلا اسم في الغالب. تحقق من أي حدث كبير عبر رابط المستكشف.

هل لدى Genesis API تاريخ أونتشين؟

لا يوجد أرشيف عميق. أطول النوافذ 7 أيام: period=7d للتبديلات والتحليلات وملخص العملة لمدة 7 أيام، بينما يأتي فتح الأقفال السابق من when=past. ابنِ التاريخ الطويل بنفسك بحفظ السجلات في كل استطلاع حسب tx_hash أو id.

ماذا تعني حالتا pending وfinal لتبديلات DEX؟

هذا هو الحقل facts، حالة التحقق من السجل. pending تعني أن التبديل نُشر وما زال سعر ما بعده قيد الانتظار؛ وpublish و30s مرحلتان وسيطتان؛ وfinal تعني أن السجل تم التحقق منه وصار السعر بعد 30 ثانية وبعد 5 دقائق معروفاً؛ وunavailable تعني تعذر جمع الوقائع. إلى أن تصبح الحالة final قد يختفي السجل، فاحفظ التبديلات حسب id أو اطلب final=true.

هل يمكنني تتبع الحيتان بـ API مجاناً؟

يمكنك أخذ البيانات الخام من عقدتك أو من نقطة نهاية عامة عبر JSON-RPC، لكن التسميات والمبالغ بالدولار والعتبات تصبح عندئذٍ من بنائك. ليس لدى Genesis API خطة مجانية: أقسام أونتشين تبدأ بخطة Start بسعر 50$ شهرياً، وتبديلات DEX والتحليلات بخطة Pro بسعر 100$.