الدعم والأسئلة الشائعة
ابحث عن إجابات للأسئلة الشائعة، أو تواصل مع فريقنا.
اتصل بالدعم
للفواتير، الإعداد، تكامل API، أو أي سؤال آخر، راسلنا عبر البريد الإلكتروني مباشرة. عادةً ما نرد في غضون يوم عمل واحد.
للاطلاع على التزامات مستوى الخدمة، راجع اتفاقية مستوى خدمة الدعم.
All inquiries are handled through one inbox: [email protected].
Support intake
Compose a faster triage email
Include endpoint and request context so we can diagnose issues faster.
Status
Platform Health
For incident timelines and component-level updates, see the external feed: fxmacrodata.statuspage.io.
Top help links
Get unstuck faster
Popular endpoints
Start With High-Signal API Calls
Each card maps feature intent to a concrete endpoint family and docs entry point.
Announcements
/api/v1/announcements/{currency}/{indicator}
Point-in-time release values with announcement timestamps.
Release Calendar
/api/v1/calendar/{currency}
Upcoming macro announcements by currency and indicator.
Forex
/api/v1/forex/{base}/{quote}
Historical spot rates with optional technical overlays.
Rates & Curves
/api/v1/rate_differentials/{base}/{quote}
Carry spreads, curve snapshots, slope proxies, and derived forward segments.
COT
/api/v1/cot/{currency}
Weekly non-commercial positioning from CFTC reporting.
Commodities
/api/v1/commodities/{indicator}
Commodity and metals series used in macro regime analysis.
Market Sessions
/api/v1/market_sessions
Current open/close state for major FX session windows.
الأسئلة المتكررة
البيانات والتغطية
ما مدى فورية البيانات؟
يتم تسليم بيانات الإعلانات في الوقت الفعلي، في غضون 50 مللي ثانية من النشر الرسمي للبنك المركزي.
ما هي مصادر البيانات المضمنة؟
تجمع FXMacroData البيانات من FRED (Federal Reserve)، ECB، RBA، والبنوك المركزية الرئيسية الأخرى حول العالم.
هل يمكنني الوصول إلى البيانات التاريخية؟
نعم، يتم تضمين البيانات التاريخية الكاملة لجميع المقاييس المتاحة عبر العملات المدعومة.
ما هي نقاط النهاية المجانية مقابل المدفوعة؟
التقويم، كتالوج البيانات، الفوركس، وجلسات السوق عامة. إعلانات USD عامة، بينما تتطلب إعلانات غير USD مفتاح API احترافيًا. تتطلب COT والسلع دائمًا مفتاح API احترافيًا.
كم عدد العملات المدعومة؟
تغطي المنصة 18 عملة إجمالاً، مع إعلانات عامة وتغطية كتالوج منشورة حاليًا لـ 14 عملة وتغطية تقويم الإصدار منشورة لـ 18. راجع الوثائق للحصول على تفاصيل التغطية لكل نقطة نهاية.
الفواتير والاشتراك
هل تتطلب التجربة المجانية بطاقة ائتمان؟
نعم. تتطلب التجربة التي تستغرق 14 يومًا بطاقة ائتمان صالحة عند التسجيل. لن يتم تحصيل الرسوم منك حتى انتهاء التجربة.
هل يمكنني الإلغاء في أي وقت؟
نعم، يمكنك الإلغاء من إعدادات اشتراكك قبل دورة الفوترة التالية. بدون طرح أي أسئلة.
ماذا يحدث عند انتهاء التجربة المجانية؟
يتحول اشتراكك تلقائيًا إلى الخطة المدفوعة ما لم يتم إلغاؤه قبل انتهاء التجربة. يمكنك إدارة ذلك في إعدادات الفواتير الخاصة بك.
ماذا لو فشلت طريقة الدفع الخاصة بي؟
إذا تعذر معالجة الدفع، فقد يتم تقييد الوصول إلى الحساب حتى يتم تحديث معلومات الفواتير. راجع شروط الفوترة للتفاصيل.
ما هي طرق الدفع المقبولة؟
نحن نقبل جميع بطاقات الائتمان الرئيسية (Visa, Mastercard, Amex) عبر معالج الدفع الآمن Stripe الخاص بنا.
تقني وتكامل
هل تدعمون لغات برمجة أخرى؟
نعم. حزمة تطوير البرامج (SDK) الرسمية لـ Python متاحة عبر pip install fxmacrodata، وواجهة برمجة تطبيقات REST تعمل من أي لغة — Go, R, Java, C#, MATLAB, Rust، والمزيد. انظر أدلة البدء السريع للاطلاع على الأمثلة.
هل يوجد خادم MCP لمساعدي الذكاء الاصطناعي؟
نعم. تدعم FXMacroData بروتوكول سياق النموذج (MCP)، مما يتيح لك ربط Claude, Cursor، وأدوات الذكاء الاصطناعي الأخرى ببياناتنا مباشرةً. انظر وثائق خادم MCP.
كيف أقوم بمصادقة طلبات API؟
مرر مفتاح API الخاص بك كمعامل استعلام: ?api_key=YOUR_API_KEY. ابحث عن مفتاحك في لوحة تحكم إدارة API بعد الاشتراك.
ما هو الدعم المضمن في خطتي؟
تتضمن جميع الخطط المدفوعة دعمًا عبر البريد الإلكتروني لأسئلة التكامل والبيانات. تضيف خطط المؤسسات دعمًا ذا أولوية وخيارات اتفاقية مستوى الخدمة (SLA) المخصصة. انظر أهداف الاستجابة للدعم.
الكمي والاختبار الخلفي
هل البيانات نقطية زمنياً / خالية من تحيز التطلع المستقبلي؟
نعم. يتضمن كل إصدار announcement_datetime حقل — الوقت الفعلي الذي تم فيه نشر البيانات، وليس فقط الفترة المرجعية (مثل "الربع الثالث 2024"). عندما تقوم بتقسيم مجموعة بياناتك التاريخية إلى تاريخ معين، فإنك ترى فقط الإصدارات التي تم نشرها حتى تلك النقطة، مما يطابق ظروف التداول المباشر.
هل يمكنني استخدام هذه البيانات مع pandas, NumPy، أو أطر عمل الاختبار الخلفي؟
نعم. تعيد جميع استجابات API بيانات JSON نظيفة تتحول مباشرة إلى pd.DataFrame. حقول الطابع الزمني هي سلاسل ISO 8601. يعني المخطط المتسق عبر جميع العملات المدعومة أنه يمكنك pd.concat()DataFrames متعددة العملات دون إعادة تنسيق. يعمل مع vectorbt, backtrader، وخطوط أنابيب دراسة الأحداث المخصصة عبر merge_asof.
هل يتم تخزين قيم البيانات المعدلة بشكل منفصل عن الإصدارات الأولية؟
يعكس كل سجل القيمة كما نُشرت في announcement_datetime. يتم تسجيل المراجعات كإصدارات منفصلة بطوابع زمنية خاصة بها، بحيث يمكنك إعادة بناء ما كان معروفًا في أي نقطة تاريخية دون خلط مراجعات البيانات اللاحقة.
إلى أي مدى تعود البيانات التاريخية؟
يختلف العمق التاريخي حسب المؤشر ومصدر البنك المركزي. تغطي معظم المؤشرات الرئيسية (مؤشر أسعار المستهلك، الناتج المحلي الإجمالي، سعر الفائدة، البطالة) 10 سنوات على الأقل. عوائد السندات وبعض المؤشرات الثانوية لها تواريخ أقصر. انظر كتالوج المؤشرات لتفاصيل التغطية لكل مقياس.
هل يمكنني إعادة توزيع البيانات في المنشورات البحثية أو المنتجات؟
تعتمد حقوق إعادة التوزيع على خطتك. الخطة الفردية مخصصة للاستخدام الشخصي فقط. تتضمن خطط الشركات الناشئة والمؤسسات حقوق إعادة التوزيع للمواقع الإلكترونية ورسائل البريد الإلكتروني والمنشورات. لا يُسمح بإعادة توزيع API في أي خطة. انظر شروط الخدمة للاطلاع على التفاصيل الكاملة.
Need help
Still have questions?
If docs or FAQs do not cover your use case, contact us and include the endpoint path, date range, and request timestamp.
Why teams trust it
Official sources
Release values come from official publishers, central banks, and statistics offices.
Sub-second reporting
New announcements are packaged for alerts, dashboards, research jobs, and live systems as soon as they are reported.
Decades of history
Point-in-time records show what was known at each date, so backtests do not borrow future information.