مراجعة FinFeedAPI: واجهة برمجة تطبيقات بيانات أسواق التنبؤ متعددة المنصات

تخيّل أنك تريد تتبع كيفية تسعير السوق لحدث اقتصادي واحد عبر Kalshi وPolymarket وForecastEx. على الورق، يبدو ذلك كلوحة معلومات بسيطة. أما عمليًا، فهو يعني ثلاث واجهات API مختلفة، وثلاث طرق لتحديد السوق نفسه، وثلاث صيغ استجابة يجب التوفيق بينها قبل أن تتمكن من رسم مخطط واحد.

تتفاقم هذه المشكلة مع كل ساحة جديدة. فأسواق التوقعات تمتد الآن من بورصات أمريكية منظّمة، إلى بروتوكولات على السلسلة، ومجتمعات بأموال افتراضية، وعقود أحداث من منصات عملات رقمية راسخة، ولا تشترك أي منها في نموذج بيانات موحّد.

هذه هي الفجوة التي صُمّم FinFeedAPI لسدّها. فـ Prediction Markets API الخاص به يجمع تسع منصات تحت مخطط معياري واحد، بحيث يستطيع المطورون الاستعلام عن الأسواق والصفقات ودفاتر الأوامر والسجل التاريخي بالطريقة نفسها، بصرف النظر عن مصدر البيانات.

وبالنسبة للمطورين، يأتي هذا النمو مصحوبًا بحقيقة فوضوية: كل ساحة تكشف عن واجهة API خاصة بها، ومعرّفات أسواق خاصة بها، وأعراف تسمية خاصة بها، وتصوّرها الخاص لما يعنيه "السوق" أصلًا. هل تريد لوحة معلومات تتابع الحدث نفسه عبر ثلاث منصات؟ إذًا أنت الآن تدير ثلاث عمليات تكامل، وثلاثة نماذج بيانات، وثلاث مجموعات من الحالات الاستثنائية.

وهذه بالتحديد هي المشكلة التي يحاول FinFeedAPI حلّها.

في هذه المراجعة، سأستعرض ما يغطيه Prediction Markets API من FinFeedAPI، والبيانات التي ستحصل عليها فعليًا، وكيف تبدو نقاط النهاية عمليًا، وتكلفته، وأين يقصّر، لتتمكن من تحديد ما إذا كان يناسب منظومتك أم لا.

باختصار

ما هو FinFeedAPI؟

FinFeedAPI هو مزوّد لبيانات مالية بنته شركة API Bricks، وهي الشركة نفسها التي تقف خلف CoinAPI. وإلى جانب واجهات Stock وCurrencies وSEC، يقدّم Prediction Markets API يمنحك وصولًا معياريًا إلى بيانات السوق من تسع منصات لأسواق التوقعات عبر تكامل واحد.

الفكرة بسيطة: بدلًا من تعلّم تسع واجهات API، تتعلّم واجهة واحدة. فمعرّفات الأسواق والنتائج والطوابع الزمنية وبنى الاستجابة تتبع المخطط نفسه مهما كانت المنصة التي جاءت منها البيانات.

لفتت انتباهي أثناء تصفّح الوثائق عدة تفاصيل هندسية:

• نموذج بيانات موحّد عبر كل منصة مدعومة
• معرّفات أسواق معيارية تتضمّن النتيجة، مثل ..._YES و..._NO
• طوابع زمنية بصيغة ISO 8601 بتوقيت UTC في كل نقطة نهاية
• دقة عددية متسقة، تصل إلى 19 رقمًا مع 9 خانات عشرية
• أربع طرق للدخول: REST، وJSON-RPC، وخادم MCP مستضاف، والملفات المسطّحة

من المهم توضيح أمر منذ البداية: FinFeedAPI هو طبقة بيانات سوق للقراءة فقط. فهو لا ينفّذ أوامر. وإذا كان منتجك يحتاج إلى التنفيذ، فستظل تستخدم الواجهة الأصلية لكل منصة لهذا الجزء.

منصات أسواق التوقعات المدعومة

يغطي FinFeedAPI حاليًا تسع ساحات، تشمل بورصات منظّمة، وبروتوكولات لامركزية، وأسواق نتائج على السلسلة، ومجتمعًا بأموال افتراضية.

هذا المزيج هو ما يجعل الأمر مثيرًا للاهتمام. فمقارنة كيفية تسعير منصة منظّمة، ومنصة وليدة من عالم العملات الرقمية، وجمهور يستخدم أموالًا افتراضية للحدث نفسه، هي ما يمنح البحث عبر المنصات المتعددة قيمته. وهي أيضًا الموضع الذي يوفّر فيه المخطط الموحّد أكبر قدر من الوقت.

ما البيانات التي يمكنك الوصول إليها؟

