مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
مستنداتمعاملات بزرگ
معاملات بزرگ
TrialStartProMax
نوار معاملات Polymarket: live — معاملات از $1000 و کیفپولهای هوشمند از $100، today و 7d — معاملات taker از $5000. ردیفها از جدید به قدیم مرتباند.
GET
https://api.genesisarbitrage.com/v1/predictions/trades?period=liveامتحان درخواست
GET
/v1/predictions/trades?period=liveکلید فقط در مرورگر شما ذخیره میشود و جز به API جایی فرستاده نمیشود.
کلید را بچسبانید و درخواست بزنید — پاسخ خلاصهشده را نشان میدهیم.
پارامترهای درخواست
همه پارامترها اختیاریاند: بدون فیلتر، اندپوینت کل مجموعه داده را برمیگرداند.
| پارامتر | نوع | توضیح |
|---|---|---|
period | string | live (پیشفرض)، today یا 7d |
wallet | string | آدرس کیفپول |
category | string | فیلتر بر اساس دسته |
side | string | buy یا sell |
min_usd | number | حداقل مبلغ، USD |
insider | boolean | true — فقط معاملات با برچسب insider |
نمونه درخواست
bash
curl "https://api.genesisarbitrage.com/v1/predictions/trades?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
نمونه پاسخ
نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شدهاند:
json
{
"id": "0x9f…:7134…:0x3a…",
"ts": 1794675812,
"wallet": "0x3a1c…f09e",
"name": "Domer",
"tags": ["whale", "smart"],
"market": "polymarket:0x6d2b…",
"title": "Will Bitcoin reach $150k in 2026?",
"outcome": "No",
"outcome_index": 1,
"category": "Crypto",
"side": "buy",
"price": 0.82,
"shares": 30487.8,
"usd": 25000,
"role": "taker",
"first_in_market": false,
"insider": false,
"url": "https://polymarket.com/event/…",
"bid_now": 0.81,
"ask_now": 0.83
}فیلدهای پاسخ
| فیلد | نوع | توضیح |
|---|---|---|
id / ts | string / number | شناسه و زمان معامله |
wallet / name / tags | mixed | کیفپول، نام و برچسبها (whale، smart و غیره) |
market / title / outcome / outcome_index / category | mixed | بازار، عنوان، نتیجه و اندیس آن، دسته |
side / price / shares / usd | mixed | سمت، قیمت، سهمها و مبلغ به USD |
role / first_in_market | string / boolean | taker — آغازگر معامله، maker؛ اینکه آیا نخستین معامله کیفپول در این بازار است |
insider | boolean | برچسب الگوی insider |
url | string | لینک رویداد در پلتفرم |
bid_now / ask_now | number | null | bid و ask فعلی نتیجه |