Polymarket
Prediction-market discovery and market data.
الحصول على نشاط محفظة Polymarket
استرجع نشاط سوق التوقّعات. رشّح السوق باستخدام قيم condition-ID، واستخدم start وend للنافذة الزمنية، وlimit وoffset لترقيم الصفحات. تشمل المحدّدات الإضافية eventId وtype وside وsortBy وsortDirection. الاستجابة الناجحة مصفوفة عليا من سجلات النشاط.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: integerendالحد الأدنى:0
طابع زمني للحد الأعلى (بالثواني) لنافذة النشاط. احذفه لاستخدام الافتراضي (الوقت الحالي)؛ تُستبعد الصفوف الأحدث من
end. - النوع: array integer[]event
Id الحد الأدنى:1قائمة معرّفات أحداث مفصولة بفواصل. حصرية مع market.
- النوع: booleanexclude
Deposits Withdrawals يستبعد سجلات الإيداع والسحب. القيمة الافتراضية
trueتُطبَّق حتى عندما يطلبtypeتلك السجلات، لذا للحصول على الإيداعات والسحوبات يجب تمريرfalse. - النوع: integerlimitالحد الأدنى:0الحد الأقصى:500
حجم الصفحة. تُقيَّد القيم التي تتجاوز الحد الأقصى عند 500.
- النوع: array string[]market
قائمة معرّفات شروط مفصولة بفواصل. حصرية مع eventId.
- النوع: integeroffsetالحد الأدنى:0الحد الأقصى:5000
فهرس البدء لترقيم الصفحات. تُرفض الطلبات التي تتجاوز الحد بالخطأ 400 (ولا تُقيَّد بصمت أبدًا). لقراءة سجل أعمق من offset 5000، انتقل بين الصفحات داخل نوافذ
start/end— لكل نافذة ميزانية offset خاصة بها. - النوع: string تعدادsideالقيم
- B
U Y - S
E L L
- النوع: string تعدادsort
By القيم- T
I M E S T A M P - T
O K E N S - C
A S H
- النوع: string تعدادsort
Direction DESC(الافتراضي) يعيد أحدث الصفوف أولًا؛ وASCالأقدم أولًا. الترتيبان مستقران — الاستعلام نفسه يعيد الصفوف نفسها عند أيlimit/offset، فتتكامل الصفحات بلا فجوات أو تكرار.القيم- A
S C - D
E S C
- النوع: integerstartالحد الأدنى:0
طابع زمني للحد الأدنى (بالثواني) لنافذة النشاط. احذفه أو مرّر
0للنافذة الافتراضية (أحدث ~3 سنوات تقريبًا)؛ مرّر حقبة زمنية موجبة (مثل1) لاسترجاع السجل الكامل. معsortDirection=ASC، حذفstartيعني أصلًا القراءة من بداية سجل الحساب (بلا نافذة افتراضية). - النوع: array string[] تعدادtype
قائمة أنواع نشاط مفصولة بفواصل لتضمينها. تتطلب سجلات DEPOSIT وWITHDRAWAL أيضًا
excludeDepositsWithdrawals=false.القيم- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- النوع: stringuserمطلوب
عنوان الملف الشخصي للمستخدم (بادئة 0x، 40 حرفًا سداسيًا)
- النوع: array object[] · Response65D835437A58_Activity[]200
نجاح
- assetالنوع: string
معرّف الرمز الذي يشير إليه هذا الصف. يُملأ في صفوف
REDEEMبالرمز الذي يسوّيه الصف. فارغ عندما لا يكون الصف خاصًا برمز. - bioالنوع: string
- conditionالنوع: string · Response65D835437A58_Hash64
Id سلسلة ست عشرية من 64 خانة تبدأ بـ 0x
- eventالنوع: string
Slug - iconالنوع: string
العمل الفني للسوق. يعود إلى صورة السوق، ثم إلى أيقونة الحدث الأصلي وصورته، عندما يكون للسوق أيقونة خاصة به. فارغ في صفوف
CONVERSION. - isالنوع: boolean
Combo صحيح عندما يكون هذا الصف جزءًا من مركز تجميعي (متعدد الأسواق). علم فقط — لا تُضمَّن تفاصيل التجميع هنا. يساوي conditionId الخاص بالصف combo_condition_id الخاص بالتجميع؛ مرّره إلى /v1/activity/combos أو /v1/positions/combos عبر market_id لجلب الأرجل والتفاصيل. يُحذف في الصفوف غير التجميعية.
- nameالنوع: string
- outcomeالنوع: string
- outcomeالنوع: integer
Index فهرس النتيجة لهذا الصف في مصفوفة
outcomesالخاصة بالسوق، بدءًا من الصفر، لذا يساويoutcomeدائمًاoutcomes[outcomeIndex]. في صفوفREDEEMيحدد النتيجة التي يسوّيها الصف، لا النتيجة الفائزة في السوق. يعني999أنه تعذّر تحديد النتيجة، وفي هذه الحالة يكونoutcomeفارغًا. - priceالنوع: number
- profileالنوع: string
Image - profileالنوع: string
Image Optimized - proxyالنوع: string · Response65D835437A58_Address
Wallet عنوان الملف الشخصي للمستخدم (بادئة 0x، 40 حرفًا سداسيًا)
- pseudonymالنوع: string
- sideالنوع: string تعدادالقيم
- B
U Y - S
E L L
- sizeالنوع: number
مبلغ الرمز لهذا الصف. في صفوف
REDEEMهو عدد الرموز المحروقة لنتيجة هذا الصف، لذا فإن تسوية طرفي السوق تعيد صفًا واحدًا لكل نتيجة بدلًا من صف مجمّع واحد. - slugالنوع: string
- timestampالنوع: integer التنسيق: int64
Signed 64-bit integers (long type).
- titleالنوع: string
- transactionالنوع: string
Hash - typeالنوع: string تعدادالقيم
- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- usdcالنوع: number
Size مبلغ USDC لهذا الصف. في صفوف
REDEEMهو العائد لنتيجة هذا الصف ويساوي0لنتيجة خاسرة؛ وتجمع صفوف التسوية الواحدة إلى إجمالي العائد.
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"timestamp": 1,
"conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
"type": "TRADE",
"size": 1,
"usdcSize": 1,
"transactionHash": "string",
"price": 1,
"asset": "string",
"side": "BUY",
"outcomeIndex": 1,
"title": "string",
"slug": "string",
"icon": "string",
"eventSlug": "string",
"outcome": "string",
"name": "string",
"pseudonym": "string",
"bio": "string",
"profileImage": "string",
"profileImageOptimized": "string",
"isCombo": true
}
]