MQL5 – Referenční příručka s příklady
Jazyk pro Expert Advisory, indikátory a skripty v MetaTrader 5. Od syntaxe přes obchodování až po komunikaci s externím serverem.
Všechny ukázky jsou připravené ke zkopírování do MetaEditoru (F4 v terminálu, kompilace F7).
1. Úvod a prostředí
MQL5 je objektově orientovaný jazyk se syntaxí blízkou C++. Programy se píší v MetaEditoru, kompilují do .ex5 a spouští uvnitř terminálu MetaTrader 5.
Typy programů
| Typ | Přípona zdroje | Složka v MQL5\ | Popis |
| Expert Advisor (EA) | .mq5 | Experts | Běží na grafu, reaguje na ticky a události, obchoduje. |
| Indikátor | .mq5 | Indicators | Počítá a kreslí data, nesmí obchodovat. |
| Skript | .mq5 | Scripts | Jednorázové provedení (OnStart), pak skončí. |
| Služba | .mq5 | Services | Běží na pozadí bez grafu. |
| Include | .mqh | Include | Znovupoužitelný kód (třídy, funkce). |
| Knihovna | .mq5 / .ex5 | Libraries | Sdílené funkce přes #import. |
Užitečné klávesy a nástroje
F4 – otevře MetaEditor, F7 – kompilace, F5 – start s laděním na historických datech.
Ctrl+T – okno Toolbox (karta Experts = výstup Print, karta Journal = systémové zprávy).
Ctrl+R – Strategy Tester.
F1 na funkci v editoru otevře oficiální nápovědu.
Pozn.: Direktiva #property strict z MQL4 se v MQL5 nepoužívá – kompilátor je přísný vždy.
2. Kostra programu
Expert Advisor
Skript
Důležité direktivy
| Direktiva | Význam |
#property copyright "text" | Autor zobrazený v dialogu programu. |
#property version "1.00" | Verze (formát major.minor). |
#property script_show_inputs | Skript zobrazí dialog s parametry před startem. |
#property indicator_chart_window | Indikátor se kreslí do hlavního okna (jinak indicator_separate_window). |
#include <Soubor.mqh> | Hledá v MQL5\Include. |
#include "Soubor.mqh" | Hledá ve složce aktuálního souboru. |
#define NAZEV hodnota | Makro / konstanta. |
#ifdef / #ifndef / #endif | Podmíněný překlad. |
#import "knihovna.dll" | Import funkcí z DLL / EX5 knihovny. |
Předdefinovaná makra: __FILE__, __LINE__, __FUNCTION__, __DATE__, __MQLBUILD__.
3. Datové typy
| Typ | Velikost | Rozsah / poznámka |
bool | 1 B | true / false |
char / uchar | 1 B | −128…127 / 0…255 |
short / ushort | 2 B | −32 768…32 767 / 0…65 535 |
int / uint | 4 B | ±2,1 mld. / 0…4,29 mld. |
long / ulong | 8 B | tickety, magic number, volume |
float | 4 B | ~7 platných číslic |
double | 8 B | ~15 platných číslic (ceny, loty) |
string | proměnná | Unicode (UTF-16) |
datetime | 8 B | sekundy od 1. 1. 1970 |
color | 4 B | clrRed, C'255,128,0', 0x0000FF (BGR!) |
enum | 4 B | výčtový typ |
Literály
Pozor: Barva color je uložena jako BGR (0xBBGGRR), ne RGB. Raději používejte konstanty clr… nebo C'R,G,B'.
Výčty (enum)
4. Proměnné, konstanty, vstupní parametry
- Globální proměnné se inicializují jednou při načtení programu.
- Vstupní parametry jsou pouze ke čtení; pro změnu použijte kopii.
- Konvence:
Inp… vstupy, g_… globální, m_… členy tříd.
Předdefinované proměnné
| Proměnná | Význam |
_Symbol | Symbol aktuálního grafu ("EURUSD") |
_Period | Timeframe grafu (PERIOD_M5) |
_Point | Velikost bodu (např. 0.00001) |
_Digits | Počet desetinných míst ceny |
_LastError | Kód poslední chyby |
_StopFlag | Program má být ukončen |
5. Operátory a řídicí struktury
Operátory odpovídají C++: aritmetické + - * / %, porovnání == != < > <= >=, logické && || !, bitové & | ^ ~ << >>, přiřazení = += -= *= /=, podmíněný ?:, ++ / --.
Pozor: Porovnání desetinných čísel pomocí == je nespolehlivé. Porovnávejte s tolerancí nebo po NormalizeDouble().
Matematické funkce
| Funkce | Popis |
MathAbs, MathMax, MathMin | absolutní hodnota, maximum, minimum |
MathFloor, MathCeil, MathRound | zaokrouhlení dolů / nahoru / běžné |
MathPow, MathSqrt, MathExp, MathLog, MathLog10 | mocnina, odmocnina, exp., logaritmy |
MathSin, MathCos, MathTan, MathArctan | goniometrické funkce (radiány) |
MathSrand(seed), MathRand() | náhodné číslo 0…32767 |
NormalizeDouble(x, digits) | zaokrouhlení na počet míst |
MathIsValidNumber(x) | kontrola NaN / INF |
6. Funkce
- Pole se předávají vždy referencí (
&), const chrání před změnou.
- Funkce musí být deklarována před použitím, nebo jí předchází prototyp.
- Rekurze je podporována, ale pozor na hloubku zásobníku.
7. Pole
Tip: Bez ArraySetAsSeries(arr, true) je index 0 nejstarší hodnota a poslední prvek je nejnovější. Vždy si ujasněte, jaké pořadí používáte.
Novější buildy navíc nabízejí ArrayInsert, ArrayRemove, ArrayReverse, ArraySwap.
8. Struktury a třídy
Struktura
Třída, dědičnost, polymorfismus
- Objekty vytvořené operátorem
new je nutné ručně smazat přes delete (jinak úniky paměti – terminál je vypíše při ukončení).
- Přístupová práva:
public, protected, private.
- Vícenásobná dědičnost není podporována, rozhraní (
interface) ano.
9. Obsluha událostí
| Funkce | Platí pro | Kdy se volá |
int OnInit() | EA, indikátor | Start / změna parametrů / změna symbolu či periody |
void OnDeinit(const int reason) | EA, indikátor | Ukončení programu |
void OnTick() | EA | Nový tick symbolu grafu |
void OnStart() | skript, služba | Jediný vstupní bod |
int OnCalculate(...) | indikátor | Nový tick / změna historie |
void OnTimer() | EA, indikátor | Po EventSetTimer() |
void OnTrade() | EA | Jakákoliv změna na obchodním účtu |
void OnTradeTransaction(...) | EA | Detailní obchodní transakce |
void OnChartEvent(...) | EA, indikátor | Klik, klávesa, interakce s objekty |
void OnBookEvent(const string &symbol) | EA, indikátor | Změna Depth of Market |
double OnTester() | EA | Konec testu – vlastní optimalizační kritérium |
Časovač
Události grafu
Důvody ukončení (OnDeinit)
| Konstanta | Význam |
REASON_REMOVE | Program odstraněn z grafu |
REASON_CHARTCHANGE | Změna symbolu nebo periody |
REASON_PARAMETERS | Změna vstupních parametrů |
REASON_RECOMPILE | Překompilování programu |
REASON_CLOSE | Zavření terminálu |
REASON_ACCOUNT | Přepnutí účtu |
10. Řetězce, výpisy a formátování
Výpisy
| Funkce | Účel |
Print(a, b, …) | Výpis do karty Experts |
PrintFormat("…%d", x) | Formátovaný výpis (jako printf) |
Comment("text") | Text v levém horním rohu grafu |
Alert("text") | Dialogové okno + zvuk |
SendNotification("text") | Push notifikace do mobilu (nutné nastavit MetaQuotes ID) |
SendMail("předmět", "text") | E-mail (nastavit SMTP v terminálu) |
PlaySound("alert.wav") | Přehraje zvuk ze složky Sounds |
| Formát | Význam |
%d / %i | celé číslo se znaménkem |
%u | celé číslo bez znaménka (uint, ulong s %I64u) |
%f, %.2f | desetinné číslo |
%s | řetězec |
%x | hexadecimálně |
%c | znak |
%I64d | long (např. ticket) |
11. Čas a datum
Pozn.: V testeru je TimeLocal() i TimeGMT() odvozen ze simulovaného serverového času. Pro logiku, která musí fungovat stejně v testeru i na účtu, používejte TimeCurrent().
12. Informace o symbolu, účtu a terminálu
Netting vs. hedging účet
- Netting – na jeden symbol je jen jedna pozice; další obchod ji zvětší, zmenší nebo otočí.
- Hedging – lze držet víc pozic na stejném symbolu, i protichůdných.
13. Cenová data a časové řady
Aktuální tick
Svíčky – CopyRates
Jednotlivé řady
Detekce nové svíčky
Timeframy
| Konstanta | Perioda | Konstanta | Perioda |
PERIOD_M1 | 1 min | PERIOD_H1 | 1 hod |
PERIOD_M5 | 5 min | PERIOD_H4 | 4 hod |
PERIOD_M15 | 15 min | PERIOD_D1 | 1 den |
PERIOD_M30 | 30 min | PERIOD_W1 / MN1 | týden / měsíc |
PERIOD_CURRENT (nebo 0) = timeframe grafu.
Pozor: Při prvním přístupu k jinému symbolu či timeframu nemusí být historie načtena – CopyRates může vrátit −1 nebo méně dat. Zkontrolujte návratovou hodnotu a případně to zkuste při dalším ticku.
14. Technické indikátory (handle + CopyBuffer)
V MQL5 funkce iMA, iRSI apod. nevracejí hodnotu, ale handle (uchwyt) indikátoru. Handle se vytvoří jednou v OnInit, data se čtou přes CopyBuffer a na konci se handle uvolní.
Přehled vestavěných indikátorů
| Funkce | Parametry | Buffery |
iMA | symbol, tf, period, ma_shift, ma_method, applied_price | 0 = MA |
iRSI | symbol, tf, period, applied_price | 0 = RSI |
iATR | symbol, tf, period | 0 = ATR |
iMACD | symbol, tf, fast, slow, signal, applied_price | 0 = MACD, 1 = signál |
iBands | symbol, tf, period, shift, deviation, applied_price | 0 = střed, 1 = horní, 2 = dolní |
iStochastic | symbol, tf, K, D, slowing, ma_method, price_field | 0 = %K, 1 = %D |
iCCI | symbol, tf, period, applied_price | 0 = CCI |
iADX | symbol, tf, period | 0 = ADX, 1 = +DI, 2 = −DI |
iCustom | symbol, tf, "cesta\\název", parametry… | podle indikátoru |
| ENUM_MA_METHOD | ENUM_APPLIED_PRICE |
MODE_SMA, MODE_EMA, MODE_SMMA, MODE_LWMA |
PRICE_CLOSE, PRICE_OPEN, PRICE_HIGH, PRICE_LOW, PRICE_MEDIAN, PRICE_TYPICAL, PRICE_WEIGHTED |
Bollingerova pásma a vlastní indikátor přes iCustom
Pozor: Nevytvářejte handle opakovaně v OnTick – každé volání alokuje nový indikátor a zahlcuje terminál. Vždy jednou v OnInit.
15. Obchodování – nízkoúrovňové API
Obchodní příkazy se posílají funkcí OrderSend se strukturami MqlTradeRequest (žádost) a MqlTradeResult (odpověď). Každá žádost má povinné pole action.
| ENUM_TRADE_REQUEST_ACTIONS | Použití |
TRADE_ACTION_DEAL | Tržní příkaz (otevření / zavření) |
TRADE_ACTION_PENDING | Zadání pending příkazu |
TRADE_ACTION_SLTP | Změna SL/TP otevřené pozice |
TRADE_ACTION_MODIFY | Změna pending příkazu |
TRADE_ACTION_REMOVE | Smazání pending příkazu |
TRADE_ACTION_CLOSE_BY | Uzavření protichůdnou pozicí (hedging) |
Výběr způsobu plnění
Pozn.: Špatný typ plnění je častou příčinou chyby 10030 (TRADE_RETCODE_INVALID_FILL). Různí brokeři podporují různé režimy.
Otevření tržní pozice
Kontrola žádosti před odesláním
Úprava SL/TP a zavření pozice
Pending příkazy
Přehled návratových kódů (retcode)
| Kód | Konstanta | Význam / řešení |
| 10004 | REQUOTE | Cena se změnila – zvyšte deviation nebo zopakujte. |
| 10006 | REJECT | Server žádost odmítl. |
| 10008 | PLACED | Pending příkaz zadán (OK). |
| 10009 | DONE | Provedeno (OK). |
| 10013 | INVALID | Neplatná žádost – zkontrolujte pole struktury. |
| 10014 | INVALID_VOLUME | Špatný lot (min/max/step). |
| 10015 | INVALID_PRICE | Špatná cena – normalizujte na _Digits. |
| 10016 | INVALID_STOPS | SL/TP příliš blízko (stops level) nebo na špatné straně. |
| 10017 | TRADE_DISABLED | Obchodování je pro symbol vypnuto. |
| 10018 | MARKET_CLOSED | Trh je zavřený. |
| 10019 | NO_MONEY | Nedostatek volné marže. |
| 10024 | TOO_MANY_REQUESTS | Příliš častá volání – zpomalte. |
| 10025 | NO_CHANGES | Žádná změna (SL/TP už mají zadané hodnoty). |
| 10027 | CLIENT_DISABLES_AT | Algo Trading vypnut v terminálu (tlačítko / nastavení). |
| 10029 | FROZEN | Příkaz je „zmrazený“ (freeze level). |
| 10030 | INVALID_FILL | Nepodporovaný typ plnění. |
| 10031 | NO_CONNECTION | Bez spojení se serverem. |
| 10033 | LIMIT_ORDERS | Dosažen limit počtu příkazů. |
| 10034 | LIMIT_VOLUME | Dosažen limit objemu pro symbol. |
| 10036 | POSITION_CLOSED | Pozice už byla uzavřena. |
16. Čtení pozic, příkazů a historie
Otevřené pozice
Čekající příkazy
Historie obchodů (deals)
Pozn.: Nejdřív vždy HistorySelect(od, do), teprve potom HistoryDeals* / HistoryOrders*. Bez výběru je historie prázdná.
17. Standardní knihovna – CTrade a spol.
Pohodlnější než surový OrderSend jsou třídy ze Standard Library.
| Třída | Include | Účel |
CTrade | <Trade\Trade.mqh> | Otevření, zavření, změna pozic a příkazů |
CPositionInfo | <Trade\PositionInfo.mqh> | Čtení vlastností pozice |
COrderInfo | <Trade\OrderInfo.mqh> | Čtení vlastností příkazu |
CDealInfo | <Trade\DealInfo.mqh> | Čtení historických obchodů |
CSymbolInfo | <Trade\SymbolInfo.mqh> | Vlastnosti symbolu |
CAccountInfo | <Trade\AccountInfo.mqh> | Vlastnosti účtu |
CArrayInt, CArrayDouble, CArrayObj | <Arrays\…> | Dynamická pole / kolekce |
Výsledek posledního obchodu
| Metoda | Význam |
ResultRetcode() | Kód výsledku (10009 = OK) |
ResultRetcodeDescription() | Textový popis |
ResultDeal(), ResultOrder() | Ticket obchodu / příkazu |
ResultPrice(), ResultVolume() | Skutečná cena a objem |
18. Řízení rizika a pomocné funkce
Lot podle rizika v %
Normalizace cen a kontrola stops levelu
Trailing stop (ATR / pevný)
Zavření všech pozic
Filtry spreadu a denní ztráty
19. Grafické objekty a panely
| Objekt | Popis |
OBJ_HLINE, OBJ_VLINE, OBJ_TREND | Čáry |
OBJ_RECTANGLE, OBJ_TRIANGLE | Obrazce |
OBJ_TEXT | Text ukotvený k ceně a času |
OBJ_LABEL | Text ukotvený k pixelům grafu |
OBJ_BUTTON, OBJ_EDIT, OBJ_RECTANGLE_LABEL | Prvky ovládacího panelu |
OBJ_ARROW_UP/DOWN/BUY/SELL | Značky signálů |
Tip: Názvy objektů prefixujte jménem EA (MujEA_…), aby se nepletly s ručně kreslenými a šly hromadně smazat.
20. Soubory a globální proměnné terminálu
Soubory se čtou a zapisují jen v sandboxu: MQL5\Files (lokální pro terminál) nebo …\Terminal\Common\Files s příznakem FILE_COMMON (sdílené mezi terminály a použitelné i s externími programy).
Pozn.: Bez FILE_ANSI se textové soubory zapisují v UTF-16, což některé externí programy (např. Python bez encoding="utf-16") špatně načtou.
Globální proměnné terminálu
Hodnoty jsou sdílené mezi všemi EA a skripty v jednom terminálu – vhodné pro předávání stavu mezi programy.
21. Komunikace se serverem – WebRequest
WebRequest umožňuje volat HTTP(S) API, například vlastní predikční server v Pythonu. Funguje v EA a skriptech, ne v indikátorech.
Nutné nastavení: V terminálu Nástroje → Možnosti → Expert Advisors → Povolit WebRequest pro uvedené URL přidejte adresu (např. http://127.0.0.1:5000). Bez toho vrací WebRequest hodnotu −1 a chybu 4014.
Příklad: EA se ptá predikčního serveru
WebRequest je synchronní – během volání EA stojí. Nastavte rozumný timeout a volejte jen jednou na svíčku.
- Pro robustnější práci s JSON použijte knihovnu třetí strany (např. JAson) – MQL5 nemá vestavěný JSON parser.
- Při chybě serveru vždy použijte bezpečnou výchozí hodnotu a neobchodujte naslepo.
22. Chyby a ladění
| Kód | Konstanta | Význam |
| 4014 | ERR_FUNCTION_NOT_ALLOWED | Funkce není povolena (typicky WebRequest bez povolení URL) |
| 4301 | ERR_MARKET_UNKNOWN_SYMBOL | Neznámý symbol |
| 4401 | ERR_HISTORY_NOT_FOUND | Požadovaná historie nenalezena |
| 4806 | ERR_INDICATOR_DATA_NOT_FOUND | Data indikátoru ještě nejsou k dispozici |
| 5004 | ERR_CANNOT_OPEN_FILE | Soubor nelze otevřít |
Ladění
- Print / PrintFormat – nejjednodušší, výstup v kartě Experts.
- Debugger v MetaEditoru –
F5 (na historických datech) nebo F6; breakpointy přes F9, krokování F10/F11.
- Vizuální tester – Strategy Tester s volbou Visual mode, kreslí obchody do grafu.
DebugBreak() zastaví program v ladicím režimu na daném řádku.
23. Strategy Tester a optimalizace
- V testeru vypněte GUI a zbytečné
Print – výrazně zrychlí optimalizaci.
- Používejte reálné ticky (Every tick based on real ticks) pro scalping a M1/M5 strategie.
- Vstupy označené
sinput se v optimalizaci neprochází.
- Ověřte strategii na jiném období (out-of-sample) – optimalizace snadno přeučí parametry.
24. Vlastní indikátor – kompletní příklad
Jednoduchý SMA kreslený do hlavního okna. V OnCalculate jsou pole standardně indexovaná od nejstaršího prvku.
Tip: Pro vícenásobné vykreslení (šipky, pásma, histogram) zvyšte indicator_buffers / indicator_plots a použijte DRAW_ARROW, DRAW_HISTOGRAM, DRAW_FILLING atd.
25. Kompletní EA – křížení EMA s řízením rizika
Funkční šablona, která spojuje nové svíčky, indikátory, filtr spreadu, ATR stop-loss, výpočet lotu podle rizika a CTrade. Slouží jako základ pro vlastní strategie – není to obchodní doporučení a před reálným nasazením ji důkladně otestujte.
26. Tahák a nejčastější chyby
Rychlé srovnání MQL4 → MQL5
| MQL4 | MQL5 |
start() | OnTick() |
Ask, Bid | SymbolInfoDouble(_Symbol, SYMBOL_ASK / SYMBOL_BID) |
iMA(...) vrací hodnotu | iMA(...) vrací handle → CopyBuffer |
Close[i], High[i] | CopyClose, CopyHigh, iClose, MqlRates |
OrderSend(…) s parametry | OrderSend(MqlTradeRequest, MqlTradeResult) nebo CTrade |
OrdersTotal() – vše | PositionsTotal() pozice + OrdersTotal() jen pending |
MarketInfo(sym, MODE_…) | SymbolInfoDouble/Integer/String |
OrderSelect(i, …) | PositionGetTicket(i) / OrderGetTicket(i) |
Nejčastější chyby a jejich řešení
| Problém | Příčina / řešení |
| EA neobchoduje, v Journalu nic | Vypnuté tlačítko Algo Trading nebo nezaškrtnuté „Povolit algoritmické obchodování“ v dialogu EA. |
invalid stops (10016) | SL/TP příliš blízko, nebo špatná strana. Respektujte SYMBOL_TRADE_STOPS_LEVEL, ceny normalizujte. |
invalid volume (10014) | Lot mimo VOLUME_MIN/MAX nebo nenásobek VOLUME_STEP. |
unsupported filling mode (10030) | Nastavte typ plnění podle SYMBOL_FILLING_MODE. |
| Indikátor vrací samé nuly / −1 | Data ještě nejsou spočítána – zkontrolujte návrat CopyBuffer; neměňte indexaci bez ArraySetAsSeries. |
| Obchod při každém ticku | Chybí kontrola nové svíčky nebo existující pozice. |
| Hodnoty „o svíčku vedle“ | Záměna shiftu 0 (neuzavřená) a 1 (uzavřená svíčka). |
WebRequest vrací −1 | URL není povolena v Možnosti → Expert Advisors (chyba 4014). |
| Rozdílné výsledky v testeru a na účtu | Spread, skluz, plnění a model tiků; testujte na reálných tikách a se skutečným spreadem. |
| Únik paměti při ukončení | Objekty vytvořené přes new nebyly smazány (delete). |
| Špatná velikost pozice u 3/5místných brokerů | Pracujte s _Point, SYMBOL_TRADE_TICK_SIZE, nikoliv s pevným „pipem“. |
Doporučené zásady
- Indikátorové handle vytvářejte v
OnInit, uvolňujte v OnDeinit.
- Každé volání, které může selhat (
CopyBuffer, OrderSend, WebRequest, FileOpen), kontrolujte a logujte chybový kód.
- Vše, co souvisí s cenou, normalizujte (
NormalizeDouble / tick size).
- Svá data a objekty označujte magic numberem a prefixem, aby EA nesahal na cizí pozice.
- Rozhodování stavte na uzavřených svíčkách (shift ≥ 1), pokud nepotřebujete reakci na každý tick.
- Před živým nasazením ověřte EA na demo účtu a v testeru s reálnými ticky.
Oficiální zdroj: Úplná dokumentace jazyka je dostupná v MetaEditoru (F1) a na webu MQL5 (www.mql5.com/en/docs). Tato příručka je stručný přehled nejpoužívanějších funkcí.