بثّ أخبار الأسهم الفورية في Python مع finlight

بثّ أخبار الأسهم الفورية في Python مع finlight

استطلاع واجهة API للحصول على الأخبار يعني أنك دائمًا متأخر قليلًا. وللوحات المعلومات الحية وإشارات التداول، تريد كل مقال في لحظة نشره. وهذا تحديدًا ما يفعله WebSocket من finlight، فيما يجعله Python SDK بضعة أسطر فقط. في هذا الدرس ستبني بثًّا حيًّا لأخبار الأسهم، مُصفّى حسب رمز السهم ومُقيَّمًا للمشاعر مسبقًا.

تثبيت الـ SDK

pip install finlight-client

المثال الكامل

import asyncio

from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesWebSocketParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))


def on_article(article):
    print(f"[{article.sentiment}] {article.title} - {article.source}")


async def main():
    await client.websocket.connect(
        request_payload=GetArticlesWebSocketParams(
            tickers=["AAPL", "NVDA"],
            includeEntities=True,
        ),
        on_article=on_article,
    )


if __name__ == "__main__":
    asyncio.run(main())

شغّله، وفي كل مرة يُنشر فيها مقال مطابق، يُستدعى ردّ النداء on_article ومعه المقال، بما في ذلك sentiment وtitle وsource و(لأن includeEntities مُفعّل) الشركات المُوسومة.

ما الذي يحدث

• client.websocket.connect(...) يفتح اتصالًا مستمرًا ويبثّ المقالات المطابقة. وهو استدعاء غير متزامن، لذا يعمل داخل asyncio.run(...).
• GetArticlesWebSocketParams يقبل الأنواع نفسها من عوامل التصفية كواجهة REST API: tickers وquery وsources وcountries وcategories وlanguage وincludeEntities وغيرها.
• on_article هو معالجك. هنا تدفع البيانات إلى طابور، أو تحدّث لوحة معلومات، أو تقيّم إشارة بدلًا من مجرد الطباعة.

يدير الـ SDK الاتصال نيابةً عنك، بما في ذلك إعادة الاتصال التلقائي مع تراجع زمني، لذا لن يوقف انقطاعٌ واحد بثّك.

المُحسّن مقابل الخام

client.websocket هو البثّ المُحسّن: تصل المقالات بإثراء كامل (المشاعر والكيانات). وإذا كنت تحتاج فقط بيانات المقال الأساسية الخفيفة بأسرع ما يمكن، فهناك أيضًا client.raw_websocket بالشكل نفسه لـ connect(...). استخدم المُحسّن حين تريد التحليل، والخام حين تريد أدنى كمون.

صفِّ بدقة إلى ما تحتاجه

بما أن WebSocket يقبل عوامل التصفية نفسها كـ REST، يمكنك بثّ شريحة دقيقة: أخبار العملات المشفرة فقط، أو قائمة متابعة من رموز أسهم فقط، أو دول معينة فقط. راجع التصفية المتقدمة للاطلاع على مجموعة عوامل التصفية الكاملة.

إلى أين تذهب بعد ذلك

• مقارنة REST وWebSocket وWebhooks وMCP لتقرر متى يكون البثّ هو الخيار الصحيح.
• الوثائق الكاملة لأدلة WebSocket.

احصل على مفتاح API المجاني ←