OnTradeTransaction در MQL5: فهمیدن پر شدن، رد شدن و بسته شدن سفارش در اکسپرت
پاسخ کوتاه: OnTradeTransaction تابعی در اکسپرت MQL5 است که متاتریدر ۵ با هر تغییر در حساب صدا میزند: رسیدن جواب سرور، ثبت و حذف سفارش، و اضافه شدن معامله به تاریخچه. برای فهمیدن بسته شدن معامله با حد ضرر یا حد سود، رویداد DEAL_ADD را بگیرید، معامله را با HistoryDealSelect بخوانید و DEAL_ENTRY و DEAL_REASON را بسنجید.
رویداد OnTick فقط خبر میدهد که قیمت عوض شد. اگر اکسپرت بخواهد بداند پوزیشنش بسته شد و چرا، با OnTick باید در هر تیک تعداد پوزیشنها را با دفعهٔ قبل مقایسه کند و تاریخچه را بگردد. حد ضرری که سرور اجرا کرده، سفارش معلقی که فعال شده، درخواستی که سرور رد کرده و معاملهای که کاربر با دست بسته، همه را OnTradeTransaction همان لحظه خبر میدهد. این راهنما میگوید هر رویداد چه معنایی دارد، کدامها به کار اکسپرت میآیند و دلیل بسته شدن معامله را چطور بفهمید؛ با کد کامل MQL5.
سفارش، معامله و پوزیشن: سه چیز جدا
در متاتریدر ۵ این سه با هم فرق دارند و OnTradeTransaction برای هر کدام رویداد جدا میفرستد:
- سفارش (Order): درخواستی که به سرور رسیده است؛ خرید یا فروش فوری، یا سفارش معلق.
- معامله (Deal): اجرای واقعی یک سفارش که در تاریخچه ثبت میشود. هر معامله پوزیشنی باز میکند، آن را میبندد یا بخشی از آن را میبندد.
- پوزیشن (Position): نتیجهٔ معاملههای یک نماد؛ همان چیزی که در زبانهٔ Trade میبینید.
یک خرید سادهٔ بازار، طبق مستندات MQL5، چند رویداد پشت سر هم میسازد: سرور درخواست را پردازش میکند، سفارش خرید به حساب اضافه میشود، اجرا میشود و از فهرست سفارشهای باز بیرون میرود، به تاریخچهٔ سفارشها میرود، معاملهای در تاریخچه ثبت میشود و پوزیشن تازه ساخته میشود. پس برای هر خرید، OnTradeTransaction چند بار صدا زده میشود. ترتیب رسیدن این رویدادها هم تضمینشده نیست.
سه پارامتر OnTradeTransaction
void OnTradeTransaction(const MqlTradeTransaction &trans,
const MqlTradeRequest &request,
const MqlTradeResult &result)
- trans: خود رویداد. نوعش در
trans.typeاست و بقیهٔ فیلدها بسته به نوع پر میشوند؛ مثلاً در رویداد معامله، شمارهٔ معامله درtrans.dealاست. - request و result: درخواستی که فرستاده شده و جواب سرور. این دو فقط وقتی پرند که نوع رویداد
TRADE_TRANSACTION_REQUESTباشد. در بقیهٔ رویدادها چیزی در آنها نیست.
از یازده نوع رویداد، این ششتا بیشترین کاربرد را در اکسپرت دارند:
| نوع رویداد | کی میآید | به چه کاری میآید |
|---|---|---|
| TRADE_TRANSACTION_REQUEST | سرور درخواستی را پردازش کرد و جواب داد | فهمیدن رد شدن درخواست یا پر شدن بخشی از حجم؛ جواب سفارشهای OrderSendAsync |
| TRADE_TRANSACTION_DEAL_ADD | معاملهای در تاریخچه ثبت شد؛ از اجرای سفارش یا از عملیات مالی حساب مثل واریز | فهمیدن باز و بسته شدن پوزیشن و دلیل بسته شدن |
| TRADE_TRANSACTION_ORDER_ADD | سفارش تازهای به سفارشهای باز اضافه شد | پیگیری سفارشهای معلق |
| TRADE_TRANSACTION_ORDER_DELETE | سفارش از فهرست سفارشهای باز بیرون رفت؛ چه لغو شده باشد چه اجرا | بهروز نگه داشتن فهرست سفارشهایی که اکسپرت پیگیری میکند |
| TRADE_TRANSACTION_HISTORY_ADD | سفارش اجراشده یا لغوشده به تاریخچه رفت | فهمیدن سرنوشت نهایی سفارش: پر شد یا لغو شد |
| TRADE_TRANSACTION_POSITION | پوزیشن بدون اجرای معامله تغییر کرد؛ مثل جابهجایی حد ضرر یا حد سود | پیگیری تغییر استاپها، چه با دست چه از سمت سرور |
تغییری که با اجرای معامله رخ بدهد، رویداد POSITION نمیسازد. پس بسته شدن پوزیشن را در DEAL_ADD بگیرید، نه در POSITION. چند نوع دیگر هم هست، مثل تغییر یا حذف معاملهای در تاریخچه. اینها معمولاً وقتی پیش میآیند که سیستم بیرونی بروکر معامله را عوض کرده باشد، و بیشتر اکسپرتها کاری با آنها ندارند.
کد MQL5: پر شدن، رد شدن و بسته شدن معامله
این اکسپرت معاملهای باز نمیکند و فقط نشان میدهد هر رویداد را کجا بگیرید. منطق ورود خودتان در OnTick مینشیند و معاملهها را با شیء trade و همین Magic Number میفرستد. اگر با فرستادن سفارش آشنا نیستید، آموزش ارسال سفارش Buy و Sell در MQL5 را ببینید.
#include <Trade\Trade.mqh>
input long InpMagic = 20261115; // only this EA's trades
CTrade trade;
int OnInit()
{
trade.SetExpertMagicNumber((ulong)InpMagic);
trade.SetTypeFillingBySymbol(_Symbol);
return(INIT_SUCCEEDED);
}
void OnTick()
{
// entry logic goes here: trade.Buy(...) or trade.Sell(...)
}
void OnTradeTransaction(const MqlTradeTransaction &trans,
const MqlTradeRequest &request,
const MqlTradeResult &result)
{
if(trans.type == TRADE_TRANSACTION_REQUEST)
CheckRequest(request, result);
else if(trans.type == TRADE_TRANSACTION_DEAL_ADD)
CheckDeal(trans.deal);
}
//--- the server's answer to one of this EA's requests
void CheckRequest(const MqlTradeRequest &request, const MqlTradeResult &result)
{
if(request.magic != (ulong)InpMagic)
return;
switch(result.retcode)
{
case TRADE_RETCODE_DONE:
case TRADE_RETCODE_PLACED:
return; // accepted; the deal itself arrives as DEAL_ADD
case TRADE_RETCODE_DONE_PARTIAL:
PrintFormat("partial fill: %.2f of %.2f lots", result.volume, request.volume);
return;
default:
PrintFormat("refused: %u %s (%s %s %.2f lots)", result.retcode, result.comment,
EnumToString(request.action), request.symbol, request.volume);
}
}
//--- a deal was written to history: an entry, an exit, or a balance operation
void CheckDeal(const ulong deal)
{
if(!HistoryDealSelect(deal))
{
PrintFormat("deal #%I64u not readable, error %d", deal, GetLastError());
return;
}
// read everything now: OpenedByThisEa() replaces the selected history
const long position = HistoryDealGetInteger(deal, DEAL_POSITION_ID);
const long entry = HistoryDealGetInteger(deal, DEAL_ENTRY);
const long reason = HistoryDealGetInteger(deal, DEAL_REASON);
const string symbol = HistoryDealGetString(deal, DEAL_SYMBOL);
const double volume = HistoryDealGetDouble(deal, DEAL_VOLUME);
const double price = HistoryDealGetDouble(deal, DEAL_PRICE);
const double net = HistoryDealGetDouble(deal, DEAL_PROFIT) + HistoryDealGetDouble(deal, DEAL_SWAP)
+ HistoryDealGetDouble(deal, DEAL_COMMISSION) + HistoryDealGetDouble(deal, DEAL_FEE);
if(position == 0 || symbol != _Symbol || !OpenedByThisEa(position))
return; // balance operation, another symbol, or not ours
const int digits = (int)SymbolInfoInteger(symbol, SYMBOL_DIGITS);
if(entry == DEAL_ENTRY_IN)
PrintFormat("opened %s %.2f lots at %s", symbol, volume, DoubleToString(price, digits));
else if(entry == DEAL_ENTRY_OUT || entry == DEAL_ENTRY_OUT_BY)
PrintFormat("closed %s %.2f lots at %s by %s, net %.2f", symbol, volume,
DoubleToString(price, digits), ExitReason(reason), net);
else if(entry == DEAL_ENTRY_INOUT)
PrintFormat("reversed %s at %s, net of the closed part %.2f", symbol,
DoubleToString(price, digits), net);
}
//--- ours if the position's first entry deal carries this EA's magic number
bool OpenedByThisEa(const long position)
{
if(!HistorySelectByPosition(position))
return false;
const int total = HistoryDealsTotal();
for(int i = 0; i < total; i++)
{
const ulong d = HistoryDealGetTicket(i);
if(HistoryDealGetInteger(d, DEAL_ENTRY) == DEAL_ENTRY_IN)
return HistoryDealGetInteger(d, DEAL_MAGIC) == InpMagic;
}
return false;
}
string ExitReason(const long reason)
{
switch((int)reason)
{
case DEAL_REASON_SL: return "stop loss";
case DEAL_REASON_TP: return "take profit";
case DEAL_REASON_SO: return "stop out";
case DEAL_REASON_EXPERT: return "the EA";
case DEAL_REASON_CLIENT:
case DEAL_REASON_MOBILE:
case DEAL_REASON_WEB: return "hand";
default: return "other (" + IntegerToString(reason) + ")";
}
}
چند جزء این کد عمدی است:
- جواب سرور در REQUEST، اجرای واقعی در DEAL_ADD. کد 10009 یعنی درخواست انجام شد و 10008 یعنی سفارش ثبت شد؛ هیچکدام خطا نیست و خود معامله جداگانه در DEAL_ADD میرسد. کد 10010 یعنی فقط بخشی از حجم پر شد. هر کد دیگری یعنی سرور درخواست را نپذیرفت. واکنش درست به کدهای رایج، مثل 10016 برای حد ضرر یا حد سود نامعتبر، در مدیریت خطا در MT5 آمده است.
- معامله از تاریخچه خوانده میشود. دلیل بسته شدن (DEAL_REASON)، ورود یا خروج بودن (DEAL_ENTRY) و سود معامله در
transنیست و باید از تاریخچه خوانده شود. HistoryDealSelect همان یک معامله را انتخاب میکند تا توابع HistoryDealGet بخوانندش. - مالکیت از معاملهٔ ورود سنجیده میشود. تابع OpenedByThisEa با HistorySelectByPosition همهٔ معاملههای همان پوزیشن را میآورد و Magic معاملهٔ ورود را میخواند. معاملهٔ ورود را خود اکسپرت فرستاده و Magic آن همانی است که تعیین کردهاید. این روش برای هر نوع بسته شدن یکسان جواب میدهد: چه اکسپرت بسته باشد، چه سرور با حد ضرر یا استاپاوت، چه کاربر با دست.
- سود خالص. DEAL_PROFIT سود یا زیان ناخالص است؛ سواپ، کمیسیون و کارمزد (DEAL_FEE) جدا ثبت میشوند و کد هر چهار را جمع میزند.
- بستن بخشی از حجم هم خروج است. اگر از پوزیشن یکلاتی نیم لات را ببندید، همین رویداد با DEAL_ENTRY_OUT و حجم ۰٫۵ میآید و پوزیشن باز میماند. پس «بسته شد» در این کد یعنی حجمی خارج شد، نه لزوماً اینکه کل پوزیشن بسته شد.
- واریز و برداشت هم DEAL_ADD میسازند. این معاملهها به پوزیشنی تعلق ندارند و DEAL_POSITION_ID آنها صفر است؛ کد کنارشان میگذارد.
- نماد هم سنجیده میشود. اگر همین اکسپرت با یک Magic روی چند نمودار اجرا شود، بدون شرط
symbol != _Symbolهر نمونه گزارش همهٔ نمادها را چاپ میکند.
قیمتی که معامله واقعاً با آن اجرا شد در DEAL_PRICE است. فاصلهٔ آن با قیمتی که اکسپرت خواسته بود، همان لغزش قیمت است؛ اندازهگیری و محدود کردنش در کنترل اسلیپیج و Deviation در اکسپرت آمده است.
OrderSendAsync: وقتی جواب سرور را صبر نمیکنید
OrderSend صبر میکند تا جواب سرور برسد. OrderSendAsync درخواست را میفرستد و بیدرنگ برمیگردد. این برای اکسپرتی ساخته شده که چند سفارش را پشت سر هم میفرستد و صبر برای جواب هر کدام برایش گران است. اگر OrderSendAsync مقدار true برگرداند، فقط یعنی درخواست فرستاده شد، نه اینکه به سرور رسید یا اجرا شد. کد 10008 در جواب فوری هم همین را میگوید. نتیجهٔ واقعی بعداً در OnTradeTransaction با نوع REQUEST میرسد، و شمارهٔ request_id آن را به درخواست شما وصل میکند:
uint g_buy_request = 0; // request_id of the last asynchronous buy
bool BuyAsync(const double lots)
{
trade.SetAsyncMode(true);
const bool sent = trade.Buy(lots, _Symbol);
trade.SetAsyncMode(false);
if(!sent)
{
PrintFormat("not sent: %u %s", trade.ResultRetcode(), trade.ResultRetcodeDescription());
return false;
}
MqlTradeResult res;
trade.Result(res);
g_buy_request = res.request_id; // matched against result.request_id in OnTradeTransaction
return true;
}
// first lines of CheckRequest():
// if(g_buy_request != 0 && result.request_id == g_buy_request)
// g_buy_request = 0; // the server has answered the asynchronous buy
یک درخواست ممکن است چند رویداد بسازد. رسیدن جواب REQUEST یعنی سرور تصمیمش را گرفته است، و خود معامله همچنان جداگانه در DEAL_ADD میآید.
OnTrade یا OnTradeTransaction؟
OnTrade هم با تغییر در سفارشها، پوزیشنها و تاریخچه صدا زده میشود، ولی پارامتری ندارد و نمیگوید چه چیزی عوض شد؛ برای فهمیدنش باید تاریخچه را با HistorySelect بخوانید و با دفعهٔ قبل مقایسه کنید. طبق مستندات، OnTrade بعد از OnTradeTransactionهای مربوط به همان تغییر صدا زده میشود و یک OnTrade ممکن است جای چند OnTradeTransaction بیاید.
اگر فقط میخواهید بعد از هر تغییر عددی را از نو حساب کنید، مثلاً شمارش معاملات باز در اکسپرت، OnTrade کافی است. اگر میخواهید بدانید دقیقاً چه شد، OnTradeTransaction لازم است.
پنج اشتباه رایج
- تکیه به ترتیب رویدادها. مستندات صریحاً میگوید ترتیب رسیدن رویدادها تضمینشده نیست. کدی که فرض کند ORDER_ADD همیشه پیش از DEAL_ADD میرسد، دیر یا زود اشتباه میکند.
- کار سنگین در خود تابع. رویدادها در صفی با ۱۰۲۴ جا منتظر میمانند. اگر پردازش هر رویداد زیاد طول بکشد، رویدادهای تازه جای رویدادهای قدیمی صف را میگیرند. کار کند، مثل ارسال پیامهای پشت سر هم به سرویس بیرونی، را در فهرستی نگه دارید و در OnTimer انجام دهید؛ فرق این دو رویداد در تفاوت OnTick و OnTimer آمده است.
- انتظار رویداد POSITION برای بسته شدن پوزیشن. تغییری که با اجرای معامله رخ بدهد رویداد POSITION نمیسازد. بسته شدن را در DEAL_ADD بگیرید.
- خواندن request و result در هر رویداد. این دو فقط در نوع REQUEST پرند. در بقیهٔ رویدادها خالیاند و هر تصمیمی بر پایهٔ آنها غلط است.
- جا انداختن فیلتر Magic. بدون فیلتر، اکسپرت به معاملههای دستی و اکسپرتهای دیگرِ همان حساب هم واکنش نشان میدهد. شیوهٔ انتخاب این شماره در تنظیم Magic Number در ربات معاملهگر آمده است.
در بکتست هم کار میکند؟
OnTradeTransaction در تستر استراتژی هم اجرا میشود، ولی رفتار تستر همیشه با حساب واقعی یکی نیست. برنامهنویسها در انجمن رسمی MQL5 گزارش دادهاند که مقدار بعضی فیلدهای رویداد در تستر با حساب دمو فرق داشته، و معاملهٔ استاپاوت در تستر به OnTradeTransaction نرسیده است. مدیر همان انجمن توضیح داده که استاپاوت در تستر یعنی پایان بکتست. پس منطقی که به این رویدادها تکیه دارد، بعد از بکتست چند روز روی حساب دمو هم آزموده شود.
نمونهٔ کاربردی همین رویداد، فرستادن اعلان باز و بسته شدن معامله است؛ اتصال متاتریدر به تلگرام همین کار را با WebRequest انجام میدهد.
اگر اکسپرتی میخواهید که بعد از هر حد ضرر رفتارش را عوض کند، گزارش هر معامله را برایتان بفرستد یا سفارشها را بیانتظار برای جواب سرور مدیریت کند، برنامهنویسی MQL5 آن را به ما بسپارید.
پرسشهای پرتکرار
OnTradeTransaction در اندیکاتور هم کار میکند؟
بله. طبق کتاب رسمی MQL5، اکسپرت و اندیکاتور هر دو این رویداد را میگیرند، اگر این تابع را داشته باشند. اسکریپت فقط OnStart را اجرا میکند و رویدادی نمیگیرد.
چرا تابع برای یک خرید چند بار صدا زده میشود؟
چون یک درخواست چند تغییر در حساب میسازد و هر تغییر یک رویداد جداست: جواب درخواست، ثبت و اجرای سفارش، ثبت معامله در تاریخچه و ساخت پوزیشن.
از کجا بفهمم معامله با حد سود بسته شد؟
در رویداد DEAL_ADD معامله را با HistoryDealSelect بخوانید. اگر DEAL_ENTRY برابر DEAL_ENTRY_OUT و DEAL_REASON برابر DEAL_REASON_TP بود، با حد سود بسته شده است. برای حد ضرر، DEAL_REASON_SL است.
در MQL4 معادلی دارد؟
نه. MQL4 نه OnTradeTransaction دارد نه OnTrade. در آنجا باید در OnTick یا OnTimer تعداد سفارشهای باز و تاریخچه را با دفعهٔ قبل مقایسه کنید.
منابع
- مستندات MQL5: OnTradeTransaction
- مستندات MQL5: ساختار MqlTradeTransaction
- مستندات MQL5: انواع رویداد معامله
- مستندات MQL5: ویژگیهای معامله، DEAL_ENTRY و DEAL_REASON
- مستندات MQL5: OrderSendAsync
- مستندات MQL5: ساختار MqlTradeResult و request_id
- کتاب MQL5: رویداد OnTradeTransaction
- انجمن MQL5: تفاوت رفتار OnTradeTransaction در تستر و حساب دمو
- انجمن MQL5: رویداد استاپاوت در تستر
دیدگاهها