هنا يُثبت FinFeedAPI قيمته. فمعظم أدوات أسواق التوقعات تتوقف عند آخر سعر. أما FinFeedAPI فيكشف السوق بالكامل، من الاستكشاف وصولًا إلى عمق دفتر الأوامر والسجل التاريخي.

جميع نقاط نهاية REST تقع تحت https://api.prediction-markets.finfeedapi.com/v1.

ثمة أمور قليلة يجدر معرفتها:

• الاستكشاف يتم على خطوتين. نقطة النهاية /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 "Authorization: YOUR_API_KEY"

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 "Authorization: YOUR_API_KEY"

تمنحك الاستجابة أحدث صفقة إلى جانب أحدث عرض شراء وعرض بيع لتلك النتيجة.

4. اجلب بيانات OHLCV التاريخية باستخدام Python

هذا هو الاستدعاء الذي سألجأ إليه أولًا عند بناء مخطط احتمالات أو اختبار خلفي.

import requests

API_KEY = "YOUR_API_KEY"
BASE = "<https://api.prediction-markets.finfeedapi.com/v1>"
headers = {"Authorization": API_KEY}

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 "Authorization: YOUR_API_KEY"

تُرجع اللقطة exchange_id وmarket_id وtime_exchange وtime_coinapi، بالإضافة إلى مصفوفتي bids وasks. وهذا يكفي لحساب الفروق واختلال التوازن عند أفضل مستوى في الدفتر.

