Skip to content

trading_agent.terminal.widgets.orders_card

The side panel's Orders and trades card: today's orders placed and cancelled, trades, open orders and stocks held.

The counts of orders and trades come from today's events of the desk, as on the web page; open orders and stocks held come from the gateway.

Typical usage example:

card = OrdersCard() card.show('general', events, open_orders, account)

OrdersCard 

OrdersCard(collapsed=False)

Bases: SideCard

The Orders and trades card.

Creates the card.

Parameters:

Name Type Description Default
collapsed bool

Whether it starts folded.

 False
Source code in src/trading_agent/terminal/widgets/orders_card.py 
20
21
22
23
24
25
26
27
def __init__(self, collapsed: bool = False):
    """Creates the card.

    Args:
        collapsed (bool): Whether it starts folded.
    """
    super().__init__('orders', 'Orders and trades', collapsed=collapsed)
    self.show_aside('today')

show 

show(desk_name, events, open_orders, account)

Shows the counts.

Parameters:

Name Type Description Default
desk_name str

The desk the chat shows.

 required
events Sequence[dict[str, Any]]

The desk's events of today.

 required
open_orders list[dict[str, Any]] | None

The desk's open orders, or None when not known.

 required
account dict[str, Any] | None

The account, or None when not known.

 required
Source code in src/trading_agent/terminal/widgets/orders_card.py 
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
def show(
    self,
    desk_name: str,
    events: Sequence[dict[str, Any]],
    open_orders: list[dict[str, Any]] | None,
    account: dict[str, Any] | None,
) -> None:
    """Shows the counts.

    Args:
        desk_name (str): The desk the chat shows.
        events (Sequence[dict[str, Any]]): The desk's events of today.
        open_orders (list[dict[str, Any]] | None): The desk's open orders, or None when not known.
        account (dict[str, Any] | None): The account, or None when not known.
    """
    placed = 0
    cancelled = 0
    trades = 0
    for event in events:
        payload = event.get('payload') or {}
        if (
            event.get('kind') == 'order'
            and payload.get('action') == 'placed'
        ):
            placed += 1
        if (
            event.get('kind') == 'order'
            and payload.get('action') == 'cancelled'
        ):
            cancelled += 1
        if event.get('kind') == 'fill':
            try:
                filled = float(payload.get('filled_quantity') or 0)
            except TypeError, ValueError:
                filled = 0
            if filled > 0:
                trades += 1
    open_count = '—'
    if open_orders is not None:
        open_count = str(len(open_orders))
    held = '—'
    if account is not None:
        count = 0
        for owner in account.get('owners') or []:
            if owner.get('desk') == desk_name:
                count += 1
        held = str(count)
    self.show_body(
        self.rows(
            [
                (
                    'Orders placed',
                    str(placed),
                ),
                (
                    'Orders cancelled',
                    str(cancelled),
                ),
                (
                    'Trades (fills)',
                    str(trades),
                ),
                (
                    'Open orders',
                    open_count,
                ),
                (
                    'Stocks held',
                    held,
                ),
            ]
        )
    )