Forex Developer API: موارد استفاده و مثال‌ها

All درباره Forex

APIهای Manager در MT4 و MT5 فناوری زیربنایی‌ای هستند که سیستم‌های Backoffice بروکر و Prop Firm را به لایه پلتفرم معاملاتی متصل می‌کنند. این APIها ارتباط برنامه‌نویسی دوطرفه با سرورهای MetaTrader را ممکن می‌سازند — از خواندن داده‌های حساب و اجرای اقدامات روی حساب گرفته تا فعال‌سازی رویدادها بر اساس فعالیت معاملاتی. برای توسعه‌دهندگانی که ابزارهای سفارشی کارگزاری یا Prop Firm می‌سازند، این APIها در بیشتر پروژه‌ها بیش از 50% از حجم توسعه را تشکیل می‌دهند.

این مقاله توضیح می‌دهد که APIهای JSON در MT4 و MT5 چه کارهایی می‌توانند انجام دهند، رایج‌ترین کاربردهایی که توسعه‌دهندگان بر پایه آن‌ها می‌سازند چیست، سرویس تکرار داده چگونه در کنار API JSON کار می‌کند، و چگونه به لایه API مربوط به Kenmore Design CRM و Trader’s Room متصل می‌شوند. مستندات فنی کامل در Forex Developer API در دسترس است.

API JSON در MT4 و MT5 چه کارهایی می‌تواند انجام دهد

API JSON امکان ارتباط دوطرفه با سرورهای معاملاتی MT4 و MT5 را فراهم می‌کند. توسعه‌دهندگان می‌توانند هم داده‌ها را از پلتفرم بخوانند و هم اقدامات را به‌صورت برنامه‌نویسی به آن برگردانند. قابلیت‌های اصلی شامل موارد زیر است:

  • ثبت حساب‌های معاملاتی جدید
  • فعال یا غیرفعال کردن حساب‌ها
  • به‌روزرسانی اطلاعات شخصی حساب
  • تغییر تخصیص گروه حساب
  • پردازش واریزها و برداشت‌ها
  • اجرای عملیات اعتبار
  • بازیابی داده‌های معامله‌گر و حساب
  • عملیات رمز عبور — به‌روزرسانی، بررسی، تأیید
  • بستن همه پوزیشن‌های باز یک حساب
  • باز کردن حساب‌ها در یک بازه عددی مشخص

دامنه عملیات نوشتن — نه فقط خواندن — همان چیزی است که API مدیر MT را به پایه و اساس اتوماسیون در سیستم‌های کارگزاری و Prop Firm تبدیل می‌کند. برنامه‌هایی که باید به رویدادهای معاملاتی در لحظه واکنش نشان دهند، قوانین را به‌صورت خودکار اجرا کنند، یا حساب‌ها را بدون دخالت دستی مدیریت کنند، همگی به این قابلیت نوشتن متکی هستند.

کاربردهای رایجی که توسعه‌دهندگان بر پایه API مدیر MT می‌سازند

سیستم‌های سفارشی بونوس و مشوق

منطق بونوسی که فراتر از بونوس‌های استاندارد واریز باشد، به دسترسی در سطح API به فعالیت معاملاتی نیاز دارد. پیاده‌سازی‌های رایج شامل رویدادهای اعتباری هستند که با حجم معاملات فعال می‌شوند — برای مثال، زمانی که یک معامله‌گر بیش از 20 لات را در یک بازه مشخص اجرا می‌کند، در پایان همان دوره به ازای هر لات $2 به حساب اعتبار داده می‌شود. همان فراخوانی‌های API که حساب را اعتبار می‌دهند، می‌توانند در صورت از بین رفتن شرایط، آن اعتبار را حذف کنند و ساختارهای مشوق پویا ایجاد کنند که به‌جای صرفاً مبلغ واریزی، به رفتار واقعی معامله‌گر واکنش نشان می‌دهند.

پیاده‌سازی‌های دیگر از تغییر گروه به‌عنوان مکانیزم زیربنایی استفاده می‌کنند — جابه‌جایی معامله‌گران با حجم بالا به گروه‌های با اجرای بهتر، یا انتقال حساب‌هایی که پارامترهای ریسک را نقض می‌کنند به گروه‌های محدودشده — که همگی به‌صورت خودکار و بدون دخالت دستی تیم عملیات انجام می‌شوند.

ابزارهای مدیریت ریسک

بسته‌های تجاری مدیریت ریسک برای کارگزاری‌ها گران هستند — اغلب بخش قابل‌توجهی از هزینه‌های عملیاتی ماهانه را تشکیل می‌دهند. برای بروکرها و Prop Firmهایی که منابع توسعه دارند، ساخت ابزارهای ریسک سفارشی بر پایه API مدیر MT یک جایگزین عملی است که قابلیت‌های مشخص را با کسری از هزینه ارائه می‌دهد.

