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 API | 30، 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 | سواپهای بزرگ DEX | Pro، Max |
/onchain/analytics | مجموعهای 24h یا 7d | Pro، 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$.