پشتیبانی & FAQ
پاسخ سوالات متداول را بیابید یا با تیم ما در ارتباط باشید.
تماس با پشتیبانی
برای صورت‌حساب، ورود، یکپارچه‌سازی API یا هر سوال دیگر، مستقیماً به ما ایمیل بزنید. ما معمولاً ظرف 1 روز کاری پاسخ می‌دهیم.
برای تعهدات سطح خدمات، مشاهده کنید پشتیبانی SLA.
تمامی استعلامات از طریق یک اینباکس مدیریت میشوند: info@fxmacrodata.com.
دریافت پشتیبانی
یک ایمیل تریاژ سریع‌تر بنویسید
نقطه انتهایی و زمینه درخواست را قرار دهید تا بتوانیم مشکلات را سریع‌تر تشخیص دهیم.
وضعیت
سلامت پلتفرم
برای خط زمانی حوادث و به‌روزرسانی‌های سطح مؤلفه، فید خارجی را ببینید: fxmacrodata.statuspage.io.
برترین لینک‌های راهنما
سریع‌تر از بن‌بست خارج شوید
نقاط انتهایی محبوب
شروع با فراخوان‌های API با سیگنال بالا
هر کارت، قصد ویژگی را به یک خانواده نقطه پایانی (endpoint) مشخص و نقطه ورود مستندات متصل میکند.
اعلامیه‌ها
/api/v1/announcements/{currency}/{indicator}
مقادیر انتشار نقطه-به-زمان با برچسب‌های زمانی اعلان.
تقویم انتشار
/api/v1/calendar/{currency}
اعلانهای کلان پیش‌رو به تفکیک ارز و شاخص.
فارکس
/api/v1/forex/{base}/{quote}
نرخ‌های اسپات تاریخی با لایه‌های فنی اختیاری.
نرخ‌ها & منحنی‌ها
/api/v1/rate_differentials/{base}/{quote}
اسپرد‌های Carry، اسنپ‌شات‌های منحنی، پروکسی‌های شیب و بخش‌های فوروارد مشتق شده.
COT
/api/v1/cot/{currency}
موقعیت‌های هفتگی غیرتجاری از گزارش‌های CFTC.
کالاها
/api/v1/commodities/{indicator}
سریهای کالا و فلزات مورد استفاده در تحلیل رژیم کلان.
جلسات بازار
/api/v1/market_sessions
وضعیت باز/بسته فعلی برای پنجره‌های نشست اصلی FX.
سوالات متداول
دادهها & پوشش
دادهها تا چه حد در لحظه (real-time) هستند؟
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 می‌پذیریم.
تکنیکال & یکپارچه‌سازی
آیا از زبان‌های برنامه‌نویسی دیگر پشتیبانی می‌کنید؟
بله. SDK رسمی Python از طریق در دسترس است pip install fxmacrodata، و REST API با هر زبانی کار میکند — Go, R, Java, C#, MATLAB, Rust و موارد دیگر. مشاهده کنید راهنمای‌های شروع سریع برای مثال‌ها.
آیا سرور MCP برای دستیارهای AI وجود دارد؟
بله. FXMacroData از Model Context Protocol (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 یا چارچوب‌های backtesting استفاده کنم؟
بله. تمام پاسخ‌های 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 را بررسی کنید: اولین مقدار ثبت شده لزوماً توسط ناشر'اولین چاپِ s، و تاریخچه بازبینی کامل برای هر سری در دسترس نیست.
داده‌های تاریخی تا چه زمانی به عقب برمی‌گردند؟
عمق تاریخی بسته به شاخص و منبع بانک مرکزی متفاوت است. اکثر شاخص‌های اصلی (CPI، GDP، نرخ سیاست پولی، بیکاری) حداقل 10 سال را پوشش می‌دهند. بازده اوراق قرضه و برخی شاخص‌های ثانویه تاریخچه‌های کوتاه‌تری دارند. مشاهده کنید کاتالوگ اندیکاتورها برای جزئیات پوشش هر معیار.
آیا میتوانم دادهها را در نشریات پژوهشی یا محصولات بازتوزیع کنم؟
حقوق بازنشر به طرح شما بستگی دارد. طرح‌های Individual و Enterprise استفاده داخلی خودتان را پوشش می‌دهند. بازنشر تجاری، افزونه خودخدمتی برای نمایش خوانا برای انسان با ارجاع است. پس از دوره آزمایشی، هزینه آن USD 10 به ازای هر بلوک مخاطب در ماه است، که با یک بلوک صرف‌نظر از اندازه مخاطبان شما شروع میشود. یک بلوک تا 100 کاربر یا گیرنده اندازه‌گیری شده، یا تا 1,000 دنبال‌کننده اعلام‌شده در یک فید اجتماعی یا پخش عمومی را پوشش می‌دهد، و هر سطح ثبت‌شده، بلوک‌هایی را به یک مقدار در سطح حساب اضافه میکند. انتقال خام API، فایل‌های انبوه، فیدهای داده و فروش مجدد در بازار حذف شده است. هیچ فرآیند درخواست، استعلام، صف تأیید یا زمان انتظار وجود ندارد. مشاهده کنید شرایط خدمات برای جزئیات کامل.
نیاز به کمک
هنوز سوالاتی دارید؟
اگر مستندات یا سوالات متداول مورد استفاده شما را پوشش نمی‌دهند، با ما تماس بگیرید و مسیر نقطه انتهایی، محدوده تاریخی و برچسب زمانی درخواست را ذکر کنید.
چرا تیم‌ها به آن اعتماد می‌کنند
منابع رسمی
مقادیر منتشر شده از ناشران رسمی، بانکهای مرکزی و دفاتر آمار می‌آیند.
برچسب‌های زمانی انتشار
ردیف‌های اعلامیه، برچسب‌های زمانی انتشار UTC را برای مطالعات رویداد، داشبوردها، کارهای پژوهشی و سیستم‌های زنده حفظ می‌کنند.
دهه‌ها تاریخچه
رکوردهای نقطه-به-زمان نشان می‌دهند که در هر تاریخ چه چیزی شناخته شده بود، بنابراین بک‌تست‌ها از اطلاعات آینده استفاده نمی‌کنند.