114 lines
4.7 KiB
Markdown
114 lines
4.7 KiB
Markdown
|
# terminal_info
|
|||
|
|
|
|||
|
|
Get the connected MetaTrader 5 client terminal status and settings.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
terminal_info()
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Return Value
|
|||
|
|
|
|||
|
|
Return info in the form of a named tuple structure (namedtuple). Return None in case of an error. The info on the error can be obtained using [last_error()](/en/docs/python_metatrader5/mt5lasterror_py).
|
|||
|
|
|
|||
|
|
Note
|
|||
|
|
|
|||
|
|
The function returns all data that can be obtained using [TerminalInfoInteger](/en/docs/check/terminalinfointeger), [TerminalInfoDouble](/en/docs/check/terminalinfodouble) and [TerminalInfoDouble](/en/docs/check/terminalinfodouble) in one call.
|
|||
|
|
|
|||
|
|
Example:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
import MetaTrader5 as mt5
|
|||
|
|
import pandas as pd
|
|||
|
|
# display data on the MetaTrader 5 package
|
|||
|
|
print("MetaTrader5 package author: ",mt5.__author__)
|
|||
|
|
print("MetaTrader5 package version: ",mt5.__version__)
|
|||
|
|
# display data on the MetaTrader 5 package
|
|||
|
|
print("MetaTrader5 package author: ",mt5.__author__)
|
|||
|
|
print("MetaTrader5 package version: ",mt5.__version__)
|
|||
|
|
|
|||
|
|
# establish connection to the MetaTrader 5 terminal
|
|||
|
|
if not mt5.initialize():
|
|||
|
|
print("initialize() failed, error code =",mt5.last_error())
|
|||
|
|
quit()
|
|||
|
|
|
|||
|
|
# display data on MetaTrader 5 version
|
|||
|
|
print(mt5.version())
|
|||
|
|
# display info on the terminal settings and status
|
|||
|
|
terminal_info=mt5.terminal_info()
|
|||
|
|
if terminal_info!=None:
|
|||
|
|
# display the terminal data 'as is'
|
|||
|
|
print(terminal_info)
|
|||
|
|
# display data in the form of a list
|
|||
|
|
print("Show terminal_info()._asdict():")
|
|||
|
|
terminal_info_dict = mt5.terminal_info()._asdict()
|
|||
|
|
for prop in terminal_info_dict:
|
|||
|
|
print(" {}={}".format(prop, terminal_info_dict[prop]))
|
|||
|
|
print()
|
|||
|
|
# convert the dictionary into DataFrame and print
|
|||
|
|
df=pd.DataFrame(list(terminal_info_dict.items()),columns=['property','value'])
|
|||
|
|
print("terminal_info() as dataframe:")
|
|||
|
|
print(df)
|
|||
|
|
|
|||
|
|
# shut down connection to the MetaTrader 5 terminal
|
|||
|
|
mt5.shutdown()
|
|||
|
|
|
|||
|
|
|
|||
|
|
Result:
|
|||
|
|
MetaTrader5 package author: MetaQuotes Software Corp.
|
|||
|
|
MetaTrader5 package version: 5.0.29
|
|||
|
|
[500, 2366, '20 Mar 2020']
|
|||
|
|
TerminalInfo(community_account=True, community_connection=True, connected=True,....
|
|||
|
|
Show terminal_info()._asdict():
|
|||
|
|
community_account=True
|
|||
|
|
community_connection=True
|
|||
|
|
connected=True
|
|||
|
|
dlls_allowed=False
|
|||
|
|
trade_allowed=False
|
|||
|
|
tradeapi_disabled=False
|
|||
|
|
email_enabled=False
|
|||
|
|
ftp_enabled=False
|
|||
|
|
notifications_enabled=False
|
|||
|
|
mqid=False
|
|||
|
|
build=2366
|
|||
|
|
maxbars=5000
|
|||
|
|
codepage=1251
|
|||
|
|
ping_last=77850
|
|||
|
|
community_balance=707.10668201585
|
|||
|
|
retransmission=0.0
|
|||
|
|
company=MetaQuotes Software Corp.
|
|||
|
|
name=MetaTrader 5
|
|||
|
|
language=Russian
|
|||
|
|
path=E:\ProgramFiles\MetaTrader 5
|
|||
|
|
data_path=E:\ProgramFiles\MetaTrader 5
|
|||
|
|
commondata_path=C:\Users\Rosh\AppData\Roaming\MetaQuotes\Terminal\Common
|
|||
|
|
|
|||
|
|
terminal_info() as dataframe:
|
|||
|
|
property value
|
|||
|
|
0 community_account True
|
|||
|
|
1 community_connection True
|
|||
|
|
2 connected True
|
|||
|
|
3 dlls_allowed False
|
|||
|
|
4 trade_allowed False
|
|||
|
|
5 tradeapi_disabled False
|
|||
|
|
6 email_enabled False
|
|||
|
|
7 ftp_enabled False
|
|||
|
|
8 notifications_enabled False
|
|||
|
|
9 mqid False
|
|||
|
|
10 build 2367
|
|||
|
|
11 maxbars 5000
|
|||
|
|
12 codepage 1251
|
|||
|
|
13 ping_last 80953
|
|||
|
|
14 community_balance 707.107
|
|||
|
|
15 retransmission 0.063593
|
|||
|
|
16 company MetaQuotes Software Corp.
|
|||
|
|
17 name MetaTrader 5
|
|||
|
|
18 language Russian
|
|||
|
|
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
See also
|
|||
|
|
|
|||
|
|
[initialize](/en/docs/python_metatrader5/mt5initialize_py), [shutdown](/en/docs/python_metatrader5/mt5shutdown_py), [version](/en/docs/python_metatrader5/mt5version_py)
|