SessionClock
- Bibliotecas
-
Shipra Gupta
Sou Shipra Gupta, trader e desenvolvedora de estratégias quantitativas com sólida formação em matemática, economia e sistemas de trading algorítmico. Ao longo dos anos, trabalhei amplamente nos mercados de forex, ouro, índices, commodities e criptomoedas, focando na construção de estratégias - Versão: 1.0
SessionClock – DST-Aware Broker Clock & Trading Sessions
TimeGMT() returns server time in the Strategy Tester, so most session EAs backtest on the wrong hours around every DST switch. SessionClock fixes that.
Features
- Auto-detect broker – Fits your broker's GMT offset and DST rule (none, US, EU, AU) to weekend opens in price history. Works in the Strategy Tester.
- Live fallback – SC_DetectLive() reads TimeTradeServer() − TimeGMT(). SC_SetBroker() for manual override.
- 7 time zones – UTC, New York, London, Frankfurt, Tokyo, Sydney, Hong Kong, each with its own DST calendar.
- 7 sessions – Sydney, Tokyo, London, Frankfurt, New York, NY cash 09:30–16:00, London/NY overlap.
- Countdowns – Next session open in server time and minutes until it opens.
- Trading day – 17:00 New York rollover key used by FX and index CFDs.
Quick start
1. Buy and download the library. MetaTrader installs it to MQL5\Libraries\SessionClock.ex5.
2. Paste the import block below at the top of your EA, indicator or script.
3. Call the functions.
int OnInit() { if(!SC_DetectFromHistory("EURUSD",17,104)) SC_SetBroker(120,SC_DST_US); Print(SC_Describe()); // Broker GMT+2.0, DST US, fit 100% return(INIT_SUCCEEDED); } void OnTick() { if(SC_IsSessionOpen(SC_SES_NY_CASH,TimeCurrent())) Trade(); }
Import block (copy into your code)
#define SC_DST_NONE 0 #define SC_DST_US 1 #define SC_DST_EU 2 #define SC_DST_AU 3 #define SC_ZONE_UTC 0 #define SC_ZONE_NEWYORK 1 #define SC_ZONE_LONDON 2 #define SC_ZONE_FRANKFURT 3 #define SC_ZONE_TOKYO 4 #define SC_ZONE_SYDNEY 5 #define SC_ZONE_HONGKONG 6 #define SC_ZONE_SERVER 7 #define SC_SES_SYDNEY 0 #define SC_SES_TOKYO 1 #define SC_SES_LONDON 2 #define SC_SES_NEWYORK 3 #define SC_SES_NY_CASH 4 #define SC_SES_LDN_NY 5 #define SC_SES_FRANKFURT 6 #define SC_ERR_NONE 0 #define SC_ERR_PARAM 1 #define SC_ERR_DATA 2 #define SC_ERR_SYMBOL 3 #define SC_ERR_FIT 4 #import "SessionClock.ex5" int SC_LastError(); bool SC_SetBroker(const int base_offset_minutes,const int dst_model); bool SC_DetectFromHistory(const string symbol,const int ny_open_hour,const int weeks); bool SC_DetectLive(); double SC_FitScore(); int SC_BrokerBaseMin(); int SC_BrokerDSTModel(); bool SC_IsReady(); int SC_ServerOffsetMin(const datetime server_time); datetime SC_ServerToUTC(const datetime server_time); datetime SC_UTCToServer(const datetime utc); datetime SC_UTCToZone(const datetime utc,const int zone); datetime SC_ZoneToUTC(const datetime local,const int zone); datetime SC_ServerToZone(const datetime server_time,const int zone); datetime SC_ZoneToServer(const datetime local,const int zone); bool SC_IsDST(const int dst_model,const datetime utc); bool SC_IsSessionOpen(const int session,const datetime server_time); datetime SC_NextSessionOpen(const int session,const datetime server_time); int SC_MinutesToSessionOpen(const int session,const datetime server_time); datetime SC_TradingDay(const datetime server_time,const int ny_roll_hour); string SC_ZoneName(const int zone); string SC_Describe(); #import
Notes
- Use any 24/5 reference symbol. FX majors open 17:00 New York; most index CFDs open 18:00.
- Tested on a GMT+2/+3 New-York-close broker feed: 105 of 105 weekend opens matched.
- The reference symbol is an input, never hard-coded.
Technical
- Pure MQL5. No DLL, no WebRequest, no file I/O.
- Every exported function validates its inputs. SC_LastError() returns the reason for any failed call.
- Works in the Strategy Tester and live, on any broker, symbol and account currency.
Past performance shown in screenshots is from historical data and does not guarantee future results.
