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ů

TypPřípona zdrojeSložka v MQL5\Popis
Expert Advisor (EA).mq5ExpertsBěží na grafu, reaguje na ticky a události, obchoduje.
Indikátor.mq5IndicatorsPočítá a kreslí data, nesmí obchodovat.
Skript.mq5ScriptsJednorázové provedení (OnStart), pak skončí.
Služba.mq5ServicesBěží na pozadí bez grafu.
Include.mqhIncludeZnovupoužitelný kód (třídy, funkce).
Knihovna.mq5 / .ex5LibrariesSdí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

DirektivaVýznam
#property copyright "text"Autor zobrazený v dialogu programu.
#property version "1.00"Verze (formát major.minor).
#property script_show_inputsSkript zobrazí dialog s parametry před startem.
#property indicator_chart_windowIndiká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 hodnotaMakro / konstanta.
#ifdef / #ifndef / #endifPodmíněný překlad.
#import "knihovna.dll"Import funkcí z DLL / EX5 knihovny.

Předdefinovaná makra: __FILE__, __LINE__, __FUNCTION__, __DATE__, __MQLBUILD__.

3. Datové typy

TypVelikostRozsah / poznámka
bool1 Btrue / false
char / uchar1 B−128…127 / 0…255
short / ushort2 B−32 768…32 767 / 0…65 535
int / uint4 B±2,1 mld. / 0…4,29 mld.
long / ulong8 Btickety, magic number, volume
float4 B~7 platných číslic
double8 B~15 platných číslic (ceny, loty)
stringproměnnáUnicode (UTF-16)
datetime8 Bsekundy od 1. 1. 1970
color4 BclrRed, C'255,128,0', 0x0000FF (BGR!)
enum4 Bvýč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
_SymbolSymbol aktuálního grafu ("EURUSD")
_PeriodTimeframe grafu (PERIOD_M5)
_PointVelikost bodu (např. 0.00001)
_DigitsPočet desetinných míst ceny
_LastErrorKód poslední chyby
_StopFlagProgram 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

FunkcePopis
MathAbs, MathMax, MathMinabsolutní hodnota, maximum, minimum
MathFloor, MathCeil, MathRoundzaokrouhlení dolů / nahoru / běžné
MathPow, MathSqrt, MathExp, MathLog, MathLog10mocnina, odmocnina, exp., logaritmy
MathSin, MathCos, MathTan, MathArctangoniometrické 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í

FunkcePlatí proKdy se volá
int OnInit()EA, indikátorStart / změna parametrů / změna symbolu či periody
void OnDeinit(const int reason)EA, indikátorUkončení programu
void OnTick()EANový tick symbolu grafu
void OnStart()skript, službaJediný vstupní bod
int OnCalculate(...)indikátorNový tick / změna historie
void OnTimer()EA, indikátorPo EventSetTimer()
void OnTrade()EAJakákoliv změna na obchodním účtu
void OnTradeTransaction(...)EADetailní obchodní transakce
void OnChartEvent(...)EA, indikátorKlik, klávesa, interakce s objekty
void OnBookEvent(const string &symbol)EA, indikátorZměna Depth of Market
double OnTester()EAKonec testu – vlastní optimalizační kritérium

Časovač

Události grafu

Důvody ukončení (OnDeinit)

