واجهة الأخبار الاقتصادية
عناوين الاحتياطي الفيدرالي ومؤشر أسعار المستهلك والتضخم وقرارات الفائدة من رويترز وAP وCNBC وأكثر من 100 مصدر آخر، مُصفّاة باستعلام واحد ومُسلّمة إلى نظامك عبر REST أو WebSocket أو webhooks.
نموذج بيانات المنتج
ما يحمله مقال اقتصادي كلي واحد
تم جلبه مباشرة بالاستعلام الذي بُنيت عليه هذه الصفحة:
query: "federal reserve" OR FOMC OR CPI OR inflation
categories: economy{
"title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
"link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
"source": "apnews.com",
"publishDate": "2026-08-08T14:10:06.000Z",
"language": "en",
"sentiment": "negative",
"confidence": 0.7371397614479065,
"categories": ["business", "economy", "markets"],
"countries": ["US"],
"summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
"companies": []
}البيانات مختصرة: تم حذف مصفوفة images. حقل companies فارغ في هذا المقال لأن تقرير الوظائف لا يذكر أي شركة مدرجة؛ وعندما يذكر مقال اقتصادي كلي شركة، يحمل كل كيان الرمز والبورصة (رمز MIC) وISIN والقطاع والصناعة والإدراجات المتقاطعة. مقال أسبوعي عن الأسواق من Benzinga أعادته نفس الاستعلام المباشر كان موسومًا بـ PLTR وAMAT وTTD وZBRA وCOHR وDVA بكل هذه الحقول. مرجع الحقول الكامل في الوثائق.
تنبيه اقتصادي كلي
التنبيه الذي تستمر مكاتب الماكرو في بنائه يدويًا
التنبيه على الأحداث الماكرو هو النمط الذي يبنيه مستخدمو finlight المدفوعون مرارًا وتكرارًا، بشكل مستقل وشبه متطابق: سلسلة OR تشمل Fed وFOMC وCPI وPPI والرواتب والناتج المحلي الإجمالي والتضخم ومصطلحات التعريفات، مُصفّاة إلى أخبار الاقتصاد. تتقارب الفرق على نفس المعايير دون أن ترى استعلامات بعضها البعض. توفر هذه الصفحة نقطة انطلاق لهذا النمط بدلاً من مربع استعلام فارغ:
{
"name": "Macro news alert",
"query": "\"federal reserve\" OR FOMC OR CPI OR inflation",
"categories": ["economy"],
"url": "https://your-endpoint.example.com/macro-news"
}عند تطابق مقال، يصل هذا الطلب POST إلى نقطة النهاية الخاصة بك. أشكال الترويسات والجسم أدناه من عملية تسليم حقيقية تم التقاطها:
POST /macro-news HTTP/1.1
Content-Type: application/json
X-Webhook-Signature: sha256=01c4d3b9...913527fd
X-Webhook-Timestamp: 2026-08-08T20:40:58.736Z{
"link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
"source": "apnews.com",
"title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
"images": ["..."],
"summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
"language": "en",
"publishDate": "2026-08-08T14:10:06.000Z",
"createdAt": "2026-08-08T14:11:52.000Z",
"categories": ["business", "economy", "markets"],
"sentiment": "negative",
"confidence": 0.7371397614479065,
"countries": ["US"],
"content": "...",
"isUpdate": false,
"revisedDate": "2026-08-08T14:10:06.000Z"
}البيانات مختصرة: تم تقصير images وcontent. كل عملية تسليم موقّعة بـ HMAC-SHA256 (X-Webhook-Signature) وتحمل طابعًا زمنيًا للتسليم؛ عمليات التسليم الفاشلة تُعاد تلقائيًا بتراجع أُسّي. الـwebhooks متاحة في الخطط التي تتضمنها؛ راجع الأسعار.
استعلام واحد، ثلاثة مسارات تسليم.
نفس الاستعلام يشغّل الطرق الثلاث جميعها: نقطة REST للبحث والتعبئة الرجعية، وتدفق WebSocket للاتصال الدائم، وwebhooks للدفع إلى أي نظام تستخدمه بالفعل. عرّف تغذية الأخبار المالية مرة واحدة، واستهلكها أينما احتاج نظامك. إذا كان المستهلك نظام تداول يتفاعل مع عناوين اقتصادية كلية، فإن صفحة أنظمة التداول تغطي إعداد التدفق المزدوج المصمم لذلك.
كود جاهز للنسخ والتشغيل
الاستعلام الاقتصادي الكلي، قابل للتشغيل
نفس سلسلة OR مقابل REST API. الناقص فقط هو مفتاح API.
import { FinlightApi } from 'finlight-client'
const api = new FinlightApi({ apiKey: 'YOUR_API_KEY' })
const res = await api.articles.fetchArticles({
query: '"federal reserve" OR FOMC OR CPI OR inflation',
categories: ['economy'],
includeEntities: true,
pageSize: 20,
})
for (const a of res.articles) {
console.log(a.publishDate, a.sentiment, a.confidence, a.title)
}from finlight_client import FinlightApi
from finlight_client.models import ApiConfig, GetArticlesParams
api = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))
res = api.articles.fetch_articles(
params=GetArticlesParams(
query='"federal reserve" OR FOMC OR CPI OR inflation',
categories=["economy"],
include_entities=True,
page_size=20,
)
)
for a in res["articles"]:
print(a["publishDate"], a["sentiment"], a["confidence"], a["title"])ثبّت باستخدام npm install finlight-client أو pip install finlight-client. لغة الاستعلام تدعم المنطق المنطقي والعبارات الدقيقة وفلاتر الحقول، لذا يمكن للسلسلة أن تمتد كما فعلت تلك الفرق: أضف مصطلحات البنك المركزي الأوروبي أو بنك اليابان أو الرواتب أو الناتج المحلي الإجمالي أو التعريفات حسب حاجة فريقك. للمعايير الأقرب إلى التعريفات والعقوبات، راجع واجهة الأخبار الجيوسياسية. مرجع الاستعلام الكامل في الوثائق، ونظرة عامة على المنتج في News API.
ما لا تقدمه finlight
finlight ليست تقويمًا اقتصاديًا: فهي لا توفر قيم المؤشرات أو أرقام الإجماع أو التوقعات أو مواعيد الإصدار. المجموعة المعتادة من الأدوات تجمع بين موقع مجاني لمواعيد الإصدار (Forex Factory وTrading Economics) وواجهة أخبار عامة أو استخلاص RSS يدوي، ثم تُركّب تنبيهات اقتصادية كلية من الاثنين معًا. تستبدل finlight النصف الثاني من هذه المجموعة: مراقبة رويترز وAP وCNBC وYahoo Finance وthe Guardian وأكثر من 100 مصدر آخر بحثًا عن عناوين الاحتياطي الفيدرالي ومؤشر أسعار المستهلك والتضخم وقرارات الفائدة، وتصفيتها حسب الفئة والكلمة المفتاحية، وربط النتيجة بتنبيه. إذا كانت قيم المؤشرات وتوقيت الإصدار هي ما تحتاجه، فاستخدم منتج بيانات لهذا النصف. أما إذا كان نصف الأخبار هو الجزء الذي ما زلت تُعيد بناءه، فهذا هو الجزء الذي تستبدله هذه الواجهة.
الأسئلة الشائعة
واجهة الأخبار الاقتصادية: الأسئلة الشائعة
كل ما يسأل عنه المطورون قبل إعداد تنبيه أخبار اقتصادي كلي.
توجد خطة مجانية للتجربة، وتبدأ الخطط المدفوعة من 29 دولارًا شهريًا. تختلف الخطط في حجم الطلبات والوصول الفوري والـwebhooks والبيانات التاريخية. الأسعار والحدود الحالية موجودة في صفحة الأسعار.
هل لا تزال لديك أسئلة؟
فريق الدعم المتخصص بالمطورين هنا لمساعدتك في التكامل والتوسع.
أنشئ التنبيه قبل الإصدار القادم
الرقم القادم لمؤشر أسعار المستهلك أو تقرير الوظائف أو قرار الفائدة مجدول بالفعل؛ يجب أن يكون تنبيهك جاهزًا قبل صدوره. احصل على مفتاح، أنشئ التنبيه الاقتصادي الكلي أعلاه، واحكم على التغذية بإصدار حقيقي بدلاً من عرض توضيحي.