توثيق Genesis API
كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.
التوثيقنظرة عامة على DEX
نظرة عامة على DEX
TrialStartProMax
عمليات تبديل DEX الكبيرة، كما في «نظرة عامة على DEX»: live — آخر 15 دقيقة، إضافة إلى نوافذ 1h و6h و24h و7d. لكل عملية تبديل تقدير لتأثيرها على المجمع، وحركة السعر بعد 30 ث و5 د، وتسمية المتداول. تكتمل السجلات أثناء التحقق منها (facts: pending ← final) وقد تختفي إذا تبيّن أن التبديل إعادة توزيع للسيولة — طابِق بحسب id.
GET
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=liveجرّب الطلب
GET
/v1/onchain/dex-swaps?period=liveيُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي جهة سوى الـ API.
الصق مفتاحك وأرسل طلباً — سنعرض استجابة مختصرة.
معاملات الطلب
كل المعاملات اختيارية: بدون مرشحات تعيد نقطة النهاية مجموعة البيانات كاملة.
| المعامل | النوع | الوصف |
|---|---|---|
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 — عمليات التبديل المتحقق منها فقط (facts = final) |
token | string | رمز التوكن |
q | string | بحث في التوكن والاسم والعناوين والمتداول وهاش المعاملة و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…"
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
id | string | معرّف ثابت: الشبكة والمعاملة والتوكن |
ts / published_at | int | وقت التبديل ووقت النشر |
token / token_name / token_address | string | التوكن: الرمز والاسم وعنوان العقد |
chain / chain_name | string | الشبكة |
side / amount / usd | mixed | الجانب buy أو sell والكمية والقيمة بـ USD |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX وكيانه والمجمع وتسمية المجمع والمسار |
trader_address / trader_name / trader_type / trader_url | string | null | المتداول: العنوان والتسمية والنوع والرابط |
tier | string | الفئة حسب سيولة المجمع: من T1 (30 ألف–100 ألف $) إلى T4 (أكثر من 10 ملايين $) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | سيولة المجمع وحصة التبديل منها والتأثير المقدَّر على السعر، % |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | السعر وتغيّره قبل التبديل وبعده بـ 30 ث / 5 د |
facts / legs | string / int | حالة التحقق: pending أو publish أو 30s أو final أو unavailable؛ legs — عدد الساقين |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | هاش المعاملة وروابط المستكشف / Arkham |