پیاده‌سازی‌های رایج ریسک سفارشی شامل تغییر خودکار گروه MT در اثر رسیدن به آستانه‌های equity، شناسایی نقض drawdown همراه با غیرفعال‌سازی خودکار حساب یا بستن پوزیشن‌ها، پایش exposure در چندین حساب، و منطق مسیریابی B-book/A-book بر اساس الگوهای رفتار معامله‌گر است. برای Prop Firmها، پایش لحظه‌ای equity همراه با واکنش خودکار به نقض قوانین مهم‌ترین مورد استفاده عملیاتی است — وقتی یک معامله‌گر funded به حد drawdown می‌رسد، سیستم باید در همان جلسه معاملاتی فعلی واکنش نشان دهد، نه در بررسی دستی بعدی.

گزارش‌گیری و Business Intelligence

گزارش‌گیری یکی از بخش‌هایی است که در عملیات کارگزاری به‌طور مداوم کمتر از حد لازم توسعه یافته است. در بیش از 18 سال کار با بروکرهای forex، بازخورد ثابت همیشه یک چیز بوده است: هیچ‌وقت تعداد گزارش‌ها کافی نیست. هر کسب‌وکار پرسش‌های عملیاتی جدیدی پیدا می‌کند که مجموعه گزارش‌های موجود به آن‌ها پاسخ نمی‌دهد.

API مدیر MT داده‌ها را یا مستقیماً از طریق فراخوانی‌های API یا از طریق سرویس تکرار داده (که پایین‌تر پوشش داده شده است) به سیستم‌های گزارش‌گیری می‌فرستد. وقتی این داده‌ها به یک ابزار BI — Microsoft Power BI، Metabase، یا داشبوردهای سفارشی — متصل شوند، گزارش‌هایی درباره تاریخچه معاملات، عملکرد حساب، رفتار گروه، روندهای equity، و شاخص‌های عملیاتی ایجاد می‌کنند که از طریق رابط گزارش‌گیری بومی پلتفرم MT در دسترس نیستند.

یک پیاده‌سازی عملی: اگر یک معامله‌گر در یک بازه مشخص، زیان‌هایی بالاتر از یک آستانه تعریف‌شده ثبت کند، سیستم به‌صورت خودکار یک ارتباط هدفمند را فعال می‌کند — یک ایمیل یا SMS با پیشنهاد یک EA، یک money manager، یا یک دوره آموزشی. این نوع ارتباطِ فعال‌شده بر اساس رفتار، نیازمند خواندن داده‌های معاملاتی از MT و نوشتن اقدامات به لایه ارتباطی CRM است — دقیقاً همان یکپارچه‌سازی‌ای که API مدیر MT فراهم می‌کند.

اپلیکیشن‌های موبایل

برای کارگزاری‌ها و Prop Firmهایی که اپلیکیشن موبایل می‌سازند — داشبورد معامله‌گر، ابزارهای مدیریت حساب، و ردیاب‌های پیشرفت چالش — API مدیر MT لایه داده را فراهم می‌کند. موجودی حساب، پوزیشن‌های باز، تاریخچه معاملات، مقادیر equity و وضعیت drawdown همگی از طریق این API از سرور MT می‌آیند. در یک پروژه معمول توسعه اپ موبایل برای یک کارگزاری یا Prop Firm، یکپارچه‌سازی با API مدیر MT بیش از نیمی از تلاش کل توسعه را تشکیل می‌دهد.

وبهوک‌ها (که پایین‌تر پوشش داده شده‌اند) با فعال‌سازی اعلان‌های فوری، این مورد استفاده موبایلی را تکمیل می‌کنند — برای مثال، زمانی که معامله‌گران به نزدیکی margin call می‌رسند، وقتی آستانه drawdown رد می‌شود، یا وقتی ارزیابی یک چالش کامل می‌شود، هشدار دریافت می‌کنند.

Horizontal infographic showing Forex reports, API data, triggers, and apps workflow.

Backofficeهای سفارشی معامله‌گر و سیستم‌های مدیریت وظایف

برخی بروکرها — به‌ویژه آن‌هایی که تیم توسعه وب موجود دارند یا با شرکت‌های توسعه محلی کار می‌کنند — ابزارهای سبک Backoffice سفارشی و سیستم‌های مدیریت وظایف را روی API مدیر MT می‌سازند. این‌ها جایگزین کامل CRM نیستند، بلکه ابزارهای هدفمندی هستند که گردش‌کارهای عملیاتی مشخص را مدیریت می‌کنند: صف‌های بررسی حساب، چک‌لیست‌های انطباق، جریان‌های تأیید واریز، یا مدیریت وظایف تیمی متصل به وضعیت حساب معاملاتی.

