Skip to content

trading_agent.doctor.checks.desk_loss_limits_check

Lists each desk's own daily loss limit, or says plainly that only the account's limits apply.

Typical usage example:

result = DeskLossLimitsCheck(layout.trading_rules_file, ['intraday']).run()

DeskLossLimitsCheck 

DeskLossLimitsCheck(rules_file, desk_names)

Bases: DoctorCheck

Reports the desks' daily loss limits.

Creates the check.

Parameters:

Name Type Description Default
rules_file Path

TradingRules.md.

 required
desk_names Sequence[str]

The desks.

 required
Source code in src/trading_agent/doctor/checks/desk_loss_limits_check.py 
20
21
22
23
24
25
26
27
28
def __init__(self, rules_file: Path, desk_names: Sequence[str]):
    """Creates the check.

    Args:
        rules_file (Path): TradingRules.md.
        desk_names (Sequence[str]): The desks.
    """
    self._rules_file = rules_file
    self._desk_names = list(desk_names)

run 

run()

Reads the limits.

Returns:

Type Description
CheckResult

OK with each desk's limit or the note that none is set; failed when the limits cannot be read.
Source code in src/trading_agent/doctor/checks/desk_loss_limits_check.py 
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
def run(self) -> doctor_check.CheckResult:
    """Reads the limits.

    Returns:
        doctor_check.CheckResult: OK with each desk's limit or the note that none is set; failed when the limits cannot be read.
    """
    try:
        limits = trading_limits.TradingLimitsReader(self._rules_file).read()
    except trading_limits.LimitsError as error:
        return doctor_check.CheckResult(
            doctor_check.CheckStatus.FAILED, str(error)
        )
    parts = []
    for desk_name in self._desk_names:
        desk = limits.desks.get(desk_name)
        if desk is not None and desk.daily_loss_limit_percent is not None:
            parts.append(f'{desk_name} {desk.daily_loss_limit_percent:g}%')
    account = limits.account
    account_text = f'the account stops at {account.daily_loss_limit_percent:g}% a day and {account.weekly_loss_limit_percent:g}% a week'
    if not parts:
        return doctor_check.CheckResult(
            doctor_check.CheckStatus.OK,
            f'No desk has its own limit (your choice on 17 October 2026); {account_text}.',
        )
    return doctor_check.CheckResult(
        doctor_check.CheckStatus.OK,
        f'{", ".join(parts)}; {account_text}.',
    )