تخيل أنك تريد تتبع كيفية تسعير السوق لحدث اقتصادي واحد عبر Kalshi وPolymarket وForecastEx. على الورق، يبدو ذلك كلوحة تحكم بسيطة. لكن عمليًا، يعني ذلك ثلاث واجهات برمجة تطبيقات مختلفة، وثلاث طرق لتحديد السوق نفسه، وثلاث صيغ استجابة يجب التوفيق بينها قبل أن تتمكن من رسم مخطط واحد.
وتزداد هذه المشكلة مع كل منصة جديدة. فأسواق التنبؤات تمتد الآن عبر بورصات أمريكية منظَّمة، وبروتوكولات على السلسلة، ومجتمعات بأموال لعبية، وعقود أحداث من منصات تشفير راسخة، ولا تشترك أي منها في نموذج بيانات موحّد.
هذه هي الفجوة التي صُمِّم FinFeedAPI لسدّها. فواجهة Prediction Markets API الخاصة به تجمع تسع بورصات تحت مخطط موحّد واحد، بحيث يمكن للمطورين الاستعلام عن الأسواق والصفقات ودفاتر الأوامر والسجل بالطريقة نفسها، بغض النظر عن مصدر البيانات.
بالنسبة للمطورين، يأتي هذا النمو مصحوبًا بحقيقة فوضوية. فكل منصة تكشف عن واجهة برمجية خاصة بها، ومعرّفات أسواق خاصة بها، وأعراف تسمية خاصة بها، وتصوّر خاص بها لشكل «السوق» أصلًا. هل تريد لوحة تحكم تتتبع الحدث نفسه عبر ثلاث منصات؟ الآن أنت تدير ثلاث عمليات تكامل، وثلاثة نماذج بيانات، وثلاث مجموعات من الحالات الحدّية.
وهذه بالضبط هي المشكلة التي يحاول FinFeedAPI حلّها.
في هذه المراجعة، سأستعرض ما يغطيه Prediction Markets API من FinFeedAPI، وما البيانات التي ستحصل عليها فعلًا، وكيف تبدو نقاط النهاية عمليًا، وكم تبلغ تكلفته، وأين يقصّر، حتى تتمكن من تحديد ما إذا كان يناسب بيئتك التقنية.
الملخص السريع (TL;DR)
| البند | التفاصيل |
|---|---|
| المزوّد | FinFeedAPI من API Bricks (الشركة نفسها وراء CoinAPI) |
| البورصات المغطاة | 9 منصات لأسواق التنبؤات |
| البيانات | الأسواق والبيانات الوصفية، الصفقات، التسعيرات، دفاتر الأوامر، OHLCV، ملفات مسطّحة تاريخية |
| الوصول | REST، JSON-RPC، خادم MCP مُستضاف، Flat Files (S3) |
| الوضع | بيانات سوق للقراءة فقط، طلب-استجابة (بدون بث WebSocket) |
| التسعير | أرصدة مجانية للبدء، ثم تسعير حسب الاستخدام يبدأ من 1 دولار لكل 1,000 طلب |
| الأفضل لـ | لوحات التحكم متعددة البورصات، البحث، الاختبار الخلفي، وكلاء الذكاء الاصطناعي |
ما هو FinFeedAPI؟
FinFeedAPI هو مزوّد بيانات مالية بنته شركة API Bricks، وهي الشركة نفسها وراء CoinAPI. وإلى جانب واجهات Stock وCurrencies وSEC APIs الخاصة بها، يقدّم Prediction Markets API يمنحك وصولًا موحّدًا إلى بيانات السوق من تسع بورصات لأسواق التنبؤات من خلال تكامل واحد.
الفكرة بسيطة: بدلًا من تعلّم تسع واجهات برمجية، تتعلّم واحدة. فمعرّفات الأسواق والنتائج والطوابع الزمنية وبُنى الاستجابة تتبع المخطط نفسه بغض النظر عن البورصة التي جاءت منها البيانات.
برزت لي بعض التفاصيل الهندسية أثناء تصفّحي للتوثيق:
- نموذج بيانات موحّد عبر كل بورصة مدعومة
-
معرّفات أسواق موحّدة تتضمن النتيجة، مثل
..._YESو..._NO - طوابع زمنية بتوقيت ISO 8601 UTC على كل نقطة نهاية
- دقة رقمية متسقة، حتى 19 رقمًا مع 9 منازل عشرية
- أربع طرق للوصول: REST، JSON-RPC، خادم MCP مُستضاف، وFlat Files
أمر واحد يجب توضيحه منذ البداية: FinFeedAPI هو طبقة بيانات سوق للقراءة فقط. فهو لا يرسل الأوامر. وإذا كان منتجك يحتاج إلى التنفيذ، فستظل بحاجة إلى استخدام واجهة كل بورصة الأصلية لذلك الجزء.
منصات أسواق التنبؤات المدعومة
يغطي FinFeedAPI حاليًا تسع منصات، تمتد عبر بورصات منظَّمة وبروتوكولات لامركزية وأسواق نتائج على السلسلة ومجتمع بأموال لعبية.
| المنصة | النوع | ما تغطيه |
|---|---|---|
| Polymarket | لامركزية | السياسة، والاقتصاد، والعملات الرقمية، والرياضة، والأحداث العالمية |
| Kalshi | منظَّمة (CFTC) | عقود أحداث أمريكية على المؤشرات الاقتصادية والانتخابات والطقس والرياضة وغيرها |
| ForecastEx | منظَّمة (CFTC) | عقود أحداث أمريكية، تشمل النتائج الاقتصادية والمالية |
| Gemini Prediction Markets | منظَّمة | عقود أحداث على الرياضة والعملات الرقمية والاقتصاد والسياسة ومواضيع أخرى |
| Crypto.com Prediction Markets | منظَّمة | عقود قائمة على الأحداث على منصة أسواق التنبؤات الخاصة بـ Crypto.com |
| Myriad | لامركزية | العملات الرقمية والأحداث الجارية ونتائج أخرى |
| Pascal | لامركزية | أسواق تنبؤات غير وصائية مبنية على Solana |
| Hyperliquid Outcome Markets (HIP-4) | أسواق نتائج على السلسلة | عقود أحداث ثنائية ومتعددة النتائج على البنية التحتية الأصلية لـ Hyperliquid |
| Manifold Markets | اجتماعية، بأموال لعبية | أسواق يقودها المجتمع في مجموعة واسعة من المواضيع |
التنوّع هو ما يجعل هذا مثيرًا للاهتمام. فمقارنة كيفية تسعير منصة منظَّمة، ومنصة مولودة من عالم التشفير، وجمهور بأموال لعبية للحدث نفسه، هي حيث يصبح البحث عبر البورصات قيّمًا. وهي أيضًا حيث يوفّر المخطط الموحّد أكبر قدر من الوقت.
ما البيانات التي يمكنك الوصول إليها؟
هنا يستحق FinFeedAPI قيمته. فمعظم أدوات أسواق التنبؤات تتوقف عند آخر سعر. أما FinFeedAPI فيكشف السوق بأكمله، من الاستكشاف وصولًا إلى عمق دفتر الأوامر والسجل.
جميع نقاط نهاية REST موجودة تحت https://api.prediction-markets.finfeedapi.com/v1.
| مجموعة البيانات | نقطة النهاية | ما تحصل عليه |
|---|---|---|
| البورصات |
GET /exchanges و/exchanges/{exchange_id}
|
المنصات المدعومة، ومعرّفات البورصات، والأوصاف، والمواقع الإلكترونية |
| الأسواق النشطة | GET /markets/{exchange_id}/active |
قائمة مختصرة بمعرّفات الأسواق النشطة حاليًا |
| قوائم الأسواق | GET /markets/{exchange_id}/history |
سجلات أسواق كاملة مع ترقيم صفحات قائم على المؤشر: العناوين، والأوصاف، والنتائج، والأسعار، والحالة |
| سوق واحد | GET /markets/{exchange_id}/{market_id} |
البيانات الوصفية لسوق واحد |
| النشاط الحالي | GET /activity/{exchange_id}/{market_id}/current |
أحدث صفقة مع أحدث عرض شراء وعرض بيع |
| النشاط الأخير | GET /activity/{exchange_id}/{market_id}/latest |
الصفقات الأخيرة وتحديثات التسعيرات |
| الصفقات والتسعيرات التاريخية |
GET /activity/{exchange_id}/{market_id}/history/trades و/history/quotes
|
سجلات تاريخية تُقدَّم من الملفات المسطّحة |
| دفتر الأوامر الحالي | GET /orderbook/{exchange_id}/{market_id}/current |
عروض الشراء والبيع لنتيجة سوق |
| دفتر الأوامر التاريخي | GET /orderbook/{exchange_id}/{market_id}/history |
أحداث أوامر محدّدة خام (إضافات، تحديثات، حذف) لإعادة بناء الدفتر |
| OHLCV |
GET /ohlcv/periods، /ohlcv/{exchange_id}/{market_id}/history، /latest، /ohlcv/{exchange_id}/history
|
شموع مع الافتتاح والأعلى والأدنى والإغلاق والحجم وعدد الصفقات |
بعض الأمور التي يجدر معرفتها:
-
الاستكشاف على خطوتين. نقطة النهاية
/activeتُرجع المعرّفات فقط، لأنها مشتقّة من التسعيرات والصفقات الحديثة. وتستدعي/historyأو نقطة نهاية السوق الواحد للحصول على التفاصيل الكاملة. - تمتد فترات OHLCV من الثواني إلى السنوات، وتعود الشموع التاريخية بترتيب زمني تصاعدي، وهو ما تريده للاختبار الخلفي.
- بيانات دفتر الأوامر التاريخية على مستوى الأحداث، وليست مجرد لقطات. وهذا يفتح الباب لإعادة تشغيل السوق وبحوث السيولة.
- بيانات دورة الحياة والتسوية تغطي الحالات المفتوحة والمغلقة والمسوّاة والمعلَّقة، مع معلومات التسوية حيث تدعمها بورصة المصدر.
البدء: طلباتك الأولى
التسجيل سريع. تُنشئ حسابًا مجانيًا، وتُنشئ مفتاح API من وحدة التحكم، وتبدأ بأرصدة مجانية.
بالنسبة لـ REST وJSON-RPC، تمرّر المفتاح في ترويسة Authorization. ويقبل التوثيق أيضًا X-APIKey وX-APIBricks-Key وX-CoinAPI-Key.
1. اسرد البورصات المدعومة
ابدأ من هنا للحصول على قيم exchange_id الدقيقة التي ستستخدمها في كل مكان آخر.
curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/exchanges" \
-H "[REDACTED CREDENTIAL]"
2. اكتشف الأسواق النشطة
curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/markets/POLYMARKET/active?limit=10" \
-H "Authorization: YOUR_API_KEY"
هذا يُرجع قائمة بسيطة بمعرّفات الأسواق، كل منها يتضمن نتيجته مدمجة:
[
"WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES",
"WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_NO",
"NFL-PIT-CAR-2025-08-21-SPREAD-AWAY-5PT5_YES"
]
3. احصل على أحدث صفقة وتسعيرة
curl -X GET \
"https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES/current" \
-H "[REDACTED CREDENTIAL]
تمنحك الاستجابة أحدث صفقة مع أحدث عرض شراء وعرض بيع لتلك النتيجة.
4. اسحب OHLCV التاريخي بلغة Python
هذا هو الاستدعاء الذي سألجأ إليه أولًا عند بناء مخطط احتمالي أو اختبار خلفي.
import requests
[REDACTED CREDENTIAL]
BASE = "https://api.prediction-markets.finfeedapi.com/v1"
headers = {[REDACTED CREDENTIAL]}
market_id = "WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES"
resp = requests.get(
f"{BASE}/ohlcv/POLYMARKET/{market_id}/history",
headers=headers,
params={"period_id": "1DAY", "limit": 30},
)
resp.raise_for_status()
for candle in resp.json():
print(candle["time_period_start"], candle["price_close"], candle["volume_traded"])
تشمل كل شمعة time_period_start وtime_period_end وprice_open وprice_high وprice_low وprice_close وvolume_traded وtrades_count. واستدعِ /ohlcv/periods لرؤية كل period_id مدعوم.
5. تحقق من عمق دفتر الأوامر
curl -X GET \
"https://api.prediction-markets.finfeedapi.com/v1/orderbook/POLYMARKET/WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES/current" \
-H "[REDACTED CREDENTIAL]
تُرجع اللقطة exchange_id وmarket_id وtime_exchange وtime_coinapi، بالإضافة إلى مصفوفتي bids وasks. وهذا كافٍ لحساب الفروق واختلال أفضل عرض في الدفتر.
وإذا كنت تفضّل عدم كتابة HTTP خام، تنشر API Bricks حزم تطوير رسمية (Python وNode.js وGo وC# وغيرها) في مستودع SDK على GitHub.
ما بعد REST: MCP وJSON-RPC والملفات المسطّحة
كل واجهة تكشف مجموعات البيانات الموحّدة نفسها. وتختار الواجهة التي تناسب بنيتك.
| الواجهة | ترويسة المصادقة | الأفضل لـ |
|---|---|---|
| REST API | Authorization |
لوحات التحكم، والتحليلات، وتطبيقات الإنتاج |
| JSON-RPC API | Authorization |
الخدمات التي تفضّل استدعاءات بأسلوب RPC على البيانات نفسها |
| خادم MCP مُستضاف | X-APIKey |
مساعدو الذكاء الاصطناعي، ووكلاء البرمجة، وسير عمل البحث |
| Flat Files (S3) | بيانات اعتماد متوافقة مع S3 | السجلّات الضخمة للاختبار الخلفي وتعلّم الآلة |
خادم MCP هو الميزة البارزة
من وجهة نظري، هذا هو الجزء الأكثر استشرافًا في المنتج. فبدلًا من تعليم وكيل ذكي وثائق واجهتك البرمجية، توجّهه إلى نقطة نهاية MCP مُستضافة فيكتشف الأدوات بنفسه.
الإعداد عبارة عن بضعة أسطر من الإعدادات في Cursor أو Claude Desktop أو أي عميل يدعم MCP:
{
"mcpServers": {
"FinFeedAPI-Prediction-Markets": {
"url": "https://api.prediction-markets.finfeedapi.com/mcp",
"headers": {
[REDACTED CREDENTIAL]
}
}
}
}
يكشف الخادم حاليًا أدوات من أجل:
-
استكشاف البورصات:
exchanges_list،exchanges_get -
استكشاف الأسواق:
markets_get_active،markets_get_history -
النشاط المباشر:
activity_get_current،activity_get_latest -
الصفقات والتسعيرات التاريخية:
activity_get_trades_history،activity_get_quotes_history -
OHLCV:
ohlcv_list_periods،ohlcv_get_latest_market،ohlcv_get_history_market،ohlcv_get_history_exchange -
دفاتر الأوامر:
orderbook_get_current،orderbook_get_history
وهذا يعني أنه يمكنك أن تطلب من وكيل ذكي شيئًا مثل «اعثر على أنشط أسواق Kalshi وأرني كيف تحرّكت احتمالاتها هذا الأسبوع» فيستطيع أن يربط استدعاءات الاستكشاف والنشاط وOHLCV بنفسه.
ملاحظة إذا كنت قد أعددت اتصال MCP قديمًا بـ FinFeedAPI: انتقلت نقطة النهاية من /sse إلى /mcp، لذا تحتاج الإعدادات الأقدم إلى تحديث.
الملفات المسطّحة للسجلّات الضخمة
بالنسبة للبحوث واسعة النطاق، فإن سحب سنوات من البيانات عبر استدعاءات REST مُرقَّمة بالصفحات بطيء. تمنحك Flat Files صفقات وتسعيرات ودفاتر أوامر وOHLCV بكميات كبيرة عبر واجهة برمجية متوافقة مع S3، بحيث يمكنك استخدام أدوات وحزم تطوير S3 التي تعرفها بالفعل.
التسعير
يستخدم FinFeedAPI تسعيرًا حسب الاستخدام قائمًا على الأرصدة. تبدأ بأرصدة مجانية، ثم تدفع مقابل كل طلب.
في خطة الدفع حسب الاستخدام (Pay As You Go)، تبلغ تكلفة أول 1,000 طلب يوميًا 5 دولارات لكل 1,000، وأي شيء يتجاوز 1,000 يوميًا ينخفض إلى 1 دولار لكل 1,000. وتخفض الخطط الالتزامية هذا المعدل.
| الخطة | شهريًا | المعدل لكل رصيد | إضافات ملحوظة |
|---|---|---|---|
| الدفع حسب الاستخدام | بدون التزام | 1.00 دولار | دعم بالذكاء الاصطناعي والبريد الإلكتروني، وتسجيل ذاتي |
| التزامي 64 | 64 دولارًا | 0.85 دولار | تسجيل بمساعدة الذكاء الاصطناعي |
| التزامي 256 | 256 دولارًا | 0.75 دولار | تسجيل بمساعدة الذكاء الاصطناعي |
| التزامي 512 | 512 دولارًا | 0.70 دولار | دعم على Slack، قناة Slack مخصّصة |
| التزامي 1024 | 1,024 دولارًا | 0.65 دولار | اتفاقية مستوى خدمة بنسبة تشغيل 99.9%، ومدير نجاح العملاء، وتسجيل بشري |
| المؤسسات | مخصّص | مخصّص | اتفاقيات مستوى خدمة مخصّصة، وتحسينات الكمون، وبنية تحتية مخصّصة |
لا تقلل الخطط الالتزامية مما تستهلكه. فهي تمنحك أرصدة أكثر مقابل النفقات نفسها، وبمجرد نفاد تلك الأرصدة، تُحاسَب الاستخدامات الإضافية بمعدل خطة الدفع حسب الاستخدام. يتوفر أيضًا الفوترة السنوية.
رأيي: بالنسبة للنماذج الأولية والبحث، خطة الدفع حسب الاستخدام جيدة. أما إذا كنت تستعلم عن أسواق كثيرة كل بضع ثوانٍ، فأجرِ الحسابات أولًا. ينشر FinFeedAPI حالات استخدام للتسعير للوحات التحكم ومراقبة دفاتر الأوامر والتعبئة التاريخية لـ OHLCV، مما يسهّل تقدير التكلفة كثيرًا.
أين يقصّر FinFeedAPI
لا توجد واجهة برمجية مثالية، والمراجعة التي تتجاهل المقايضات ليست ذات فائدة كبيرة. إليك ما يجب أن تضعه في اعتبارك:
- لا يوجد تنفيذ للأوامر. فهو طبقة بيانات فقط. ولا تزال روبوتات التداول بحاجة إلى واجهات البورصات الأصلية لإرسال الأوامر.
- لا يوجد بث WebSocket لأسواق التنبؤات. فالبيانات الحالية تأتي عبر استدعاءات طلب-استجابة، لذا يعني «المباشر» الاستعلام الدوري. وبالنسبة للاستراتيجيات الحساسة للكمون، يعد ذلك قيدًا حقيقيًا، كما أن الاستعلام المتكرر يضيف إلى فاتورتك.
- أول 1,000 طلب يوميًا هي الأغلى. فبمعدل 5 دولارات لكل 1,000 مقابل 1 دولار لكل 1,000 بعد ذلك، تدفع المشاريع الصغيرة جدًا معدلًا فعليًا أعلى من المشاريع المزدحمة.
- تعتمد بيانات التسوية على المصدر. فتفاصيل دورة الحياة والتسوية لا تكون مكتملة إلا بقدر ما تكشفه كل بورصة.
- التوحيد مقايضة. المخطط الموحّد هو الهدف كله، لكن إذا كنت تعتمد على حقل خاص بمنصة واحدة، فتحقق من عيّنات البيانات قبل أن تلتزم.
لا شيء من هذه الأمور يمثل عائقًا قاطعًا للتحليلات أو البحث أو حالات استخدام الذكاء الاصطناعي. وهي تهم أكثر إذا كنت تبني نظام تداول عالي التردد.
من يجب أن يستخدم FinFeedAPI؟
نقاط القوة
- تسع منصات لأسواق التنبؤات خلف مخطط واحد
- دورة حياة سوق كاملة: الاستكشاف، والصفقات، والتسعيرات، ودفاتر الأوامر، وOHLCV، والسجل
- بيانات دفتر أوامر تاريخية على مستوى الأحداث لإعادة التشغيل
- خادم MCP مُستضاف يعمل مع Cursor وClaude Desktop
- ملفات مسطّحة ضخمة للبحث وتعلّم الآلة
- تسعير حسب الاستخدام مع أرصدة مجانية للبدء
الأفضل لـ
- لوحات التحكم متعددة البورصات التي تقارن الاحتمالات عبر المنصات
- الباحثون والمحللون الكمّيون الذين يجرون اختبارات خلفية لاستراتيجيات أسواق التنبؤات
- فرق التنبؤ وتعلّم الآلة التي تحتاج إلى OHLCV تاريخي نظيف
- تحليلات السيولة المبنية على عمق دفتر الأوامر والفروق
- فرق الذكاء الاصطناعي التي تبني وكلاء يستنتجون حول أحداث العالم الواقعي
- البحث الأكاديمي والاقتصادي حول كيفية تسعير الجماهير للنتائج
غالبًا ليس لـ
- الروبوتات التي تحتاج إلى إرسال الأوامر
- الاستراتيجيات التي تحتاج إلى بث قائم على الدفع دون ثانية
أفكار ختامية
تنمو أسواق التنبؤات أسرع مما تستطيع معظم الفرق دمجه. فكل منصة جديدة تجلب معرّفات جديدة وصيغًا جديدة وعمل صيانة جديدًا.
لا يحاول FinFeedAPI أن يكون بورصة. بل يركّز على مهمة واحدة: تحويل تسع منصات مجزّأة إلى طبقة بيانات متسقة واحدة. فتعود الأسواق والصفقات والتسعيرات ودفاتر الأوامر وOHLCV والسجل العميق بالشكل نفسه، عبر REST أو JSON-RPC أو MCP أو Flat Files.
ادخل إليه مدركًا أنه للقراءة فقط وبأسلوب طلب-استجابة، وسيناسب مجموعة واسعة من المنتجات، من لوحات التحكم في التنبؤات إلى وكلاء البحث بالذكاء الاصطناعي.
تسع منصات. مخطط واحد. مفتاح API واحد. بنية أقل، وبناء أكثر.
الموقع الإلكتروني: finfeedapi.com/products/prediction-markets-api
توثيق API: توثيق Prediction Markets REST API






Top comments (0)