aiomql/docs/history.md

History

Table of contents

• History
• __init__
• init
• get_deals
• deals_total
• get_orders
• orders_total

History

class History

The history class handles completed trade deals and trade orders in the trading history of an account.

Attributes

Name	Type	Description	Default
deals	list[TradeDeal]	Iterable of trade deals	[]
orders	list[TradeOrder]	Iterable of trade orders	[]
total_deals	int	Total number of deals	0
total_orders	int	Total number orders	0
group	str	Filter for selecting history by symbols.	""
ticket	int	Filter for selecting history by ticket number	0
position	int	Filter for selecting history deals by position	0
initialized	bool	check if initial request has been sent to the terminal to get history.	False
mt5	MetaTrader	MetaTrader instance	None
config	Config	Config instance	None

__init__

def __init__(*,
             date_from: datetime | float = 0,
             date_to: datetime | float = 0,
             group: str = "",
             ticket: int = 0,
             position: int = 0)

Parameters

Name	Type	Description	Default
date_from	datetime|float	Date the deals are requested from. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Defaults to twenty-four hours from the current time in 'utc'	0
date_to	datetime|float	Date up to which the deals are requested. Set by the 'datetime' object or as a number of seconds elapsed since 1970.01.01. Defaults to the current time in "utc"	0
group	str	Filter for selecting history by symbols.	""
ticket	int	Filter for selecting history by ticket number	0
position	int	Filter for selecting history deals by position	0

init

async def init(deals=True, orders=True) -> bool

Get history deals and orders

Parameters

Name	Type	Description	Default
deals	bool	If true get history deals during initial request to terminal	True
orders	bool	If true get history orders during initial request to terminal	True

Returns

Name	Type	Description	Default
bool	bool	True if all requests were successful else False	False

get_deals

async def get_deals() -> list[TradeDeal]

Get deals from trading history using the parameters set in the constructor.

Returns

Name	Type	Description	Default
deals	list[TradeDeal]	A list of trade deals	[]

deals_total

async def deals_total() -> int

Get total number of deals within the specified period in the constructor.

Returns

Name	Type	Description	Default
total_deals	int	Total number of deals	0

get_orders

async def get_orders() -> list[TradeOrder]

Get orders from trading history using the parameters set in the constructor.

Returns

Name	Type	Description	Default
orders	list[TradeOrder]	A list of trade orders	[]

orders_total

async def orders_total() -> int

Get total number of orders within the specified period in the constructor.

Returns

Name	Type	Description	Default
total_orders	int	Total number orders	0