Genesis Arbitrage

Genesis Arbitrage · · 13 دقیقه مطالعه

API داده آنچین: انتقال نهنگ‌ها، جریان صرافی‌ها و آنلاک توکن‌ها

به طور خلاصه

  • API داده آنچین رویدادهای بلاکچین را رمزگشایی‌شده برمی‌گرداند: کدام توکن، از چه کسی، به چه کسی و به ارزش چند دلار جابه‌جا شده است. داده خام از نودها می‌آید، ایندکسرها آن را به جدول تبدیل می‌کنند و برچسب آدرس‌ها فقط یک انتساب است که می‌تواند اشتباه باشد.
  • معامله‌گران واریز و برداشت صرافی‌ها، انتقال‌های بزرگ، جابه‌جایی کیف‌پول‌های تیم، پوزیشن‌های perp 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»، «خزانه پروژه»، «بازارساز». بر پایه شواهد داده می‌شود: آدرس کوین‌ها را به کیف‌پول شناخته‌شده یک صرافی می‌فرستد، پروژه آدرس‌هایش را خودش منتشر کرده، یا آدرس از قرارداد vesting توکن گرفته است. مالک هیچ‌کدام را تأیید نمی‌کند، پس برچسب ممکن است کهنه یا ساده‌اش اشتباه باشد.

آدرسی که شواهدی ندارد بی‌نام می‌ماند: در مثال‌های مستندات Genesis API چنین فرستنده‌ای با آدرس کوتاه‌شده 0xec01…d1a5 نمایش داده می‌شود.

کدام رویدادهای آنچین برای معامله‌گران مهم‌اند

یک مثال فرضی: در یک صبح، 2,000,000$ از کوین یک پروژه به صرافی‌ها رفت و 500,000$ از کیف‌پول تیم آن به آدرس یک بازارساز خارج شد. هر رویداد به‌تنهایی چیز کمی می‌گوید؛ با هم دلیلی‌اند برای بررسی قیمت، اوپن اینترست و جدول آنلاک.

رویدادچه می‌بینیدمعمولاً چگونه خوانده می‌شود
واریز به صرافیکوین‌ها به آدرس صرافی می‌رسندفروش احتمالی، وثیقه یا جابه‌جایی
برداشت از صرافیکوین‌ها به آدرس بیرونی می‌روندنگهداری، DeFi یا صرافی دیگر
انتقال بزرگانتقال بالاتر از آستانه میان آدرس‌هانهنگ پوزیشنش را جابه‌جا می‌کند
کیف‌پول تیمجابه‌جایی از آدرس‌های بنیاد، خزانه یا بنیان‌گذارانواریز به صرافی از جابه‌جایی داخلی وزن بیشتری دارد
پوزیشن perp DEXلانگ یا شورت: حجم، قیمت، پلتفرمشرط‌بندی نهنگ و ریسک لیکوییدیشن
آنلاکتاریخ، سهم و ارزش آزادسازیعرضه جدید کوین
کلیمتوکن از ایردراپ، vesting، پاداشدریافت‌کنندگان می‌توانند بلافاصله بفروشند
مینت و بریجانتشار توکن، انتقال بین زنجیره‌هامینت استیبل‌کوین یعنی ورود پول
هکپروتکل، زیان، شیوه حملهریسک برای توکن و زنجیره‌های مرتبط
سواپ DEXجهت، مبلغ، سهم از استخر، جابه‌جایی قیمتتغییر قیمت پیش از واکنش صرافی‌ها

پوزیشن‌ها در صرافی‌های غیرمتمرکز قراردادهای دائمی، یعنی perp DEX، دیده می‌شوند چون این پلتفرم‌ها داده‌هایشان را باز نگه می‌دارند. در Hyperliquid نقطه info با POST https://api.hyperliquid.xyz/info و درخواست clearinghouseState پوزیشن‌های باز و مارجین هر آدرس را بدون کلید برمی‌گرداند (مستندات Hyperliquid). CEXها پوزیشن دیگر معامله‌گران را منتشر نمی‌کنند؛ فقط ارقام تجمعی مثل اوپن اینترست را می‌دهند.

آنلاک آزادسازی توکن‌های تیم، سرمایه‌گذاران یا بنیاد طبق جدول vesting است که آن‌ها را در مرحله‌های زمان‌بندی‌شده تحویل می‌دهد. تاریخ از قبل معلوم است، پس بازار ممکن است فروش را پیش از رویداد در قیمت جا بدهد.

سواپ DEX قیمت استخر را در همان بلوک تغییر می‌دهد. یک مثال فرضی: خرید 150,000$ در استخری با 1,200,000$ نقدینگی برابر 150,000 / 1,200,000 × 100 = 12.5% از استخر را برمی‌دارد. قیمت استخر به‌وضوح جابه‌جا می‌شود، اما در صرافی‌ها این حرکت دیرتر دیده می‌شود یا اصلاً دیده نمی‌شود. مقایسه قیمت DEX و CEX در مقاله API دکس آمده است.

هک در آنچین به شکل انتقال‌های خروجی از قرارداد پروتکل دیده می‌شود. بریج‌ها بیش از پروتکل‌های دیگر هدف حمله‌اند چون قراردادهایشان مبالغ بزرگ نگه می‌دارند: موارد شاخص در مقاله بریج‌های بلاکچین و سرقت از یک صرافی در بررسی هک 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 است.

Endpointچه برمی‌گرداندپلن‌ها
/onchain/{section}یکی از 9 بخش آنچینStart، Pro، Max
/onchainهر 9 بخش در یک شیءStart، Pro، Max
/onchain/dex-swapsسواپ‌های بزرگ DEXPro، 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 سه endpoint اضافه می‌کنند. /onchain/dex-swaps سواپ‌های بزرگ را با سهم از نقدینگی استخر، اثر قیمتی تخمینی و جابه‌جایی قیمت بعد از 30 ثانیه و 5 دقیقه برمی‌گرداند (نمای کلی DEX در مستندات). /onchain/analytics مجموع‌ها را برای 24h یا 7d حساب می‌کند: kpi.cex_in، kpi.cex_out، kpi.cex_net و جریان‌ها به تفکیک صرافی (تحلیل آنچین). /onchain/coin/{symbol} رویدادها، سواپ‌ها و آنلاک‌های یک کوین را در 7 روز همراه با قیمت CEX، OI و فاندینگ آن جمع می‌کند (کوین در آنچین).

فقط پاسخ 200 از سهمیه کم می‌کند و در Trial endpointهای آنچین خطای 403 plan_restricted برمی‌گردانند. Start ماهانه 50$ برای 2M درخواست است، Pro 100$ برای 5M و Max 200$ برای 10M (قیمت‌های Genesis API). همه پارامترها و فیلدها با نمونه پاسخ در راهنمای endpointهای آنچین آمده است.

بدون کد، همین فیدها در داشبورد Genesis OnChain هستند، سواپ‌ها در نمای کلی DEX و مجموع‌های روزانه و هفتگی در تحلیل آنچین.

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):  # 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 زیررشته‌های برچسب را نگه می‌دارد؛ صرافی‌هایی را که کوین در آن‌ها معامله می‌شود اضافه کنید. اسکریپت فقط می‌شمارد و چاپ می‌کند: 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 قرار دارند. endpointهای /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$.