Genesis Arbitrage

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

داده آنچین در 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 OnChainStart, Pro, Max
/onchainهر 9 بخش در یک شیءStart, Pro, Max
/onchain/dex-swapsسواپ‌های بزرگ DEXPro, Max
/onchain/analyticsتحلیل OnChain برای 24h یا 7dPro, 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_usdnumberحداقل مبلغ رویداد، USD
coinstringردیف‌های یک کوین؛ hacks کوین ندارد، پس فهرست خالی برمی‌گردد
whenstringفقط برای unlocks: upcoming یا past
sectionstringبخش برای درخواست /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_addresscoin-trafficجهت deposit، withdrawal یا transfer و مقصد جریان
total_usd / count / window_hours, transfers[]coin-trafficمجموع سری، تعداد انتقال‌ها، پنجره به ساعت و بزرگ‌ترین انتقال‌ها
side / size / price / platformperp-positionsLong یا Short، حجم، قیمت، پلتفرم
unlock_percent / unlock_value_usd / hours_left / allocationsunlocksسهم و ارزش آنلاک، ساعت‌های باقی‌مانده، تخصیص‌ها
classification / technique / returned_fundshacksطبقه‌بندی، تکنیک حمله، وجوه بازگردانده‌شده

سواپ‌های DEX: /onchain/dex-swaps

پلن‌های Pro و Max. اندپوینت فید سواپ‌های بزرگ را مانند صفحه نمای کلی DEX برمی‌گرداند: هر سواپ نشان می‌دهد چه سهمی از نقدینگی استخر را گرفته، چه حرکت قیمتی از آن انتظار می‌رود و پس از 30 ثانیه و 5 دقیقه چه اتفاقی افتاده است. اسکیمای پاسخ در مستندات است.

پارامترنوعکاربرد
periodstringlive — 15 دقیقه اخیر، پیش‌فرض؛ 1h، 6h، 24h یا 7d
chainstringشبکه
sidestringbuy یا sell
dexstringDEX؛ برای چند مورد با کاما جدا کنید
min_usdnumberحداقل مبلغ سواپ، USD
min_impactnumberحداقل تأثیر مطلق روی استخر، %
finalbooleantrue — فقط سواپ‌های تأییدشده
tokenstringنماد توکن
qstringجست‌وجو در توکن، نام، آدرس‌ها، تریدر، هش، DEX و شبکه
فیلدنوعمعنی
idstringشناسه پایدار: شبکه، تراکنش، توکن
tierstringرده بر اساس نقدینگی استخر: از T1 ($30,000–100,000) تا T4 (بیش از $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber یا nullنقدینگی استخر، سهم سواپ از آن و تأثیر قیمتی تخمینی، %
price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber یا nullقیمت پس از 30 ثانیه و 5 دقیقه و حرکت قیمت در 5 دقیقه پس از سواپ
factsstringوضعیت بررسی: pending، publish، 30s، final یا unavailable
trader_name / trader_addressstring یا 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 برمی‌گرداند، با مجموع‌ها، بازه‌های ساعتی، جریان صرافی‌ها، آنلاک‌ها، هک‌ها، کوین‌های کانون توجه و فید رویدادها. همه فیلدها در مستندات هستند.

فیلدنوعمعنی
kpiobjectمجموع‌ها: events، usd، tokens، cex_in، cex_out، cex_net
hourlyobjectبازه‌هایی با گام 1 ساعت برای 24h و 6 ساعت برای 7d
exchange_flowsobjectبرای هر صرافی: in_usd، out_usd، net
tokensarrayتا 40 کوین کانون توجه با بزرگ‌ترین رویداد و زمینه CEX
eventsarrayفید رویدادهای دوره، تا 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 ثانیه یک‌بار بازسازی می‌شود. فیلدها در مستندات هستند.

فیلدنوعمعنی
cexobject یا nullقیمت، OI، فاندینگ 8 ساعته، بهترین اسپرد، شبکه‌ها، واریز و برداشت؛ null اگر کوین در CEXهای پشتیبانی‌شده نباشد
kpiobjectمجموع‌های 7 روزه: رویدادها، cex_in، cex_out، سواپ‌ها، dex_buy، dex_sell
by_sectionobjectتعداد رویدادها به تفکیک بخش، با کلیدهایی مانند large_tx و cex_deposits
events / swapsarrayرویدادها و سواپ‌ها، تا 2000؛ شمار کامل در events_total و swaps_total
unlocks.upcoming / unlocks.pastarrayآنلاک‌های پیش‌رو و گذشته
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…"
}
  1. کوین و آستانه را تعیین کنید

    coin و min_usd فقط انتقال‌های بزرگ یک کوین را در پاسخ نگه می‌دارند.

  2. واریز را از برداشت جدا کنید

    صرافی در to_name واریز است و در from_name برداشت. برچسب‌ها را با زیررشته و بدون حساسیت به حروف تطبیق دهید.

  3. پنجره و انتقال‌های جدید را بشمارید

    ردیف‌های یک ساعت اخیر را با ts جمع بزنید و فقط برای مقادیر جدید tx_hash اعلان بدهید.

  4. با تازگی پلن خود نظرسنجی کنید

    بین درخواست‌ها 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 یک کوین را انتخاب می‌کند.