mirror of
https://github.com/Ichinga-Samuel/aiomql.git
synced 2026-08-14 12:28:06 +00:00
136 lines
2.8 KiB
Markdown
136 lines
2.8 KiB
Markdown
## <a id="order"></a> Order
|
|||
|
|
|
||
|
|
|
||
|
|
```python
|
||
|
|
class Order(TradeRequest)
|
||
|
|
```
|
||
|
|
Trade order related functions and properties. Subclass of [TradeRequest](#traderequest).
|
||
|
|
|
||
|
|
#### \_\_init\_\_
|
||
|
|
```python
|
||
|
|
def __init__(**kwargs)
|
||
|
|
```
|
||
|
|
Initialize the order object with keyword arguments, symbol must be provided.
|
||
|
|
Provides default values for action, type_time and type_filling if not provided.
|
||
|
|
|
||
|
|
*Arguments*:
|
||
|
|
|
||
|
|
|Name|Type|Description|Default|
|
||
|
|
|---|---|---|---|
|
||
|
|
|**kwargs**|**kwargs**|Keyword arguments must match the attributes of TradeRequest as well as the attributes of Order class as specified in the annotations in the class definition.|None|
|
||
|
|
|
||
|
|
|
||
|
|
*Default Arguments*:
|
||
|
|
|
||
|
|
|Name|Type|Description|Default|
|
||
|
|
|---|---|---|---|
|
||
|
|
|**action**|**TradeAction**|Trade action|TradeAction.DEAL|
|
||
|
|
|**type_time**|**OrderTime**|Order time|OrderTime.DAY|
|
||
|
|
|**type_filling**|**OrderFilling**|Order filling|OrderFilling.FOK|
|
||
|
|
|
||
|
|
*Raises*:
|
||
|
|
|
||
|
|
|Exception|Description|
|
||
|
|
|---|---|
|
||
|
|
|**SymbolError**|If symbol is not provided|
|
||
|
|
|
||
|
|
#### <a id=order.Order.orders_total> orders_total
|
||
|
|
```python
|
||
|
|
async def orders_total()
|
||
|
|
```
|
||
|
|
Get the number of active orders.
|
||
|
|
|
||
|
|
*returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**int**|total number of active orders|
|
||
|
|
|
||
|
|
#### orders
|
||
|
|
```python
|
||
|
|
async def orders() -> tuple[TradeOrder]
|
||
|
|
```
|
||
|
|
Get the list of active orders for the current symbol.
|
||
|
|
|
||
|
|
*Returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**tuple[TradeOrder]**|A Tuple of active trade orders as TradeOrder objects|
|
||
|
|
|
||
|
|
#### check
|
||
|
|
```python
|
||
|
|
async def check() -> OrderCheckResult
|
||
|
|
```
|
||
|
|
Check funds sufficiency for performing a required trading operation and the possibility to execute it at
|
||
|
|
|
||
|
|
*returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderCheckResult**|An OrderCheckResult object|
|
||
|
|
|
||
|
|
*raises*:
|
||
|
|
|
||
|
|
|Exception|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderError**|If not successful|
|
||
|
|
- `OrderError` - If not successful
|
||
|
|
|
||
|
|
#### <a id="order.Order.send"></a> send
|
||
|
|
|
||
|
|
```python
|
||
|
|
async def send() -> OrderSendResult
|
||
|
|
```
|
||
|
|
Send a request to perform a trading operation from the terminal to the trade server.
|
||
|
|
|
||
|
|
*returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderSendResult**|An OrderSendResult object|
|
||
|
|
|
||
|
|
*raises*:
|
||
|
|
|
||
|
|
|Exception|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderError**|If not successful|
|
||
|
|
|
||
|
|
#### <a id="order.Order.calc_margin"></a> calc_margin
|
||
|
|
```python
|
||
|
|
async def calc_margin() -> float
|
||
|
|
```
|
||
|
|
Return the required margin in the account currency to perform a specified trading operation.
|
||
|
|
|
||
|
|
*returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**float**|Returns float value if successful|
|
||
|
|
|
||
|
|
*raises*:
|
||
|
|
|
||
|
|
|Exception|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderError**|If not successful|
|
||
|
|
|
||
|
|
|
||
|
|
#### <a id="order.Order.calc_profit"></a> calc_profit
|
||
|
|
```python
|
||
|
|
async def calc_profit() -> float
|
||
|
|
```
|
||
|
|
Return profit in the account currency for a specified trading operation.
|
||
|
|
|
||
|
|
*returns*:
|
||
|
|
|
||
|
|
|Type|Description|
|
||
|
|
|---|---|
|
||
|
|
|**float**|Returns float value if successful|
|
||
|
|
|
||
|
|
*raises*:
|
||
|
|
|
||
|
|
|Exception|Description|
|
||
|
|
|---|---|
|
||
|
|
|**OrderError**|If not successful|
|
||
|
|
|