مستندات Genesis API

هرچه برای یکپارچه‌سازی لازم است: احراز هویت، محدودیت‌ها، اندپوینت‌ها و اسکیمای پاسخ.

مستنداتنمای کلی DEX

نمای کلی DEX

TrialStartProMax

سوآپ‌های بزرگ DEX، مانند «نمای کلی DEX»: live — 15 دقیقه اخیر، به‌علاوه پنجره‌های 1h، 6h، 24h و 7d. هر سوآپ شامل برآورد تأثیر بر استخر، حرکت قیمت پس از 30s و 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"

نمونه پاسخ

نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شده‌اند:

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 ($30K–100K) تا T4 (بیش از $10M)
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