- Basic concepts of the calendar
- Getting the list and descriptions of available countries
- Querying event types by country and currency
- Getting event descriptions by ID
- Getting event records by country or currency
- Getting event records of a specific type
- Reading event records by ID
- Tracking event changes by country or currency
- Tracking event changes by type
- Filtering events by multiple conditions
- Transferring calendar database to tester
- Calendar trading
Getting the list and descriptions of available countries
You can get a complete list of countries for which events are broadcast on the calendar using the CalendarCountries function.
int CalendarCountries(MqlCalendarCountry &countries[])
The function fills the countries array passed by reference with MqlCalendarCountry structures. The array can be dynamic or fixed, of sufficient size.
On success, the function returns the number of country descriptions received from the server or 0 on error. Among the possible error codes in _LastError we may find, in particular, 5401 (ERR_CALENDAR_TIMEOUT, request time limit exceeded) or 5400 (ERR_CALENDAR_MORE_DATA, if the size of the fixed array is insufficient to obtain descriptions of all countries). In the latter case, the system will copy only what fits.
Let's write a simple script CalendarCountries.mq5, which gets the full list of countries and logs it out.
void OnStart()
|
Here is an example result.
CalendarCountries(countries)=23 / ok
|
It is important to note that the identifier 0 (code "WW" and pseudo-currency "ALL") corresponds to global events (concerning many countries, for example, the G7, G20 meetings), and the currency "EUR" is associated with several EU countries available in the calendar (as you can see, not the entire Eurozone is presented). Also, the European Union itself has a generic identifier 999.
If you are interested in a particular country, you can check its availability by a numerical code according to the ISO 3166-1 standard. In particular, in the log above, these codes are displayed in the first column (field id).
To get a description of one country by its ID specified in the id parameter, you can use the CalendarCountryById function.
bool CalendarCountryById(const long id, MqlCalendarCountry &country)
If successful, the function will return true and fill in the fields of the country structure.
If the country is not found, we get false, and in _LastError we will get an error code 5402 (ERR_CALENDAR_NO_DATA).
For an example of using this function, see Getting event records by country or currency.