وإن كنت تفضّل عدم كتابة طلبات HTTP خام، فإن API Bricks تنشر حِزم تطوير رسمية (Python وNode.js وGo وC# وغيرها) في مستودع SDK على GitHub.

ما هو أبعد من REST: MCP وJSON-RPC والملفات المسطّحة

كل واجهة تكشف مجموعات البيانات المعيارية نفسها. وتختار أنت الواجهة التي تناسب معماريتك.

خادم MCP هو الأبرز

من وجهة نظري، هذا هو الجزء الأكثر استشرافًا في المنتج. فبدلًا من تعليم وكيل ذكي وثائق واجهتك، توجّهه إلى نقطة نهاية MCP مستضافة فيكتشف الأدوات بنفسه.

الإعداد عبارة عن أسطر قليلة من الإعدادات في Cursor أو Claude Desktop أو أي عميل يدعم MCP:

{
  "mcpServers": {
    "FinFeedAPI-Prediction-Markets": {
      "url": "<https://api.prediction-markets.finfeedapi.com/mcp>",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

يكشف الخادم حاليًا عن أدوات من أجل:

• استكشاف المنصات: 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 المُرقّمة بالصفحات بطيئًا. تمنحك الملفات المسطّحة صفقات وعروض أسعار ودفاتر أوامر وOHLCV بكميات كبيرة عبر واجهة متوافقة مع S3، لتستخدم أدوات وواجهات S3 التي تعرفها بالفعل.

التسعير

يستخدم FinFeedAPI تسعيرًا قائمًا على الأرصدة وحسب الاستخدام. تبدأ بأرصدة مجانية، ثم تدفع مقابل كل طلب.

في خطة الدفع حسب الاستخدام، تكلّف أول 1,000 طلب يوميًا 5 دولارات لكل 1,000، وأي استخدام يتجاوز 1,000 يوميًا ينخفض إلى دولار واحد لكل 1,000. وتخفض الخطط الملتزمة هذا السعر.

الخطط الملتزمة لا تقلّل مما تستهلكه. بل تمنحك أرصدة أكثر مقابل الإنفاق نفسه، وعند نفاد تلك الأرصدة يُحتسب الاستخدام الإضافي بسعر الدفع حسب الاستخدام. كما يتوفر الفوترة السنوية أيضًا.

رأيي: للنماذج الأولية والبحث، خطة الدفع حسب الاستخدام مناسبة. أما إن كنت تستعلم عن أسواق كثيرة كل بضع ثوانٍ، فأجرِ الحسابات أولًا. ينشر FinFeedAPI حالات استخدام للتسعير تخص لوحات المعلومات ومراقبة دفاتر الأوامر والتعبئة التاريخية لبيانات OHLCV، ما يسهّل التقدير كثيرًا.

أين يقصّر FinFeedAPI

لا توجد واجهة API مثالية، والمراجعة التي تتجاهل المقايضات ليست ذات فائدة كبيرة. إليك ما يجدر أخذه في الحسبان:

• لا يوجد تنفيذ للأوامر. فهو طبقة بيانات فقط. ولا تزال روبوتات التداول بحاجة إلى واجهات المنصات الأصلية لتنفيذ الأوامر.
• لا يوجد بث WebSocket لأسواق التوقعات. فالبيانات الحالية تأتي عبر استدعاءات الطلب والاستجابة، لذا يعني "المباشر" هنا الاستعلام الدوري. وبالنسبة للاستراتيجيات الحساسة لزمن الاستجابة، فهذا قيد حقيقي، كما أن الاستعلام المتكرر يرفع فاتورتك.
• أول 1,000 طلب يوميًا هي الأغلى. فبسعر 5 دولارات لكل 1,000 مقابل دولار واحد لكل 1,000 بعد ذلك، يدفع المشروعات الصغيرة جدًا سعرًا فعليًا أعلى من المشروعات كثيفة الاستخدام.
• تعتمد بيانات التسوية على المصدر. فتفاصيل دورة الحياة والتسوية لا تكون مكتملة إلا بالقدر الذي تكشفه كل منصة.
• التوحيد مقايضة. المخطط الموحّد هو جوهر الفكرة، لكن إن كنت تعتمد على حقل خاص بمنصة واحدة، فتحقّق من عينات البيانات قبل أن تلتزم.

لا شيء من هذه الأمور يمثل عائقًا قاطعًا للتحليلات أو البحث أو حالات استخدام الذكاء الاصطناعي. لكنها تصبح مهمة أكثر إن كنت تبني نظام تداول عالي التردد.

من ينبغي أن يستخدم FinFeedAPI؟

نقاط القوة

• تسع منصات لأسواق التوقعات خلف مخطط واحد
• دورة حياة كاملة للسوق: الاستكشاف، والصفقات، وعروض الأسعار، ودفاتر الأوامر، وOHLCV، والسجل التاريخي
• بيانات دفتر أوامر تاريخية على مستوى الأحداث لإعادة التشغيل
• خادم MCP مستضاف يعمل مع Cursor وClaude Desktop
• ملفات مسطّحة بكميات كبيرة للبحث وتعلّم الآلة
• تسعير حسب الاستخدام مع أرصدة مجانية للبدء

الأنسب لـ

• لوحات المعلومات متعددة المنصات التي تقارن الاحتمالات عبر الساحات
• الباحثين والمحللين الكميين الذين يجرون اختبارات خلفية لاستراتيجيات أسواق التوقعات
• فرق التنبؤ وتعلّم الآلة التي تحتاج بيانات OHLCV تاريخية نظيفة
• تحليلات السيولة المبنية على عمق دفاتر الأوامر والفروق السعرية
• فرق الذكاء الاصطناعي التي تبني وكلاء يستنتجون بشأن أحداث واقعية
• البحث الأكاديمي والاقتصادي حول كيفية تسعير الجمهور للنتائج

الأرجح أنه ليس لـ

• الروبوتات التي تحتاج إلى تنفيذ أوامر
• الاستراتيجيات التي تحتاج إلى بث مدفوع بأزمنة أقل من الثانية

خواطر ختامية

تنمو أسواق التوقعات بوتيرة أسرع مما تستطيع معظم الفرق دمجه. فكل ساحة جديدة تجلب معرّفات جديدة، وصيغًا جديدة، وأعمال صيانة جديدة.

لا يحاول FinFeedAPI أن يكون منصة تداول. بل يركّز على مهمة واحدة: تحويل تسع ساحات مجزّأة إلى طبقة بيانات واحدة متسقة. فالأسواق والصفقات وعروض الأسعار ودفاتر الأوامر وOHLCV والسجل التاريخي العميق تعود كلها بالشكل نفسه، عبر REST أو JSON-RPC أو MCP أو الملفات المسطّحة.

ادخل إلى الأمر وأنت تعلم أنه للقراءة فقط وبنمط الطلب والاستجابة، وسيناسب طائفة واسعة من المنتجات، من لوحات التنبؤ إلى وكلاء البحث بالذكاء الاصطناعي.

تسع ساحات. مخطط واحد. مفتاح API واحد. أعمال ربط أقل، وبناء أكثر.

الموقع الإلكتروني: finfeedapi.com/products/prediction-markets-api

وثائق API: وثائق Prediction Markets REST API

تنمو أسواق التوقعات بوتيرة أسرع مما تستطيع معظم الفرق دمجه. فكل ساحة جديدة تجلب معرّفات جديدة، وصيغًا جديدة، وأعمال صيانة جديدة.

لا يحاول FinFeedAPI أن يكون منصة تداول. بل يركّز على مهمة واحدة: تحويل تسع ساحات مجزّأة إلى طبقة بيانات واحدة متسقة. فالأسواق والصفقات وعروض الأسعار ودفاتر الأوامر وOHLCV والسجل التاريخي العميق تعود كلها بالشكل نفسه، عبر REST أو JSON-RPC أو MCP أو الملفات المسطّحة.

ادخل إلى الأمر وأنت تعلم أنه للقراءة فقط وبنمط الطلب والاستجابة، وسيناسب طائفة واسعة من المنتجات، من لوحات التنبؤ إلى وكلاء البحث بالذكاء الاصطناعي.

تسع ساحات. مخطط واحد. مفتاح API واحد. أعمال ربط أقل، وبناء أكثر.

الموقع الإلكتروني: finfeedapi.com/products/prediction-markets-api

وثائق API: وثائق Prediction Markets REST API