نمونه اکسپرت فارکس: کد کامل یک اکسپرت MQL5 با توضیح بخشبهبخش
فهرست مطالب
فهرست مطالب
کسی که «نمونه اکسپرت فارکس» جستوجو میکند، معمولاً یکی از این دو را میخواهد: نمونهکار برنامهنویسها برای سنجیدن کیفیت کار، یا کد یک اکسپرت واقعی برای فهمیدن اینکه اکسپرت از درون چه شکلی دارد. این صفحه دومی را میدهد: کد کامل یک اکسپرت ساده برای متاتریدر ۵ با توضیح بخشبهبخش. اکسپرت نمونه برای یاد گرفتن است، نه یک سیستم سودده؛ ولی همهٔ بخشهایی را دارد که هر اکسپرت جدی لازم دارد.
این اکسپرت نمونه چه میکند؟
- دو میانگین متحرک ساده، ۲۰ و ۵۰ دورهای، را روی کندلهای بستهشده مقایسه میکند.
- وقتی میانگین کوتاه میانگین بلند را به بالا قطع کند، خرید و وقتی به پایین قطع کند، فروش باز میکند.
- هر بار فقط یک معامله باز دارد و آن را با شمارهٔ جادویی (Magic Number) خودش میشناسد.
- حد ضرر ۳۰۰ و حد سود ۶۰۰ پوینت میگذارد؛ در بروکرهای پنجرقمی هر ۱۰ پوینت یک پیپ است، پس یعنی ۳۰ و ۶۰ پیپ.
- حجم را طوری حساب میکند که اگر حد ضرر بخورد، فقط یک درصد موجودی از دست برود.
کد کامل اکسپرت
//+------------------------------------------------------------------+
//| SampleMACross.mq5 - a teaching sample, not a profitable system |
//+------------------------------------------------------------------+
#include <Trade/Trade.mqh>
input int FastPeriod = 20; // fast SMA period
input int SlowPeriod = 50; // slow SMA period
input double RiskPercent = 1.0; // risk per trade, % of balance
input int StopPoints = 300; // stop loss in points
input int TakePoints = 600; // take profit in points
input ulong Magic = 20261117; // tells this EA's trades apart
CTrade trade;
int fastHandle, slowHandle;
datetime lastBar = 0;
int OnInit()
{
fastHandle = iMA(_Symbol, PERIOD_CURRENT, FastPeriod, 0, MODE_SMA, PRICE_CLOSE);
slowHandle = iMA(_Symbol, PERIOD_CURRENT, SlowPeriod, 0, MODE_SMA, PRICE_CLOSE);
if(fastHandle == INVALID_HANDLE || slowHandle == INVALID_HANDLE)
return INIT_FAILED;
trade.SetExpertMagicNumber(Magic);
return INIT_SUCCEEDED;
}
void OnDeinit(const int reason)
{
IndicatorRelease(fastHandle);
IndicatorRelease(slowHandle);
}
// Lots that lose RiskPercent of the balance if the stop is hit.
double LotsForRisk(const double stopDistance)
{
double tickValue = SymbolInfoDouble(_Symbol, SYMBOL_TRADE_TICK_VALUE);
double tickSize = SymbolInfoDouble(_Symbol, SYMBOL_TRADE_TICK_SIZE);
double step = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_STEP);
double minLot = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MIN);
double maxLot = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MAX);
if(tickValue <= 0 || tickSize <= 0 || stopDistance <= 0)
return 0;
double risk = AccountInfoDouble(ACCOUNT_BALANCE) * RiskPercent / 100.0;
double lots = MathFloor(risk / (stopDistance / tickSize * tickValue) / step) * step;
return (lots < minLot) ? 0 : MathMin(lots, maxLot);
}
// True when this EA already has a position on this symbol.
bool HasPosition()
{
for(int i = PositionsTotal() - 1; i >= 0; i--)
if(PositionGetSymbol(i) == _Symbol && PositionGetInteger(POSITION_MAGIC) == (long)Magic)
return true;
return false;
}
void OnTick()
{
datetime bar = iTime(_Symbol, PERIOD_CURRENT, 0);
if(bar == lastBar) // act once per new bar
return;
lastBar = bar;
double fast[2], slow[2]; // [0] = bar 2, [1] = bar 1 (oldest first)
if(CopyBuffer(fastHandle, 0, 1, 2, fast) != 2 || CopyBuffer(slowHandle, 0, 1, 2, slow) != 2)
return;
bool crossUp = fast[0] <= slow[0] && fast[1] > slow[1];
bool crossDown = fast[0] >= slow[0] && fast[1] < slow[1];
if(HasPosition() || (!crossUp && !crossDown))
return;
double stop = StopPoints * _Point;
double lots = LotsForRisk(stop);
if(lots <= 0)
return;
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
if(crossUp)
trade.Buy(lots, _Symbol, ask, NormalizeDouble(ask - stop, _Digits),
NormalizeDouble(ask + TakePoints * _Point, _Digits), "sample MA cross");
else
trade.Sell(lots, _Symbol, bid, NormalizeDouble(bid + stop, _Digits),
NormalizeDouble(bid - TakePoints * _Point, _Digits), "sample MA cross");
}
توضیح بخشبهبخش
- ورودیها (input): هر عددی که کاربر باید بتواند بدون برنامهنویس عوض کند، ورودی است و در پنجرهٔ تنظیمات اکسپرت دیده میشود.
- OnInit: یک بار، هنگام اجرای اکسپرت روی چارت، دستگیرهٔ (handle) دو میانگین ساخته میشود. اگر ساختن هر کدام شکست بخورد، اکسپرت اصلاً شروع نمیکند.
- LotsForRisk: همان فرمول حجم بر اساس ریسک است که در اندیکاتور محاسبه حجم معامله با مثال عددی توضیح دادهایم؛ ارزش تیک و گام حجم را از خود بروکر میخواند، نه از عدد ثابت.
- HasPosition: معاملههای باز را میگردد و فقط معاملهٔ همین نماد با همین شمارهٔ جادویی را حساب میکند، تا اکسپرت با معاملههای دستی یا اکسپرتهای دیگر قاطی نشود.
- کندل تازه: OnTick با هر تغییر قیمت صدا زده میشود. مقایسهٔ زمان کندل صفر با lastBar باعث میشود تصمیم فقط یک بار در هر کندل گرفته شود.
- CopyBuffer: مقدار دو کندل بستهشدهٔ آخر را میخواند؛ در آرایهٔ معمولی، خانهٔ اول کندل قدیمیتر است. عبور میانگینها روی کندل بسته تأیید میشود تا سیگنال وسط کندل عوض نشود.
- CTrade: کلاس استاندارد معامله در MQL5 است و سفارش را با حد ضرر و حد سود، که با NormalizeDouble به تعداد رقمهای نماد گرد شدهاند، میفرستد.
یک اکسپرت واقعی چه چیزهای دیگری لازم دارد؟
این نمونه عمداً کوتاه مانده است. اکسپرتی که قرار است روی حساب واقعی کار کند، دستکم اینها را هم میخواهد:
- کنترل نتیجهٔ سفارش: بررسی کد نتیجهٔ هر درخواست و تلاش دوباره یا گزارش خطا، نه فرض اینکه سفارش حتماً انجام شده است.
- حداقل فاصلهٔ حد ضرر: هر بروکر کمترین فاصلهٔ مجاز حد ضرر از قیمت را دارد (Stops Level)؛ حد ضرر نزدیکتر از آن رد میشود.
- فیلتر اسپرد و ساعت: معامله نکردن وقتی اسپرد غیرعادی باز است یا در ساعت خبرهای مهم.
- مدیریت معامله: حد ضرر متحرک، سربهسر کردن یا بستن بخشی از حجم، هر چه استراتژی میگوید.
- آزمون: بکتست با تیک واقعی و بعد چند هفته دمو؛ روشش در بکتست ربات در متاتریدر ۵ آمده است.
میانگین متحرک هم اندیکاتوری پسرو است و دیر برمیگردد؛ فرق آن با اندیکاتورهای پیشرو و راه ترکیبشان در اندیکاتور پیشرو و پسرو آمده است.
اجرا و تست این نمونه
- در متاتریدر ۵ کلید F4 را بزنید تا MetaEditor باز شود، یک فایل اکسپرت تازه بسازید و کد بالا را جای متن آن بگذارید.
- با F7 کامپایل کنید؛ فایل اجرایی در پوشهٔ Experts ساخته میشود.
- اکسپرت را از پنجرهٔ Navigator روی چارت یک نماد بکشید و دکمهٔ Algo Trading را روشن کنید.
- پیش از هر چیز آن را در Strategy Tester روی دادهٔ گذشته امتحان کنید، نه روی حساب واقعی.
نمونهکار سفارشی
کد اکسپرتهایی که برای مشتریها ساخته میشود مال خود آنهاست و بدون اجازهشان منتشر نمیشود؛ برای همین این صفحه بهجای نمونهکار، نمونهٔ کد آموزشی میدهد. اگر استراتژی خودتان را دارید و میخواهید اکسپرت آن ساخته شود، روند کار، شرح سفارش و تست پیش از تحویل در صفحهٔ سفارش اکسپرت متاتریدر ۴ و نسخهٔ متاتریدر ۵ آمده است.
پرسشهای رایج
این اکسپرت نمونه سود میدهد؟
برای سود ساخته نشده است. عبور دو میانگین در روندهای بلند سود و در بازار بیروند ضرر پشت ضرر میدهد. هدف این نمونه نشان دادن ساختار درست یک اکسپرت است، نه پیشنهاد معامله.
این کد روی متاتریدر ۴ اجرا میشود؟
نه. متاتریدر ۴ زبان MQL4 را دارد و توابع معاملهاش، مثل OrderSend، با کلاس CTrade متاتریدر ۵ فرق دارد. منطق همین است، ولی نسخهٔ متاتریدر ۴ باید جدا نوشته شود. فرق متاتریدر با cTrader، تریدینگویو و پایتون برای معاملهٔ خودکار در نرمافزار معاملات الگوریتمی آمده است.
پوینت و پیپ چه فرقی دارند؟
پوینت کوچکترین تغییر قیمت نماد است. در بروکرهای پنجرقمی یورو/دلار هر پیپ ۱۰ پوینت است؛ برای همین StopPoints برابر ۳۰۰ یعنی ۳۰ پیپ. در نمادهای دیگر، مثل طلا، اندازهٔ پوینت را از مشخصات نماد ببینید.
دیدگاه خود را بنویسید