برای شرکت‌های توسعه وب که می‌خواهند سبد خدمات خود را به بخش forex یا Prop Firm گسترش دهند، API مدیر MT پایه فنی لازم را برای ساخت محصولات اختصاصی کارگزاری فراهم می‌کند، بدون آن‌که نیاز باشد از ابتدا تخصص عمیق MetaTrader توسعه دهند.

کاربردهای Prop Firm — پایش آستانه‌ها و اقدامات خودکار

برای Prop Firmها، مهم‌ترین عملکرد API مدیر MT پایش لحظه‌ای آستانه‌هاست. قوانین چالش Prop Firm بر اساس آستانه‌های equity تعریف می‌شوند — محدودیت زیان روزانه، محدودیت drawdown کل، حداقل روزهای معاملاتی، قوانین consistency — و الزام عملیاتی این است که نقض‌ها در همان جلسه معاملاتی فعلی شناسایی شده و نسبت به آن‌ها اقدام شود.

یک سیستم شناسایی نقض که بر پایه APIِ MT Manager ساخته شده است، در فواصل تعریف‌شده مقادیر سرمایه حساب را بررسی می‌کند، آن‌ها را با آستانه‌های پیکربندی‌شده مقایسه می‌کند و هنگام شناسایی نقض، اقدامات خودکار را فعال می‌کند — غیرفعال‌سازی حساب، بستن پوزیشن، به‌روزرسانی وضعیت در CRM —. جایگزین آن — پایش دستی — فراتر از تعداد کمی حساب تأمین‌شده مقیاس‌پذیر نیست و دقیقاً در همان لحظه‌ای که سرمایه در معرض خطر است، ریسک خطای انسانی را وارد می‌کند.

در سال 2026، با افزایش سخت‌گیری نهادهای نظارتی و ارائه‌دهندگان پرداخت نسبت به عملیات Prop Firm، برخورداری از اعمال قانون مستند، خودکار و قابل حسابرسی، یک مزیت انطباقی هم محسوب می‌شود — نه فقط یک مزیت عملیاتی.

سرویس همگام‌سازی داده — MySQL Sync From MT4/MT5

در کنار JSON API، Kenmore Design یک سرویس همگام‌سازی داده ارائه می‌دهد که به MT4 یا MT5 متصل می‌شود و داده‌های پلتفرم معاملاتی را به‌طور پیوسته در یک پایگاه داده MySQL (یا MongoDB) همگام‌سازی می‌کند. داده‌های همگام‌شده شامل همه داده‌های موجود MT است: کاربران، حساب‌ها، تاریخچه معاملات، گروه‌ها، مقادیر سرمایه و پوزیشن‌ها.

این سرویس یک مشکل عملکردی را برطرف می‌کند که هنگام ساخت برنامه‌های پرترافیک مستقیماً روی JSON API ظاهر می‌شود. استفاده از JSON API برای ارائه داده به هزاران کاربر هم‌زمان، بار قابل‌توجهی بر سرور MetaTrader وارد می‌کند — سروری که هم‌زمان در حال مدیریت فعالیت معاملاتی زنده نیز هست. هدایت درخواست‌های خواندن از طریق یک پایگاه داده MySQL میزبانی‌شده به‌صورت محلی، این بار را به‌طور کامل از روی سرور MT برمی‌دارد و اجازه می‌دهد پلتفرم معاملاتی بدون افت عملکرد ناشی از API اجرا شود.

سرویس همگام‌سازی داده می‌تواند روی زیرساخت Kenmore Design یا روی سرورهای خود کارگزار میزبانی شود. این سرویس پایه‌ای برای سیستم‌های گزارش‌دهی در مقیاس بزرگ، یکپارچه‌سازی‌های BI و برنامه‌هایی است که نیاز دارند داده‌های تاریخی معاملات را بدون تأثیر بر عملکرد زنده پلتفرم پرس‌وجو کنند.

وبهوک‌ها — اعلان‌های رویداد بلادرنگ

وبهوک‌ها اعلان بلادرنگ رویدادهای سرور MT را بدون نیاز به اینکه برنامه به‌صورت مداوم polling انجام دهد، فراهم می‌کنند. هر نوع رویدادی می‌تواند یک وبهوک را فعال کند — باز شدن معامله، بسته شدن معامله، عبور از آستانه سرمایه، تغییر وضعیت حساب، تکمیل واریز و برداشت.

نمونه‌های رایج پیاده‌سازی وبهوک شامل هشدارهای آستانه سرمایه Prop Firm است که اقدامات خودکار حساب را فعال می‌کنند، اعلان‌های push اپلیکیشن موبایل برای نزدیک شدن به margin call، اعلان‌های تأیید معامله برای برنامه‌های سمت مشتری، و تریگرهای رویدادهای انطباقی که هنگام وقوع فعالیت معاملاتی مشخص، رکوردهای CRM را به‌روزرسانی می‌کنند.

