مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
مستنداتنمای کلی DEX
نمای کلی DEX
TrialStartProMax
سوآپهای بزرگ DEX، مانند «نمای کلی DEX»: live — 15 دقیقه اخیر، بهعلاوه پنجرههای 1h، 6h، 24h و 7d. هر سوآپ شامل برآورد تأثیر بر استخر، حرکت قیمت پس از 30s و 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"
نمونه پاسخ
نمونه پاسخ — یک عنصر 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…"
}فیلدهای پاسخ
| فیلد | نوع | توضیح |
|---|---|---|
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 ($30K–100K) تا T4 (بیش از $10M) |
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 |