داده آنچین در Genesis API: انتقالها، جریانها، آنلاکها و سواپهای DEX
به طور خلاصه
- اندپوینت /onchain/{section} هر یک از 9 فید Genesis OnChain را از انتقالهای بزرگ تا هکها در پلنهای Start، Pro و Max برمیگرداند. درخواست به /onchain بدون بخش، همه فیدها را در یک شیء برمیگرداند.
- سواپهای بزرگ DEX، تحلیل 24 ساعته یا 7 روزه و خلاصه 7 روزه کوین در پلنهای Pro و Max در دسترس است.
- برچسب آدرسها نسبتدهی است، نه تضمین. انتقال به صرافی همیشه به معنی فروش نیست و رکورد سواپ ممکن است پس از بررسی حذف شود.
اندپوینتهای آنچین Genesis API دادههای بخش Genesis OnChain را برمیگردانند: انتقالهای بزرگ توکن، واریز و برداشت صرافیها، حرکت کیفپول تیمها، پوزیشنهای DEX پرپچوال، آنلاک توکنها، کلیمها و هکها، و نیز سواپهای بزرگ در DEX. هر ردیف از قبل برچسب فرستنده و گیرنده، مبلغ به دلار و لینکهای اکسپلورر را دارد. این برای پایش نهنگها و جریان صرافیها از کد خودتان کافی است، بدون ایندکسر بلاکچین شخصی.
اندپوینتها و پلنها
| اندپوینت | چه چیزی برمیگرداند | پلنهای API |
|---|---|---|
/onchain/{section} | یکی از 9 بخش Genesis OnChain | Start, Pro, Max |
/onchain | هر 9 بخش در یک شیء | Start, Pro, Max |
/onchain/dex-swaps | سواپهای بزرگ DEX | Pro, Max |
/onchain/analytics | تحلیل OnChain برای 24h یا 7d | Pro, Max |
/onchain/coin/{symbol} | خلاصه 7 روزه یک کوین | Pro, Max |
در Trial همه اندپوینتهای آنچین 403 plan_restricted برمیگردانند. تازگی داده 30 ثانیه در Start، 10 ثانیه در Pro و 5 ثانیه در Max است و همان مقدار در meta.freshness_sec میآید. کلید و اولین درخواست در شروع سریع و سهمیهها در محدودیتهای Genesis API توضیح داده شدهاند.
9 بخش /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_usd | number | حداقل مبلغ رویداد، USD |
coin | string | ردیفهای یک کوین؛ hacks کوین ندارد، پس فهرست خالی برمیگردد |
when | string | فقط برای unlocks: upcoming یا past |
section | string | بخش برای درخواست /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_address | coin-traffic | جهت deposit، withdrawal یا transfer و مقصد جریان |
total_usd / count / window_hours, transfers[] | coin-traffic | مجموع سری، تعداد انتقالها، پنجره به ساعت و بزرگترین انتقالها |
side / size / price / platform | perp-positions | Long یا Short، حجم، قیمت، پلتفرم |
unlock_percent / unlock_value_usd / hours_left / allocations | unlocks | سهم و ارزش آنلاک، ساعتهای باقیمانده، تخصیصها |
classification / technique / returned_funds | hacks | طبقهبندی، تکنیک حمله، وجوه بازگرداندهشده |
سواپهای DEX: /onchain/dex-swaps
پلنهای Pro و Max. اندپوینت فید سواپهای بزرگ را مانند صفحه نمای کلی DEX برمیگرداند: هر سواپ نشان میدهد چه سهمی از نقدینگی استخر را گرفته، چه حرکت قیمتی از آن انتظار میرود و پس از 30 ثانیه و 5 دقیقه چه اتفاقی افتاده است. اسکیمای پاسخ در مستندات است.
| پارامتر | نوع | کاربرد |
|---|---|---|
period | string | live — 15 دقیقه اخیر، پیشفرض؛ 1h، 6h، 24h یا 7d |
chain | string | شبکه |
side | string | buy یا sell |
dex | string | DEX؛ برای چند مورد با کاما جدا کنید |
min_usd | number | حداقل مبلغ سواپ، USD |
min_impact | number | حداقل تأثیر مطلق روی استخر، % |
final | boolean | true — فقط سواپهای تأییدشده |
token | string | نماد توکن |
q | string | جستوجو در توکن، نام، آدرسها، تریدر، هش، DEX و شبکه |
| فیلد | نوع | معنی |
|---|---|---|
id | string | شناسه پایدار: شبکه، تراکنش، توکن |
tier | string | رده بر اساس نقدینگی استخر: از T1 ($30,000–100,000) تا T4 (بیش از $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number یا null | نقدینگی استخر، سهم سواپ از آن و تأثیر قیمتی تخمینی، % |
price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number یا null | قیمت پس از 30 ثانیه و 5 دقیقه و حرکت قیمت در 5 دقیقه پس از سواپ |
facts | string | وضعیت بررسی: pending، publish، 30s، final یا unavailable |
trader_name / trader_address | string یا 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 برمیگرداند، با مجموعها، بازههای ساعتی، جریان صرافیها، آنلاکها، هکها، کوینهای کانون توجه و فید رویدادها. همه فیلدها در مستندات هستند.
| فیلد | نوع | معنی |
|---|---|---|
kpi | object | مجموعها: events، usd، tokens، cex_in، cex_out، cex_net |
hourly | object | بازههایی با گام 1 ساعت برای 24h و 6 ساعت برای 7d |
exchange_flows | object | برای هر صرافی: in_usd، out_usd، net |
tokens | array | تا 40 کوین کانون توجه با بزرگترین رویداد و زمینه CEX |
events | array | فید رویدادهای دوره، تا 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 ثانیه یکبار بازسازی میشود. فیلدها در مستندات هستند.
| فیلد | نوع | معنی |
|---|---|---|
cex | object یا null | قیمت، OI، فاندینگ 8 ساعته، بهترین اسپرد، شبکهها، واریز و برداشت؛ null اگر کوین در CEXهای پشتیبانیشده نباشد |
kpi | object | مجموعهای 7 روزه: رویدادها، cex_in، cex_out، سواپها، dex_buy، dex_sell |
by_section | object | تعداد رویدادها به تفکیک بخش، با کلیدهایی مانند large_tx و cex_deposits |
events / swaps | array | رویدادها و سواپها، تا 2000؛ شمار کامل در events_total و swaps_total |
unlocks.upcoming / unlocks.past | array | آنلاکهای پیشرو و گذشته |
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…"
}
کوین و آستانه را تعیین کنید
coinوmin_usdفقط انتقالهای بزرگ یک کوین را در پاسخ نگه میدارند.واریز را از برداشت جدا کنید
صرافی در
to_nameواریز است و درfrom_nameبرداشت. برچسبها را با زیررشته و بدون حساسیت به حروف تطبیق دهید.پنجره و انتقالهای جدید را بشمارید
ردیفهای یک ساعت اخیر را با
tsجمع بزنید و فقط برای مقادیر جدیدtx_hashاعلان بدهید.با تازگی پلن خود نظرسنجی کنید
بین درخواستها
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 داده آنچین است.
پرسش و پاسخ
برای داده آنچین کدام پلن لازم است؟
9 بخش /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 یک کوین را انتخاب میکند.