ترکیب JSON API (برای عملیات نوشتن و خواندن‌های هدفمند)، سرویس همگام‌سازی داده (برای عملیات خواندن با حجم بالا)، و وبهوک‌ها (برای مدیریت رویدادهای بلادرنگ) تمام طیف نیازهای یکپارچه‌سازی MT را برای برنامه‌های کارگزاری و Prop Firm پوشش می‌دهد.

اتصال به CRM APIِ Kenmore Design

برای کارگزاران و Prop Firmهایی که Kenmore Design’s CRM و Trader’s Room را اجرا می‌کنند، APIهای MT Manager مستقیماً به لایه CRM API متصل می‌شوند. CRMِ Kenmore بر پایه یک مجموعه API جامع ساخته شده است که همان قابلیت‌های در دسترس از طریق رابط پلتفرم را ارائه می‌دهد — داده‌های مشتری، مدیریت حساب، روابط IB، سوابق پرداخت، وضعیت KYC، تاریخچه ارتباطات و داده‌های گزارش‌دهی.

این یعنی توسعه‌دهندگان می‌توانند برنامه‌هایی بسازند که هر دو لایه را پوشش می‌دهند — خواندن داده‌های معاملاتی MT و نوشتن در رکوردهای CRM در همان جریان کاری. پیاده‌سازی‌های رایجِ ترکیبی شامل صفحات فرود سفارشی است که مستقیماً به جریان onboarding در CRM متصل می‌شوند، یکپارچه‌سازی با تجمیع‌کننده‌های پرداخت که هم‌زمان CRM و حساب MT را به‌روزرسانی می‌کنند، اتوماسیون بازاریابی فعال‌شده بر اساس رفتار معاملاتی، و سیستم‌های ردیابی affiliate که داده‌های حجم MT را به محاسبات کمیسیون CRM متصل می‌کنند.

دسترسی به CRM API برای اپراتورها بنا به درخواست در دسترس است. مستندات فنی، که در صفحه Forex Developer API موجود است، احراز هویت، endpointهای در دسترس، محدودیت‌های نرخ و نمونه‌های یکپارچه‌سازی را پوشش می‌دهد.

جمع‌بندی

APIهای MT4 و MT5 Manager، همراه با سرویس همگام‌سازی داده و سیستم وبهوک، ابزار فنی کامل را در اختیار توسعه‌دهندگان قرار می‌دهند تا برنامه‌های سفارشی کارگزاری و Prop Firm بسازند — از ابزارهای هدفمند مدیریت ریسک و سیستم‌های گزارش‌دهی تا اپلیکیشن‌های موبایل کامل و رابط‌های سفارشی Backoffice. هنگامی که این ابزارها به CRM APIِ Kenmore Design متصل می‌شوند، یکپارچه‌سازی‌هایی را ممکن می‌کنند که کل پشته عملیاتی را پوشش می‌دهند، بدون اینکه توسعه‌دهندگان مجبور شوند محدودیت‌های پلتفرم را دور بزنند یا اتصال اختصاصی MT را از ابتدا بسازند.

برای نیازهای فنی خاص یا پرسش‌های یکپارچه‌سازی، با تیم Kenmore Design تماس بگیرید مستقیماً.

Alex Sherbakov photo
نوشته شده توسط
Alex Sherbakov
مدیرعامل Kenmore Design
بنیان‌گذار Kenmore Design با بیش از 18 سال تجربه در ساخت محصولات فین‌تک برای صنعت فارکس و Prop Trading. درباره استراتژی فناوری، توسعه پلتفرم و این‌که برای راه‌اندازی و مقیاس‌دادن یک کسب‌وکار معاملاتی از صفر واقعاً چه چیزهایی لازم است می‌نویسد.

درخواست مشاوره درباره Forex Developer API و یکپارچه‌سازی‌های سفارشی

از راهنمایی تخصصی درباره استفاده از Forex Developer API برای ساخت ابزارهای سفارشی برای کارگزاری یا Prop Firm خود بهره‌مند شوید. ما به شما کمک می‌کنیم موارد استفاده از API را ارزیابی کنید، یکپارچه‌سازی‌های امن با MT4/MT5 و سیستم‌های CRM طراحی کنید و کارآمدترین معماری را برای گزارش‌ها، ابزارهای ریسک، اپلیکیشن‌های موبایل و اتوماسیون تعیین کنید.

با هم اهداف فنی شما را بررسی می‌کنیم و یک رویکرد مقیاس‌پذیر مبتنی بر API ترسیم می‌کنیم که قابلیت‌های پلتفرم شما را بدون فشار آوردن به زیرساخت اصلی‌تان گسترش می‌دهد.