الدعم & FAQ
ابحث عن إجابات للأسئلة الشائعة، أو تواصل مع فريقنا.
الاتصال بالدعم
للفواتير، أو التهيئة، أو تكامل API، أو أي سؤال آخر، راسلنا مباشرة عبر البريد الإلكتروني. عادة ما نرد في غضون 1 يوم عمل.
بالنسبة لالتزامات مستوى الخدمة، راجع دعم SLA.
يتم التعامل مع جميع الاستفسارات من خلال صندوق وارد واحد: info@fxmacrodata.com.
استلام الدعم
صياغة بريد إلكتروني أسرع للفرز
قم بتضمين نقطة النهاية وسياق الطلب حتى نتمكن من تشخيص المشكلات بشكل أسرع.
الحالة
صحة المنصة
للحصول على الجداول الزمنية للحوادث وتحديثات مستوى المكونات، راجع التغذية الخارجية: fxmacrodata.statuspage.io.
أهم روابط المساعدة
تجاوز العقبات بشكل أسرع
نقاط النهاية الشائعة
ابدأ مع مكالمات API عالية الإشارة
تقوم كل بطاقة بربط نية الميزة بعائلة نقاط نهاية محددة ونقطة دخول المستندات.
إعلانات
/api/v1/announcements/{currency}/{indicator}
قيم إصدار نقطة زمنية محددة مع طوابع زمنية للإعلان.
تقويم الإصدارات
/api/v1/calendar/{currency}
الإعلانات الكلية القادمة حسب العملة والمؤشر.
فوركس
/api/v1/forex/{base}/{quote}
أسعار الصرف الفورية التاريخية مع تراكبات تقنية اختيارية.
الأسعار & المنحنيات
/api/v1/rate_differentials/{base}/{quote}
فروق العائد (Carry spreads)، لقطات المنحنى، بدائل الميل، وأجزاء الآجل المشتقة.
COT
/api/v1/cot/{currency}
تمركز غير تجاري أسبوعي من تقارير CFTC.
السلع الأساسية
/api/v1/commodities/{indicator}
سلسلة السلع والمعادن المستخدمة في تحليل النظام الاقتصادي الكلي.
جلسات السوق
/api/v1/market_sessions
الحالة الحالية للفتح/الإغلاق لنوافذ جلسات FX الرئيسية.
الأسئلة الشائعة
البيانات & التغطية
ما مدى حداثة البيانات في الوقت الفعلي؟
يقوم FXMacroData بمراقبة الإصدارات الرسمية المدعومة وتسجيل أدلة النشر والجمع حيثما توفرت. تختلف تغطية التوقيت حسب المصدر والإصدار؛ يحدد publication_time_status أوقات النشر المؤكدة، وغير المتحقق منها، والتاريخية المقدرة، وغير المعروفة.
ما هي مصادر البيانات المشمولة؟
تأتي الإصدارات الاقتصادية الكلية من الناشرين الأصليين، بما في ذلك وكالات الإحصاء الوطنية، والدوائر الحكومية، والبنوك المركزية مثل ECB و RBA. راجع كل سلسلة' بيانات المصدر الوصفية لمعرفة الناشر والمقياس الأساسي.
هل يمكنني الوصول إلى البيانات التاريخية؟
نعم. تتوفر البيانات التاريخية الكاملة مع اشتراك فردي أو أعمال أو مؤسسة. يمكن للمستخدمين غير المشتركين الوصول إلى نقاط نهاية السلاسل الزمنية المجانية لأحدث 90 أيام، بعد 15 دقيقة من نشر كل إصدار.
ما هي نقاط النهاية المجانية مقابل المدفوعة؟
بدون مفتاح API، وبدون حساب أو تاريخ انتهاء، يمكنك استخدام بيانات إعلانات USD لأحدث 90 أيام (كل إصدار 15 دقيقة بعد النشر)، وتقويم إصدارات USD، وكتالوج البيانات، وجلسات السوق، والبيانات الصحفية الرسمية لـ USD، وتموضع USD COT، بما يصل إلى 100 طلبات في اليوم. تتطلب قيم التوقعات (بما في ذلك USD)، والإصدارات في الوقت الفعلي، والسجل الكامل، والبيانات غير USD، وأسعار FX، والسلع مفتاح API من خطة فردية أو أعمال أو مؤسسة.
كم عدد العملات المدعومة؟
تغطي المنصة 22 عملات بشكل عام، مع نشر الإعلانات العامة وتغطية الكتالوج حالياً لـ 22 عملات وتغطية تقويم الإصدارات المنشورة لـ 20. راجع الوثائق لتفاصيل تغطية كل نقطة نهاية.
الفوترة & الاشتراك
هل تتطلب الفترة التجريبية المجانية بطاقة ائتمان؟
نعم. تتطلب التجربة لمدة 14 يومًا بطاقة ائتمان صالحة عند التسجيل. لن يتم تحصيل أي رسوم منك حتى انتهاء التجربة.
هل يمكنني الإلغاء في أي وقت؟
نعم، يمكنك الإلغاء من إعدادات اشتراكك قبل دورة الفوترة التالية. دون طرح أي أسئلة.
ماذا يحدث عندما تنتهي التجربة المجانية؟
يتحول اشتراكك تلقائياً إلى الخطة المدفوعة ما لم يتم إلغاؤه قبل نهاية الفترة التجريبية. يمكنك إدارة ذلك في إعدادات الفواتير الخاصة بك.
ماذا لو فشلت طريقة الدفع الخاصة بي؟
إذا تعذر معالجة الدفع، فقد يتم تقييد الوصول إلى الحساب حتى يتم تحديث معلومات الفواتير. راجع شروط الفواتير للتفاصيل.
ما هي طرق الدفع المقبولة؟
نحن نقبل جميع بطاقات الائتمان الرئيسية (Visa, Mastercard, Amex) من خلال معالج الدفع الآمن Stripe الخاص بنا.
تقني & التكامل
هل تدعم لغات برمجة أخرى؟
نعم. مكتبة Python SDK الرسمية متاحة عبر pip install fxmacrodata، وتعمل REST API من أي لغة — Go, R, Java, C#, MATLAB, Rust, والمزيد. انظر أدلة البدء السريع لأمثلة.
هل يوجد خادم MCP لمساعدي AI؟
نعم. تدعم FXMacroData بروتوكول سياق النموذج (MCP)، مما يتيح لك ربط Claude و Cursor وأدوات AI الأخرى مباشرة ببياناتنا. راجع وثائق خادم MCP.
كيف أقوم بمصادقة طلبات API؟
أرسل مفتاح API الخاص بك في رأس الطلب: X-API-Key: YOUR_API_KEY. يتم قبول Authorization: Bearer أيضاً. استدعِ API من خادمك: فهو لا يرسل ترويسات CORS إلى المتصفحات. ابحث عن مفتاحك في لوحة إدارة API بعد الاشتراك.
ما هو الدعم المضمن في خطتي؟
تتضمن جميع الخطط المدفوعة دعماً عبر البريد الإلكتروني لأسئلة التكامل والبيانات. تضيف خطة الأعمال دعماً ذا أولوية، ويمكن أن تتضمن اتفاقيات المؤسسات خيارات SLA مخصصة. انظر أهداف استجابة الدعم.
Quant & الاختبار العكسي
هل نقطة البيانات في وقت محدد / خالية من تحيز الاستشراف؟
يعتمد إعادة التشغيل في نقطة زمنية معينة على الأدلة المحتفظ بها لكل إصدار قيمة. تحقق من announcement_datetime إلى جانب publication_time_status وpublication_time_precision وvintage_status. استخدم as_of مع availability=public أو availability=captured لتحديد القيم التاريخية المؤهلة، ثم افحص data_quality.point_in_time_safe. مرشح التاريخ وحده لا يزيل المراجعات اللاحقة، ولا يثبت الطابع الزمني للنشر أو الجمع متى كان بإمكان العميل قراءة القيمة عبر API.
هل يمكنني استخدام هذه البيانات مع pandas أو NumPy أو أطر الاختبار العكسي؟
نعم. تعيد جميع استجابات API بيانات JSON نظيفة تتحول مباشرة إلى pd.DataFrame. تستخدم announcement_datetime و generated_at ثواني Unix epoch؛ تستخدم حقول الوقت المحلي سلاسل ISO 8601 مع إزاحة. تحتوي حقول النانو ثانية أيضاً على متغيرات سلاسل عشرية للحفاظ على الدقة. استخدم pd.concat()لدمج السلاسل المتوافقة بعد التحقق من الوحدات وأدلة الطابع الزمني. يمكن لعمليات الربط المدركة للوقت استخدام merge_asof.
هل يتم تخزين قيم البيانات المنقحة بشكل منفصل عن الإصدارات الأولية؟
في حال الاحتفاظ بها، تظهر إصدارات القيمة في revisions[]. اطلب revisions=all لفحص السجل المتاح لملاحظة ما. لإعادة التشغيل، استخدم as_of مع revisions=latest لاختيار أحدث إصدار مؤهل عند نقطة القطع الخاصة بك. تحقق من vintage_status و is_first_release: القيمة الأولى الملتقطة ليست بالضرورة هي الناشر'أول طباعة لها، وتاريخ المراجعة الكامل غير متاح لكل سلسلة.
إلى أي مدى تعود البيانات التاريخية؟
يختلف العمق التاريخي حسب المؤشر ومصدر البنك المركزي. تغطي معظم المؤشرات الرئيسية (CPI، GDP، سعر السياسة، البطالة) ما لا يقل عن 10 سنة. تمتلك عوائد السندات وبعض المؤشرات الثانوية تواريخ أقصر. انظر كتالوج المؤشرات لتفاصيل تغطية كل مقياس.
هل يمكنني إعادة توزيع البيانات في المنشورات البحثية أو المنتجات؟
تعتمد حقوق إعادة التوزيع على خطتك. تغطي خطتا الفرد والمؤسسة استخدامك الداخلي الخاص. إعادة التوزيع التجاري هي إضافة خدمة ذاتية للعرض الموجه للعملاء والقابل للقراءة بشرياً مع ذكر المصدر. بعد التجربة، يتم احتساب التكلفة بـ USD 10 لكل كتلة جمهور شهرياً، بدءاً من كتلة واحدة بغض النظر عن حجم جمهورك. تغطي الكتلة الواحدة ما يصل إلى 100 من المستخدمين أو المستلمين المقاسين، أو ما يصل إلى 1,000 من المتابعين المعلنين على موجز اجتماعي عام أو موجز بث، وتساهم كل واجهة مسجلة بكتل في كمية واحدة على مستوى الحساب. يُستثنى من ذلك تمرير API الخام، والملفات الضخمة، وخلاصات البيانات، وإعادة البيع في السوق. لا يوجد طلب تقديم، أو عرض سعر، أو قائمة انتظار للموافقة، أو مهلة زمنية. انظر شروط الخدمة للحصول على التفاصيل الكاملة.
هل تحتاج إلى مساعدة
لا تزال لديك أسئلة؟
إذا كانت الوثائق أو الأسئلة الشائعة لا تغطي حالة الاستخدام الخاصة بك، فاتصل بنا وتضمن مسار نقطة النهاية، والنطاق الزمني، والطابع الزمني للطلب.
لماذا تثق به الفرق
المصادر الرسمية
تأتي قيم الإصدار من الناشرين الرسميين، والبنوك المركزية، ومكاتب الإحصاء.
دليل النشر
فحص حالة النشر، والجداول المؤكدة، وتوافر قاعدة البيانات لمراقبة الإصدار ودراسات الأحداث.
التاريخ حسب السلسلة
استكشف التاريخ الاقتصادي المتاح، ثم تحقق من المراجعات المحتفظ بها وأدلة النشر بشكل منفصل قبل إجراء اختبار رجعي.