بحلول نهاية هذا الدليل سوف تكون قادرة على المصادقة بشكل صحيح، واختيار عائلة نقطة نهاية الصحيحة لكل مهمة، وجعل الطلبات جاهزة للإنتاج عبر FXMacroData API دون تخمين هيكل الطريق أو تغطية المؤشر.
الشروط المسبقة
- حساب FXMacroData ومفتاح API لطلبات غير الدولار الأمريكي
- محطة مع
curlأو وقت تشغيل مثل بايثون/Node.js - معرفة أساسية بردود JSON ومتطلبات URL
- الوصول إلى الوثائق المباشرة / الوثائق /
الخطوة 1 - ابدأ مع عنوان URL قاعدة الإنتاج
يجب أن تبدأ جميع الأمثلة العامة من قاعدة API الإنتاج:
https://fxmacrodata.com/api/v1عائلات النقاط النهائية التي ستستخدمها هي:
/announcements/{currency}/{indicator}للقيم التاريخية المعلنة بدقةannouncement_datetime/calendar/{currency}لختم وقت الإصدار القادم/catalogue/{currency}لتحديد مؤشرات مدعومة/cot/{currency}في حالة التزام المتداولين/commodities/{indicator}بالنسبة لسلسلة السلع والطاقة/forex/{pair}و/market-sessionsفي سياق السوق
الخطوة 2 - التحقق من صحة معمائل الاستفسار
تستخدم FXMacroData مصادقة معايير الاستعلام في أمثلة الاستخدام العام:
?api_key=YOUR_API_KEYيتوفر الوصول إلى نقطة نهاية USD دون مفتاح، في حين أن الطرق غير USD تتطلب مفتاحا صالحا.
# USD endpoint (no key required)
curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"
# Non-USD endpoint (key required)
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"الخطوة 3 - اكتشف ما هو متاح قبل الترميز
استدعاء مسار الكتالوج أولاً عندما لا تكون متأكداً من المؤشرات الموجودة لعملة ما. وهذا يتجنب الافتراضات الصعبة.
curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"ثم استخدم مؤشر صفحة المؤشر في مؤشر مؤشر الوثائق لتأكيد مسارات المسار والحقول المتوقعة.
الخطوة 4 - سحب البيانات المنشورة من نقاط النهاية للإعلانات
نقاط الإعلان النهائية تعيد كائن من المستوى الأعلى بالإضافة إلى a data مجموعة من الإصدارات التاريخية. كل سطر يتضمن نهاية الفترة date، a valو ... announcement_datetime طابع الوقت
curl "https://fxmacrodata.com/api/v1/announcements/gbp/unemployment?api_key=YOUR_API_KEY"{
"currency": "GBP",
"indicator": "unemployment",
"has_official_forecast": false,
"start_date": "2025-01-31",
"end_date": "2026-03-31",
"data": [
{
"date": "2026-01-31",
"val": 4.39,
"announcement_datetime": 1770521400
}
]
}للحصول على دليلاً ووحدات مؤشر دقيقة، تحقق من صفحات النقطة النهائية مثل سعر سعر العملة الأمريكية و التضخم في اليورو.
الخطوة 5 - استخدام تقويم الإصدارات لتدفقات العمل القائمة على الأحداث
يساعدك تقويم الإصدارات على تحديد موعد الإصلاحات حول وقت النشر بدلاً من إجراء استطلاعات مستمرة.
curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"
نمط قوي هو: تقويم الاستفسار -> قراءة التالي announcement_datetime -> احضر مسار الإعلانات المتطابقة في وقت الإصدار.
الخطوة 6 - إضافة عائلات نقاط نهاية إضافية
بمجرد أن يكون تدفق الإعلانات الأساسي مستقرًا ، قم بتوسيع التغطية مع طرق محددة للمجال:
- كوت:
/api/v1/cot/{currency}بالنسبة لمناطق وضع العقود الآجلة - المعادن:
/api/v1/commodities/{indicator}للذهب والفضة والبلاتين والمدخلات الآمنة ذات الصلة - الفوركس:
/api/v1/forex/{pair}للتوفيق الفوري مع الإصدارات الكبرى - جلسات السوق:
/api/v1/market-sessionsللاتصال بالبريد الآلي
curl "https://fxmacrodata.com/api/v1/cot/usd"
curl "https://fxmacrodata.com/api/v1/commodities/gold"
curl "https://fxmacrodata.com/api/v1/forex/eurusd"
curl "https://fxmacrodata.com/api/v1/market-sessions"الخطوة 7 - مثال بايثون من نهاية إلى نهاية
المقطع أدناه يختبر التوافر، ويستعيد سلسلة مؤشرات واحدة، ويرد أحدث طباعة.
import requests
BASE = "https://fxmacrodata.com/api/v1"
API_KEY = "YOUR_API_KEY"
def fetch_latest(currency: str, indicator: str, api_key: str | None = None) -> dict | None:
params = {}
if api_key:
params["api_key"] = api_key
catalogue = requests.get(f"{BASE}/catalogue/{currency}", params=params, timeout=10)
catalogue.raise_for_status()
endpoint = requests.get(
f"{BASE}/announcements/{currency}/{indicator}",
params=params,
timeout=10,
)
endpoint.raise_for_status()
rows = endpoint.json().get("data", [])
return rows[-1] if rows else None
latest = fetch_latest("aud", "policy_rate", API_KEY)
print(latest)
ما الذي يمكنك بناءه بعد ذلك
الآن لديك مسار كامل للتحقق من صحة الملف، واكتشاف التغطية، وطلب سلسلة الإصدارات التاريخية، وتوسيعها إلى التشغيل الآلي القائم على التقويم. الخطوة التالية الطبيعية هي ربط سير العمل هذا مع جدولة الإصلاح في كيفية استخدام واجهة برمجة برمجة التطبيقات (API) تقويم الإصدارات لذا فإن نظامك يتفاعل بالضبط عندما يتم نشر بيانات جديدة
