توثيق Genesis API

كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.

التوثيقنظرة عامة على DEX

نظرة عامة على DEX

TrialStartProMax

عمليات تبديل DEX الكبيرة، كما في «نظرة عامة على DEX»: live — آخر 15 دقيقة، إضافة إلى نوافذ 1h و6h و24h و7d. لكل عملية تبديل تقدير لتأثيرها على المجمع، وحركة السعر بعد 30 ث و5 د، وتسمية المتداول. تكتمل السجلات أثناء التحقق منها (facts: pending ← final) وقد تختفي إذا تبيّن أن التبديل إعادة توزيع للسيولة — طابِق بحسب id.

GEThttps://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live
جرّب الطلب
GET/v1/onchain/dex-swaps?period=live

يُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي جهة سوى الـ API.

الصق مفتاحك وأرسل طلباً — سنعرض استجابة مختصرة.

معاملات الطلب

كل المعاملات اختيارية: بدون مرشحات تعيد نقطة النهاية مجموعة البيانات كاملة.

المعاملالنوعالوصف
periodstringlive (15 دقيقة، الافتراضي) أو 1h أو 6h أو 24h أو 7d
chainstringتصفية حسب الشبكة
sidestringbuy أو sell
dexstringDEX؛ عدة قيم — مفصولة بفواصل
min_usdnumberأدنى مبلغ، USD
min_impactnumberأدنى تأثير مطلق على المجمع، %
finalbooleantrue — عمليات التبديل المتحقق منها فقط (facts = final)
tokenstringرمز التوكن
qstringبحث في التوكن والاسم والعناوين والمتداول وهاش المعاملة وDEX والشبكة

مثال طلب

bash
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

مثال استجابة

مثال على الاستجابة — عنصر بيانات واحد، مع اختصار القيم الطويلة:

json
{
  "id": "ethereum:0x5f3c…e1:0x6982…1933",
  "ts": 1794675511,
  "published_at": 1794675523,
  "token": "PEPE",
  "token_name": "Pepe",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain": "ethereum",
  "chain_name": "Ethereum",
  "side": "buy",
  "amount": 41250000000,
  "usd": 412500,
  "dex": "Uniswap",
  "pool_address": "0xa43f…",
  "pool_label": "PEPE/WETH 0.3%",
  "trader_address": "0x7b9e…",
  "trader_name": "Wintermute",
  "tier": "T3",
  "pool_liquidity_usd": 4120000,
  "size_pct_liquidity": 10.01,
  "impact_est_pct": 4.8,
  "price_usd": 0.00001,
  "move_after_5m_pct": 1.9,
  "facts": "final",
  "tx_hash": "0x5f3c…e1",
  "explorer_url": "https://etherscan.io/tx/0x5f3c…e1",
  "dexscreener_url": "https://dexscreener.com/ethereum/0xa43f…"
}

حقول الاستجابة

الحقلالنوعالوصف
idstringمعرّف ثابت: الشبكة والمعاملة والتوكن
ts / published_atintوقت التبديل ووقت النشر
token / token_name / token_addressstringالتوكن: الرمز والاسم وعنوان العقد
chain / chain_namestringالشبكة
side / amount / usdmixedالجانب buy أو sell والكمية والقيمة بـ USD
dex / dex_entity / pool_address / pool_label / routemixedDEX وكيانه والمجمع وتسمية المجمع والمسار
trader_address / trader_name / trader_type / trader_urlstring | nullالمتداول: العنوان والتسمية والنوع والرابط
tierstringالفئة حسب سيولة المجمع: من T1 (30 ألف–100 ألف $) إلى T4 (أكثر من 10 ملايين $)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullسيولة المجمع وحصة التبديل منها والتأثير المقدَّر على السعر، %
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber | nullالسعر وتغيّره قبل التبديل وبعده بـ 30 ث / 5 د
facts / legsstring / intحالة التحقق: pending أو publish أو 30s أو final أو unavailable؛ legs — عدد الساقين
tx_hash / explorer_url / arkham_url / dexscreener_urlstringهاش المعاملة وروابط المستكشف / Arkham