نقطة نهاية تقويم إصدار FXMacroData تعمل الآن. في مكالمة واحدة يمكنك استرداد الطوابع الزمنية للإصدار المقبل لعملة، وتصفية إلى مؤشر واحد عند الحاجة، وتحديد مواعيد استردادات الإعلانات المتابعة مقابل الثانية المنشورة الدقيقة.
ما الجديد
مسار الإصدارات الإنتاجية هو /api/v1/calendar/{currency}، مع اختيار ?indicator=... بدلا من الاحتفاظ يدوياً بجدول الزمام للبنك المركزي ومكتب الإحصاءات، يمكنك استفسار نقطة نهاية إنتاج واحدة وتلقي صفوف الإصدار مرتبة حسب الوقت.
كل صف مبني حول مجالين أساسيين:
- الإفراج - المؤشر القانوني المستخدم من قبل نقطة النهاية الإعلانات، مثل
inflation- لاpolicy_rate- لاunemploymentأوnon_farm_payrolls - الإعلان_تاريخ/وقت - طابع وقت نشر UTC المستخدم في جدولة ودراسات الأحداث
بعض الجداول المختلطة المجال تشمل أيضا بيانات إضافية التوجيه مثل endpoint_family- لا endpoint_path- لا titleو schedule_status. تساعد هذه الحقول العملاء في توجيه الطلب التالي، ولكن سير العمل التوقيت لا يزال يبدأ مع release بالإضافة announcement_datetime.
لماذا يهم ذلك؟
لا تصل الإصدارات الكبرى على فترات منتظمة تمامًا. تنشر البنوك المركزية تقويمات الاجتماعات مسبقًا جدًا ، في حين أن إصداراته من مؤشر أسعار المستهلك والناتج المحلي الإجمالي والعمل والتجارة يمكن أن تتحرك من شهر إلى آخر. إذا كنت تقوم بإجراء استطلاع كل خمس دقائق ، فإما أن تضيع الطلبات أو تقبل تأخيرًا يمكن تجنبه.
جدولة دقيقة
استفسار التقويم مرة واحدة، والنوم حتى قبل وقت قريب من الطابع الزمني التالي، ثم اضغط على الإعلانات المقابلة نقطة النهاية بالضبط عندما يجب أن تكون البيانات الجديدة متاحة.
توجيه سير العمل النظيف
لأن التقويم يعيد نفس خفاش الإصدار المستخدم من قبل نقطة النهاية الإعلانات، يمكنك الانتقال مباشرة من توقيت لاسترداد البيانات دون الحفاظ على طبقة رسم خريطة منفصلة.
مثال عملي: تخطيط سعر الفائدة السياسية للدولار الأسترالي
لنفترض أنك تهتم فقط بالقرار القادم لبنك الاحتياطي الوطني policy_rate - لا ، لا ، ليس كذلك
curl "https://fxmacrodata.com/api/v1/calendar/aud?indicator=policy_rate&api_key=YOUR_API_KEY"
ردّ ممثل:
{
"currency": "AUD",
"indicator": "policy_rate",
"data": [
{
"announcement_datetime": 1773077400,
"release": "policy_rate"
}
]
}
هذا يخبر المخطط متى تستيقظ وتتصل نقطة النهاية لإعلان سعر الفائدة السياسية للدولار الأستراليالتقويم يخبرك متى الحدث التالي يصل ، نقطة نهاية الإعلانات تخبرك ماذا ؟ طبعت بمجرد هبوطها
مثال عملي: مسح الأسبوع الأمريكي
إذا كنت تريد جدول العملات الأوسع ، فاستفسر من العملة دون مرشح مؤشر واستعرض الإصدارات القادمة بترتيب زمني.
curl "https://fxmacrodata.com/api/v1/calendar/usd"
ردّ ممثل:
{
"currency": "USD",
"indicator": null,
"data": [
{
"announcement_datetime": 1773077400,
"release": "inflation"
},
{
"announcement_datetime": 1773682200,
"release": "non_farm_payrolls"
}
]
}
هذا يكفي لبناء نوافذ مخاطر ما قبل الإصدار، قمع نموذج خلال الأحداث الكبرى المعروفة، أو انتظار المتابعة للحصول على التضخم بالدولار و الرواتب غير الزراعية بالدولار نقطة النهاية عندما تصل تلك الطوابع الزمنية.
كيف يتناسب مع نهاية الإعلانات
تقويم الإصدارات ضيق عمداً: يخبرك أي إصدار هو التالي ومتى هو مقرّر. /api/v1/announcements/{currency}/{indicator} لتحصل على سلسلة تاريخية صدرت وقراءة آخر صف في العودة data المجموعة
هذا التقسيم يبقي منطق الجدول نظيفاً. يمكنك استفسار التقويم عن التوقيت، ثم استفسar the announcements endpoint for values and announcement history.
ابدأ
الوصول إلى تقويم الدولار الأمريكي عام. تتطلب العملات الأخرى المدعومة مفتاح API. ابدأ باستخدام مكالمة اختبار مجانية بالدولار الأمريكى، ثم انتقل إلى سير العملات الموثوق بها بمجرد توصيل المخطط.
الخطوات الأولى
- اجعل مكالمة تجريبية مجانية
curl "https://fxmacrodata.com/api/v1/calendar/usd" - إبحث عن إعلانات مركز توثيق واجهة برمجة التطبيقات
- بناء جهاز إلتقاط محرك الأحداث مع دليل الجدول الزمني