الدعم & 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 على طوابع النشر الرسمية بمجرد قيام المصدر الرسمي بنشر البيانات.
ما هي مصادر البيانات المشمولة؟
تقوم FXMacroData بالتجميع من FRED (Federal Reserve) و ECB و RBA وغيرها من البنوك المركزية الكبرى في جميع أنحاء العالم.
هل يمكنني الوصول إلى البيانات التاريخية؟
Yes. Full historical data is available with an Individual or Enterprise subscription. Non-subscribed users can access freemium time-series endpoints for the most recent 90 days, 15 minutes after each release is published.
ما هي نقاط النهاية المجانية مقابل المدفوعة؟
Calendar, data catalogue, and market sessions are public. Freemium time-series endpoints (USD announcements and USD predictions) are limited to the most recent 90 days for non-subscribed users and are delivered 15 minutes after publication. Real-time releases, full history, non-USD announcements, COT, and commodities require an API key from an Individual or Enterprise plan.
كم عدد العملات المدعومة؟
The platform covers 22 currencies overall, with public announcements and catalogue coverage currently published for 22 currencies and release-calendar coverage published for 20. See the الوثائق لتفاصيل تغطية كل نقطة نهاية.
الفوترة & الاشتراك
هل تتطلب الفترة التجريبية المجانية بطاقة ائتمان؟
نعم. تتطلب التجربة لمدة 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 الخاص بك كمعلمة استعلام: ?api_key=YOUR_API_KEY. ابحث عن مفتاحك في لوحة تحكم إدارة API بعد الاشتراك.
ما هو الدعم المضمن في خطتي؟
تتضمن جميع الخطط المدفوعة دعماً عبر البريد الإلكتروني لأسئلة التكامل والبيانات. تضيف خطط المؤسسات دعماً ذا أولوية وخيارات SLA مخصصة. انظر أهداف استجابة الدعم.
Quant & الاختبار العكسي
هل نقطة البيانات في وقت محدد / خالية من تحيز الاستشراف؟
نعم. يتضمن كل إصدار announcement_datetime الحقل — الوقت الفعلي الذي تم فيه نشر البيانات للجمهور، وليس فقط الفترة المرجعية (على سبيل المثال. "Q3 2024"). عندما تقوم بتقسيم مجموعة بياناتك التاريخية إلى تاريخ معين، فسترى فقط الإصدارات التي تم نشرها حتى تلك اللحظة، مما يطابق ظروف التداول المباشرة.
هل يمكنني استخدام هذه البيانات مع pandas أو NumPy أو أطر الاختبار العكسي؟
نعم. تعيد جميع استجابات API بيانات JSON نظيفة تتحول مباشرة إلى pd.DataFrame. حقول الطابع الزمني هي سلاسل ISO 8601. المخطط المتسق عبر جميع العملات المدعومة يعني أنه يمكنك pd.concat()أطر بيانات (DataFrames) متعددة العملات دون إعادة تنسيق. تعمل مع vectorbt و backtrader وخطوط سير دراسة الأحداث المخصصة عبر merge_asof.
هل يتم تخزين قيم البيانات المنقحة بشكل منفصل عن الإصدارات الأولية؟
يعكس كل سجل القيمة كما نُشرت عند announcement_datetime. يتم تسجيل المراجعات كإصدارات منفصلة مع طوابعها الزمنية الخاصة، بحيث يمكنك إعادة بناء ما كان معروفًا في أي نقطة تاريخية دون خلط مراجعات البيانات اللاحقة.
إلى أي مدى تعود البيانات التاريخية؟
يختلف العمق التاريخي حسب المؤشر ومصدر البنك المركزي. تغطي معظم المؤشرات الرئيسية (CPI، GDP، سعر السياسة، البطالة) ما لا يقل عن 10 سنة. تمتلك عوائد السندات وبعض المؤشرات الثانوية تواريخ أقصر. انظر كتالوج المؤشرات لتفاصيل تغطية كل مقياس.
هل يمكنني إعادة توزيع البيانات في المنشورات البحثية أو المنتجات؟
تعتمد حقوق إعادة التوزيع على خطتك. تغطي خطتا الفرد والمؤسسة استخدامك الداخلي الخاص. إعادة التوزيع التجاري هي إضافة خدمة ذاتية للعرض الموجه للعملاء والقابل للقراءة بشرياً مع ذكر المصدر. بعد التجربة، يتم احتساب التكلفة بـ USD 10 لكل كتلة جمهور شهرياً، بدءاً من كتلة واحدة بغض النظر عن حجم جمهورك. تغطي الكتلة الواحدة ما يصل إلى 100 من المستخدمين أو المستلمين المقاسين، أو ما يصل إلى 1,000 من المتابعين المعلنين على موجز اجتماعي عام أو موجز بث، وتساهم كل واجهة مسجلة بكتل في كمية واحدة على مستوى الحساب. يُستثنى من ذلك تمرير API الخام، والملفات الضخمة، وخلاصات البيانات، وإعادة البيع في السوق. لا يوجد طلب تقديم، أو عرض سعر، أو قائمة انتظار للموافقة، أو مهلة زمنية. انظر شروط الخدمة للحصول على التفاصيل الكاملة.
هل تحتاج إلى مساعدة
لا تزال لديك أسئلة؟
إذا كانت الوثائق أو الأسئلة الشائعة لا تغطي حالة الاستخدام الخاصة بك، فاتصل بنا وتضمن مسار نقطة النهاية، والنطاق الزمني، والطابع الزمني للطلب.
لماذا تثق به الفرق
المصادر الرسمية
تأتي قيم الإصدار من الناشرين الرسميين، والبنوك المركزية، ومكاتب الإحصاء.
الطوابع الزمنية للإصدار
تحافظ صفوف الإعلانات على الطوابع الزمنية لإصدار UTC لدراسات الأحداث، ولوحات المعلومات، ومهام البحث، والأنظمة المباشرة.
عقود من التاريخ
تظهر سجلات نقطة زمنية محددة ما كان معروفًا في كل تاريخ، بحيث لا تستعير الاختبارات الرجعية معلومات مستقبلية.