KonstantaVýznam
REASON_REMOVEProgram odstraněn z grafu
REASON_CHARTCHANGEZměna symbolu nebo periody
REASON_PARAMETERSZměna vstupních parametrů
REASON_RECOMPILEPřekompilování programu
REASON_CLOSEZavření terminálu
REASON_ACCOUNTPř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átVýznam
%d / %icelé číslo se znaménkem
%ucelé číslo bez znaménka (uint, ulong s %I64u)
%f, %.2fdesetinné číslo
%sřetězec
%xhexadecimálně
%cznak
%I64dlong (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

KonstantaPeriodaKonstantaPerioda
PERIOD_M11 minPERIOD_H11 hod
PERIOD_M55 minPERIOD_H44 hod
PERIOD_M1515 minPERIOD_D11 den
PERIOD_M3030 minPERIOD_W1 / MN1tý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ů

FunkceParametryBuffery
iMAsymbol, tf, period, ma_shift, ma_method, applied_price0 = MA
iRSIsymbol, tf, period, applied_price0 = RSI
iATRsymbol, tf, period0 = ATR
iMACDsymbol, tf, fast, slow, signal, applied_price0 = MACD, 1 = signál
iBandssymbol, tf, period, shift, deviation, applied_price0 = střed, 1 = horní, 2 = dolní
iStochasticsymbol, tf, K, D, slowing, ma_method, price_field0 = %K, 1 = %D
iCCIsymbol, tf, period, applied_price0 = CCI
iADXsymbol, tf, period0 = ADX, 1 = +DI, 2 = −DI
iCustomsymbol, tf, "cesta\\název", parametry…podle indikátoru
ENUM_MA_METHODENUM_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_ACTIONSPoužití
TRADE_ACTION_DEALTržní příkaz (otevření / zavření)
TRADE_ACTION_PENDINGZadání pending příkazu
TRADE_ACTION_SLTPZměna SL/TP otevřené pozice
TRADE_ACTION_MODIFYZměna pending příkazu
TRADE_ACTION_REMOVESmazání pending příkazu
TRADE_ACTION_CLOSE_BYUzavř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ódKonstantaVýznam / řešení
10004REQUOTECena se změnila – zvyšte deviation nebo zopakujte.
10006REJECTServer žádost odmítl.
10008PLACEDPending příkaz zadán (OK).
10009DONEProvedeno (OK).
10013INVALIDNeplatná žádost – zkontrolujte pole struktury.
10014INVALID_VOLUMEŠpatný lot (min/max/step).
10015INVALID_PRICEŠpatná cena – normalizujte na _Digits.
10016INVALID_STOPSSL/TP příliš blízko (stops level) nebo na špatné straně.
10017TRADE_DISABLEDObchodování je pro symbol vypnuto.
10018MARKET_CLOSEDTrh je zavřený.
10019NO_MONEYNedostatek volné marže.
10024TOO_MANY_REQUESTSPříliš častá volání – zpomalte.
10025NO_CHANGESŽádná změna (SL/TP už mají zadané hodnoty).
10027CLIENT_DISABLES_ATAlgo Trading vypnut v terminálu (tlačítko / nastavení).
10029FROZENPříkaz je „zmrazený“ (freeze level).
10030INVALID_FILLNepodporovaný typ plnění.
10031NO_CONNECTIONBez spojení se serverem.
10033LIMIT_ORDERSDosažen limit počtu příkazů.
10034LIMIT_VOLUMEDosažen limit objemu pro symbol.
10036POSITION_CLOSEDPozice 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řídaIncludeÚč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

MetodaVý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

ObjektPopis
OBJ_HLINE, OBJ_VLINE, OBJ_TRENDČáry
OBJ_RECTANGLE, OBJ_TRIANGLEObrazce
OBJ_TEXTText ukotvený k ceně a času
OBJ_LABELText ukotvený k pixelům grafu
OBJ_BUTTON, OBJ_EDIT, OBJ_RECTANGLE_LABELPrvky ovládacího panelu
OBJ_ARROW_UP/DOWN/BUY/SELLZnač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ódKonstantaVýznam
4014ERR_FUNCTION_NOT_ALLOWEDFunkce není povolena (typicky WebRequest bez povolení URL)
4301ERR_MARKET_UNKNOWN_SYMBOLNeznámý symbol
4401ERR_HISTORY_NOT_FOUNDPožadovaná historie nenalezena
4806ERR_INDICATOR_DATA_NOT_FOUNDData indikátoru ještě nejsou k dispozici
5004ERR_CANNOT_OPEN_FILESoubor 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

MQL4MQL5
start()OnTick()
Ask, BidSymbolInfoDouble(_Symbol, SYMBOL_ASK / SYMBOL_BID)
iMA(...) vrací hodnotuiMA(...) vrací handle → CopyBuffer
Close[i], High[i]CopyClose, CopyHigh, iClose, MqlRates
OrderSend(…) s parametryOrderSend(MqlTradeRequest, MqlTradeResult) nebo CTrade
OrdersTotal() – všePositionsTotal() 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émPříčina / řešení
EA neobchoduje, v Journalu nicVypnuté 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 / −1Data ještě nejsou spočítána – zkontrolujte návrat CopyBuffer; neměňte indexaci bez ArraySetAsSeries.
Obchod při každém tickuChybí 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í −1URL není povolena v Možnosti → Expert Advisors (chyba 4014).
Rozdílné výsledky v testeru a na účtuSpread, 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í.