EA (MT4/MT5) — Local & Remote REST API Bridge for Trading

خلاصه پروژه: نیاز به یک Expert Advisor برای MetaTrader 4 و MetaTrader 5 دارم که روی ترمینال اجرا شده و یک REST API محلی کامل و ریموت در اختیار کلاینت‌های خارجی قرار دهد. این API باید توانایی فراهم‌سازی قیمت‌های جاری، تاریخچه قیمت (OHLC)، اطلاعات نماد، اندیکاتورهای داخلی و سفارشی، ارسال/مدیریت سفارش‌ها (market/limit/stop)، و دریافت تاریخچه تراکنش‌ها را داشته باشد. مهم: WebSocket لازم نیست — همه جریان‌ها باید از طریق snapshot/polling/registration REST پیاده‌سازی شوند. قابلیت‌های مورد انتظار (Scope): توسعه EA برای هر دو پلتفرم MT4 (.mq4) و MT5 (.mq5). راه‌اندازی یک REST server محلی (پیش‌فرض http://127.0.0.1:81) و ریموت یا ادغام با سرویس محلی معادل. Endpoints کامل (GET/POST) شامل اما نه محدود به: Account / Terminal info Quotes (current bid/ask) History (OHLC) با پارامترهای تاریخ/تایم‌فریم Symbol info / Symbol list Indicators: ATR, MA، و اندیکاتورهای سفارشی Order send / modify / close / info / list Track (REST-only): snapshot/registration برای قیمت‌ها، OHLC، عمق بازار، رویدادهای سفارش پاسخ‌ها به‌صورت JSON با قالب استاندارد شامل MSG, ERROR_ID, ERROR_DESCRIPTION و فیلدهای مرتبط. پشتیبانی از عملیات همزمان با مدیریت قفل/Concurrency مناسب جهت جلوگیری از تداخل با توابع ترمینال. نیازمندی‌های ایمنی و پیکربندی: پشتیبانی از API Key (مثلاً Authorization: Bearer یا x-api-key) و قابلیت محدودسازی به 127.0.0.1 یا آیپی وی پی اس به‌صورت پیش‌فرض. قابلیت پیکربندی: پورت، api_key، timeout، logging، rate-limit. مستندات امنیتی توصیه‌شده (در صورت نیاز می‌توان TLS/HTTPS، OAuth2 یا Client Certificates را اضافه کرد). خروجی‌های تحویل نهایی (Deliverables): سورس EA برای MT4 (.mq4) و MT5 (.mq5) همراه فایل‌های کمکی. فایل‌های کامپایل‌شده در صورت درخواست (.ex4, .ex5). فایل پیکربندی نمونه (پورت، api_key، timeout، logging). مستند نصب و راه‌اندازی (گام‌به‌گام) و آموزش کوتاه نحوه اجرا. مستند API کامل (Markdown / PDF) شامل تمامی endpoints، پارامترها، نمونه‌های request/response. Postman collection یا مجموعه نمونه‌های curl برای تست. لاگ‌های نمونه اجرای تست‌های پذیرش و نتایج آن‌ها. لیست محدودیت‌ها (Known Limitations) و فهرست کتابخانه‌های ثالث استفاده‌شده. الزامات فنی و رفتار API (خلاصه): Base URL پیش‌فرض: http://127.0.0.1:81 (قابل تغییر). ورودی/خروجی JSON، فرمت زمان YYYY.MM.DD HH:MM:SS[.mmm]. تمامی پاسخ‌ها حداقل شامل MSG, ERROR_ID, ERROR_DESCRIPTION باشند. عملیات معاملاتی (send/close/modify) باید چک‌های لازم را انجام دهند: نماد قابل معامله، حجم در بازه مجاز، کفایت مارجین و مدیریت async (در صورت فعال بودن، REQUEST_ID برگشت داده شود). رفتارهای stream حذف شده و به جای آن snapshot / polling / registration پیاده‌سازی شود. شرایط پذیرش (Acceptance criteria): API مطابق مستند کار می‌کند و endpoints نمونه (حساب، quote، price history، send order، close order، indicator ATR) پاسخی با ERROR_ID = 0 برمی‌گردانند. لاگ‌های اجرای تست‌ها ارائه شوند. EA، مستندات و Postman collection تحویل شود. حداقل محدودیت امنیتی (API Key + محلی بودن) اعمال شده باشد. اطلاعات بیشتر: https://sider.ai/share/b371f811c9375aae08b06c3771afcc04