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)
|