بيانات أونتشين في 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 أو 7d | Pro, 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_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 | فترات بخطوة ساعة لـ 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 بيانات أونتشين.
أسئلة وأجوبة
أي خطة أحتاج لبيانات أونتشين؟
أقسام /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 عملة واحدة.