ctrader-api-client 0.8.0__tar.gz → 0.9.0__tar.gz

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: ctrader-api-client
-Version: 0.8.0
+Version: 0.9.0
 Summary: API Client to interact with the cTrader Open API spec
 Author-email: Elio <elioachukri@pm.me>
 License-File: LICENSE
@@ -15,6 +15,7 @@ Requires-Dist: anyio>=4.13.0
 Requires-Dist: betterproto[compiler]>=1.2.5
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: tenacity>=9.1.4
+Requires-Dist: tzdata>=2025.2
 Description-Content-Type: text/markdown
 
 # cTrader API Client
@@ -301,6 +302,21 @@ results = await client.symbols.search(account_id, "EUR")
 
 # Get specific symbol
 symbol = await client.symbols.get_by_id(account_id, symbol_id)
+
+# The commission rate comes with the type that says what the rate counts
+commission = symbol.commission
+print(f"{commission.rate} ({commission.type.value}), min {commission.minimum}")
+
+# Trading hours arrive with the symbol, so this costs no extra request
+hours = symbol.trading_hours
+if hours.is_open():
+    print(f"Open, closes at {hours.next_close()}")
+else:
+    print(f"Closed, opens at {hours.next_open()}")
+
+# Sessions for a given day, with broker holidays already applied
+for session in hours.sessions_on(date(2026, 6, 19)):
+    print(session.start, "->", session.end)
 ```
 
 ### Account Information

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/README.md

@@ -282,6 +282,21 @@ results = await client.symbols.search(account_id, "EUR")
 
 # Get specific symbol
 symbol = await client.symbols.get_by_id(account_id, symbol_id)
+
+# The commission rate comes with the type that says what the rate counts
+commission = symbol.commission
+print(f"{commission.rate} ({commission.type.value}), min {commission.minimum}")
+
+# Trading hours arrive with the symbol, so this costs no extra request
+hours = symbol.trading_hours
+if hours.is_open():
+    print(f"Open, closes at {hours.next_close()}")
+else:
+    print(f"Closed, opens at {hours.next_open()}")
+
+# Sessions for a given day, with broker holidays already applied
+for session in hours.sessions_on(date(2026, 6, 19)):
+    print(session.start, "->", session.end)
 ```
 
 ### Account Information

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/docs/api/enums.md

@@ -69,6 +69,16 @@ from ctrader_api_client import ExecutionType, OrderSide, OrderType
       show_source: false
       members: true
 
+::: ctrader_api_client.enums.CommissionType
+    options:
+      show_source: false
+      members: true
+
+::: ctrader_api_client.enums.MinCommissionType
+    options:
+      show_source: false
+      members: true
+
 ## Market Data Enums
 
 ::: ctrader_api_client.enums.TrendbarPeriod

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/docs/api/models.md

@@ -130,6 +130,86 @@ partial_close = ClosePositionRequest(
       show_source: false
 
 
+::: ctrader_api_client.models.Commission
+    options:
+      show_source: false
+
+**Example:**
+
+A broker states a commission as a rate and a type. The type says what the rate counts, so
+you must read the two together. The rate alone is meaningless: `2.5` is 2.50 USD per lot
+under one type and 2.5% of the traded value under another.
+
+```python
+from decimal import Decimal
+
+from ctrader_api_client import CommissionType, Symbol
+
+
+def commission_per_side(symbol: Symbol, lots: Decimal, price: Decimal) -> Decimal:
+    """Commission for one side of a trade.
+
+    The result is in USD for the two USD types, and in the symbol's quote currency
+    for QUOTE_CCY_PER_LOT.
+    """
+    # lot_size counts hundredths of a base unit, so 100 gives the contract size.
+    notional = lots * symbol.lot_size / 100 * price
+
+    match symbol.commission.type:
+        case CommissionType.USD_PER_MILLION_USD:
+            return symbol.commission.rate * notional / 1_000_000
+        case CommissionType.USD_PER_LOT | CommissionType.QUOTE_CCY_PER_LOT:
+            return symbol.commission.rate * lots
+        case CommissionType.PERCENTAGE_OF_VALUE:
+            return symbol.commission.rate / 100 * notional
+
+
+# Symbol IDs belong to the broker's server, so look yours up with symbols.search().
+gold = await client.symbols.get_by_id(account_id, 41)
+
+# 0.0007 (PERCENTAGE_OF_VALUE), a lot of 100 ounces
+print(gold.commission.rate, gold.commission.type.value)
+
+# 3.07689900 USD for 1 lot at 4395.57, which the broker charges as 3.08
+print(commission_per_side(gold, Decimal(1), Decimal("4395.57")))
+```
+
+These rates come from one live broker, and show how far the types differ:
+
+| Symbol | Type | Rate | Charge per side, for one lot |
+|--------|------|------|------------------------------|
+| EURUSD | `USD_PER_LOT` | 2.5 | 2.50 USD, at any price |
+| XAUUSD | `PERCENTAGE_OF_VALUE` | 0.0007 | 3.08 USD, at a price of 4395.57 |
+| BTCUSD | `PERCENTAGE_OF_VALUE` | 0.0325 | 20.89 USD, at a price of 64286.15 |
+
+The broker charges the commission per side, so a round turn costs twice as much.
+
+`minimum` is the smallest commission the broker charges for one trade. Apply it only when
+its currency matches your charge: `minimum_type` tells you whether `minimum` is in the
+symbol's quote currency, or in the currency that `minimum_asset` names. A `minimum` of 0
+means the broker sets no minimum.
+
+
+::: ctrader_api_client.models.TradingHours
+    options:
+      show_source: false
+
+
+::: ctrader_api_client.models.TradingSession
+    options:
+      show_source: false
+
+
+::: ctrader_api_client.models.ScheduleInterval
+    options:
+      show_source: false
+
+
+::: ctrader_api_client.models.Holiday
+    options:
+      show_source: false
+
+
 ::: ctrader_api_client.models.Account
     options:
       show_source: false

ctrader_api_client-0.9.0/docs/api/symbols.md

@@ -0,0 +1,172 @@
+# Symbols API
+
+Symbol information lookup and search operations.
+
+Access via `client.symbols`.
+
+## SymbolsAPI
+
+::: ctrader_api_client.api.SymbolsAPI
+    options:
+      show_source: false
+      members:
+        - list_all
+        - get_by_ids
+        - get_by_id
+        - search
+
+## Usage Examples
+
+### List All Symbols
+
+```python
+# Get lightweight info for all symbols
+symbols = await client.symbols.list_all(account_id)
+
+for sym in symbols:
+    print(f"{sym.symbol_id}: {sym.name}")
+```
+
+### Get Symbol by ID
+
+```python
+# Get full symbol details
+symbol = await client.symbols.get_by_id(account_id, 270)
+
+print(f"Digits: {symbol.digits}")
+print(f"Lot size: {symbol.lot_size}")
+print(f"Min volume: {symbol.min_volume}")
+print(f"Max volume: {symbol.max_volume}")
+```
+
+### Get Multiple Symbols
+
+```python
+symbols = await client.symbols.get_by_ids(account_id, [270, 271, 272])
+
+for sym in symbols:
+    print(f"{sym.name}: {sym.digits} digits, lot_size={sym.lot_size}")
+```
+
+### Search Symbols
+
+```python
+# Find all EUR pairs
+eur_pairs = await client.symbols.search(account_id, "EUR")
+
+for sym in eur_pairs:
+    print(sym.name)
+```
+
+## Commission
+
+A broker states a commission as a rate and a type. The type says what the rate counts, so
+you must read the two together. The same rate of `35` is 35 USD per million USD of volume
+for one symbol, and 35 USD per lot for another.
+
+```python
+from ctrader_api_client import CommissionType
+
+symbol = await client.symbols.get_by_id(account_id, 270)
+commission = symbol.commission
+
+print(f"{commission.rate} ({commission.type.value})")
+print(f"Minimum: {commission.minimum} {commission.minimum_asset}")
+```
+
+| Type | Meaning of the rate |
+|------|---------------------|
+| `USD_PER_MILLION_USD` | USD per million USD of traded volume. Usual for forex. |
+| `USD_PER_LOT` | USD per lot. Usual for commodity and index CFDs and futures. |
+| `PERCENTAGE_OF_VALUE` | Percent of the traded value. Usual for equities. |
+| `QUOTE_CCY_PER_LOT` | The symbol's quote currency per lot. |
+
+The broker charges the commission per side, so a round turn costs twice the rate. The
+charge lands in USD for the first two types, and in the symbol's quote currency for
+`QUOTE_CCY_PER_LOT`. Convert to your deposit currency yourself. See
+[Models](models.md#ctrader_api_client.models.Commission) for the arithmetic of each type,
+and for how to apply `minimum`.
+
+## Trading Hours
+
+Every `Symbol` arrives with its trading calendar attached, so asking when a symbol is open
+costs no extra request:
+
+```python
+from datetime import date
+
+symbol = await client.symbols.get_by_id(account_id, 270)
+hours = symbol.trading_hours
+
+if hours.is_open():
+    print("open now, closes at", hours.next_close())
+else:
+    print("closed, opens at", hours.next_open())
+
+for session in hours.sessions_on(date(2026, 6, 19)):
+    print(session.start, "->", session.end, f"({session.duration})")
+```
+
+Sessions are reported in the symbol's own `schedule_timezone` and are never merged, so a
+schedule with a nightly maintenance break reports one session either side of it.
+
+### Holidays
+
+Holidays are closed windows that cut into the weekly schedule rather than replacing a whole
+day. A broker publishing an "early close" sends a window covering the rest of the day, which
+brings the close forward:
+
+```python
+# Regular Friday: 01:05 - 23:50. With a 20:00 early close holiday:
+hours.sessions_on(date(2026, 6, 19))  # -> one session, 01:05 - 20:00
+
+hours.holidays_on(date(2026, 6, 19))  # -> the holiday responsible
+```
+
+A holiday carries **its own** timezone, which is not always the symbol's. A closure defined in
+a timezone an hour behind the symbol's straddles two of the symbol's calendar days, and both
+are shortened accordingly.
+
+A holiday whose window is empty (`start_second >= end_second`, which brokers send as `0`/`0`)
+closes the entire day.
+
+### Trading mode is separate
+
+`is_open()` answers the calendar question only. A symbol can be closed to trading by its
+`trading_mode` while the schedule says it is open, so check both:
+
+```python
+tradable = hours.is_open() and symbol.trading_mode == TradingMode.ENABLED
+```
+
+### Staleness
+
+Schedules arrive only with a symbol fetch, so a long-lived `Symbol` can drift. Subscribe to
+`SymbolChangedEvent` and re-fetch when the server reports a change. The API exposes no
+historical schedules — what you receive is the current configuration.
+
+## Volume Conversion
+
+The cTrader API uses volume in "cents" (smallest volume units). The relationship between lots and volume depends on the symbol's `lot_size`:
+
+```python
+symbol = await client.symbols.get_by_id(account_id, 270)
+
+# Lots to volume (for placing orders)
+volume = symbol.lots_to_volume(1.0)    # e.g., 10000000 for standard forex
+
+# Volume to lots (for display)
+lots = symbol.volume_to_lots(10000000)   # e.g., 1.0 for standard forex
+```
+
+**Note:** Different instruments have different lot sizes. Always use the symbol's methods for conversion:
+
+```python
+# Standard forex (lot_size=100000)
+forex_symbol = await client.symbols.get_by_id(account_id, 1)  # EURUSD (lot_size=10000000)
+forex_volume = forex_symbol.lots_to_volume(0.1)  # 1000000
+
+# Index CFD might have different lot_size
+index_symbol = await client.symbols.get_by_id(account_id, 270)  # US500 (lot_size=100)
+index_volume = index_symbol.lots_to_volume(0.1)  # 10
+```

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ctrader-api-client"
-version = "0.8.0"
+version = "0.9.0"
 description = "API Client to interact with the cTrader Open API spec"
 readme = "README.md"
 authors = [
@@ -20,6 +20,9 @@ dependencies = [
     "betterproto[compiler]>=1.2.5",
     "pydantic>=2.12.5",
     "tenacity>=9.1.4",
+    # Windows ships no system IANA database, which ZoneInfo needs to resolve the
+    # broker-supplied timezones that trading schedules are expressed in.
+    "tzdata>=2025.2",
 ]
 
 [build-system]

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/src/ctrader_api_client/__init__.py

@@ -50,8 +50,10 @@ from .enums import (
     AccessRights,
     AccountType,
     AuthTrigger,
+    CommissionType,
     DealStatus,
     ExecutionType,
+    MinCommissionType,
     OrderSide,
     OrderStatus,
     OrderType,
@@ -99,6 +101,7 @@ from .exceptions import (
     TokenExpiredError,
     TokenRefreshError,
     UnknownPayloadTypeError,
+    UnknownTimezoneError,
 )
 from .models import (
     Account,
@@ -107,14 +110,19 @@ from .models import (
     AmendPositionRequest,
     CloseDetail,
     ClosePositionRequest,
+    Commission,
     Deal,
+    Holiday,
     NewOrderRequest,
     Order,
     Position,
     PositionUnrealizedPnL,
+    ScheduleInterval,
     Symbol,
     SymbolInfo,
     TickData,
+    TradingHours,
+    TradingSession,
     Trendbar,
 )
 
@@ -145,6 +153,8 @@ __all__ = [
     "ClientDisconnectEvent",
     "CloseDetail",
     "ClosePositionRequest",
+    "Commission",
+    "CommissionType",
     "Deal",
     "DealStatus",
     "DepthEvent",
@@ -154,8 +164,10 @@ __all__ = [
     "ExecutionEvent",
     "ExecutionType",
     "FramingError",
+    "Holiday",
     "MarginCallTriggerEvent",
     "MarginChangeEvent",
+    "MinCommissionType",
     "NewOrderRequest",
     "Order",
     "OrderErrorEvent",
@@ -170,6 +182,7 @@ __all__ = [
     "ReauthPolicy",
     "ReconnectedEvent",
     "RefreshPolicy",
+    "ScheduleInterval",
     "SpotEvent",
     "StopTriggerMethod",
     "SubscriptionRestoreFailedEvent",
@@ -184,9 +197,12 @@ __all__ = [
     "TokenRefreshFailedEvent",
     "TokenStore",
     "TraderUpdateEvent",
+    "TradingHours",
     "TradingMode",
+    "TradingSession",
     "TrailingStopChangedEvent",
     "Trendbar",
     "TrendbarPeriod",
     "UnknownPayloadTypeError",
+    "UnknownTimezoneError",
 ]

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/src/ctrader_api_client/enums.py

@@ -117,6 +117,35 @@ class TradingMode(Enum):
     CLOSE_ONLY = "CLOSE_ONLY"
 
 
+class CommissionType(Enum):
+    """Unit a symbol's commission rate is expressed in.
+
+    The rate is a plain number. This type tells you what the number counts.
+    """
+
+    USD_PER_MILLION_USD = "USD_PER_MILLION_USD"
+    """USD per million USD of traded volume. Usual for forex."""
+
+    USD_PER_LOT = "USD_PER_LOT"
+    """USD per lot. Usual for commodity and index CFDs and futures."""
+
+    PERCENTAGE_OF_VALUE = "PERCENTAGE_OF_VALUE"
+    """Percent of the traded value. Usual for equities."""
+
+    QUOTE_CCY_PER_LOT = "QUOTE_CCY_PER_LOT"
+    """The symbol's quote currency per lot."""
+
+
+class MinCommissionType(Enum):
+    """Currency a symbol's minimum commission is expressed in."""
+
+    CURRENCY = "CURRENCY"
+    """The currency named by the minimum commission asset."""
+
+    QUOTE_CURRENCY = "QUOTE_CURRENCY"
+    """The symbol's quote currency."""
+
+
 class TrendbarPeriod(Enum):
     """Trendbar/candle period."""
 

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/src/ctrader_api_client/exceptions.py

@@ -255,6 +255,28 @@ class APIError(CTraderError):
         )
 
 
+# =============================================================================
+# Data Errors
+# =============================================================================
+
+
+class UnknownTimezoneError(CTraderError):
+    """A timezone named by the server is not in the IANA database.
+
+    Trading schedules are broker-supplied wall clock time, so a timezone that
+    cannot be resolved leaves every session boundary meaningless. This should
+    never happen: if it does, the broker has published a symbol whose schedule
+    timezone is misconfigured, and the schedule cannot be interpreted at all.
+    """
+
+    def __init__(self, name: str) -> None:
+        self.name = name
+        super().__init__(
+            f"Unknown schedule timezone {name!r}. This should never happen; it means the broker "
+            f"published a symbol whose schedule timezone is not a valid IANA name."
+        )
+
+
 # =============================================================================
 # Protocol Errors
 # =============================================================================

{ctrader_api_client-0.8.0 → ctrader_api_client-0.9.0}/src/ctrader_api_client/models/__init__.py

@@ -24,12 +24,14 @@ Example:
 """
 
 from .account import Account, AccountSummary
+from .commission import Commission
 from .deal import CloseDetail, Deal
 from .market_data import TickData, Trendbar
 from .order import Order
 from .position import Position, PositionUnrealizedPnL
 from .requests import AmendOrderRequest, AmendPositionRequest, ClosePositionRequest, NewOrderRequest
 from .symbol import Symbol, SymbolInfo
+from .trading_hours import Holiday, ScheduleInterval, TradingHours, TradingSession
 
 
 __all__ = [
@@ -39,13 +41,18 @@ __all__ = [
     "AmendPositionRequest",
     "CloseDetail",
     "ClosePositionRequest",
+    "Commission",
     "Deal",
+    "Holiday",
     "NewOrderRequest",
     "Order",
     "Position",
     "PositionUnrealizedPnL",
+    "ScheduleInterval",
     "Symbol",
     "SymbolInfo",
     "TickData",
+    "TradingHours",
+    "TradingSession",
     "Trendbar",
 ]

ctrader_api_client-0.9.0/src/ctrader_api_client/models/commission.py

@@ -0,0 +1,148 @@
+"""What a broker charges to trade a symbol.
+
+The server sends a commission as a number and a type, and the type decides what
+the number means. The same rate of ``35`` is 35 USD per million USD of volume for
+one symbol and 35 USD per lot for another. A rate read without its type is
+meaningless, so both travel together here.
+
+The server sends each amount twice: once in a deprecated field, and once in a
+scaled ``precise`` field that carries more decimal places. The precise field wins
+where the broker sets it. Brokers that still publish only the deprecated fields
+keep working.
+"""
+
+from __future__ import annotations
+
+from decimal import Decimal
+from typing import TYPE_CHECKING
+
+from .._internal.proto import ProtoOACommissionType, ProtoOAMinCommissionType
+from ..enums import CommissionType, MinCommissionType
+from ._base import FrozenModel
+
+
+if TYPE_CHECKING:
+    from .._internal.proto import ProtoOASymbol
+
+
+_COMMISSION_TYPE_MAP: dict[int, CommissionType] = {
+    ProtoOACommissionType.USD_PER_MILLION_USD: CommissionType.USD_PER_MILLION_USD,
+    ProtoOACommissionType.USD_PER_LOT: CommissionType.USD_PER_LOT,
+    ProtoOACommissionType.PERCENTAGE_OF_VALUE: CommissionType.PERCENTAGE_OF_VALUE,
+    ProtoOACommissionType.QUOTE_CCY_PER_LOT: CommissionType.QUOTE_CCY_PER_LOT,
+}
+
+_MIN_COMMISSION_TYPE_MAP: dict[int, MinCommissionType] = {
+    ProtoOAMinCommissionType.CURRENCY: MinCommissionType.CURRENCY,
+    ProtoOAMinCommissionType.QUOTE_CURRENCY: MinCommissionType.QUOTE_CURRENCY,
+}
+
+# Every amount is an integer scaled by a fixed power of ten. A money amount is
+# scaled by 10^8 in the precise fields and by 10^2 in the deprecated ones, which is
+# why the two differ by 10^6 on the wire. A percentage rate keeps one scale of 10^5
+# in both fields.
+_PRECISE_SCALE = Decimal(10) ** 8
+_DEPRECATED_SCALE = Decimal(10) ** 2
+_PERCENTAGE_SCALE = Decimal(10) ** 5
+
+# The wire format leaves an unset field at 0, and no commission enum has a member
+# there, so 0 means "the broker said nothing" rather than a value.
+_UNSET = 0
+
+# What the server applies when the broker omits the field.
+_DEFAULT_MIN_COMMISSION_ASSET = "USD"
+
+
+class Commission(FrozenModel):
+    """The commission a broker charges to trade one symbol.
+
+    A commission is charged per side, so a round turn costs twice ``rate`` unless
+    the broker states otherwise.
+
+    Attributes:
+        type: What ``rate`` counts. See CommissionType.
+        rate: The commission rate, in the unit its type names. A
+            PERCENTAGE_OF_VALUE rate is a percent, so ``Decimal("0.005")`` means
+            0.005% of the traded value.
+        minimum: The smallest commission the broker charges for one trade, in the
+            currency its type names. 0 means the broker sets no minimum.
+        minimum_type: The currency ``minimum`` is expressed in. See
+            MinCommissionType.
+        minimum_asset: The currency ``minimum`` is expressed in when
+            ``minimum_type`` is CURRENCY.
+
+    Example:
+        ```python
+        from ctrader_api_client import CommissionType
+
+        symbol = await client.symbols.get_by_id(account_id, 270)
+        commission = symbol.commission
+
+        if commission.type is CommissionType.USD_PER_MILLION_USD:
+            charge = commission.rate * notional_usd / 1_000_000
+            print(f"{max(charge, commission.minimum)} USD per side")
+        ```
+    """
+
+    type: CommissionType = CommissionType.USD_PER_MILLION_USD
+    rate: Decimal = Decimal(0)
+    minimum: Decimal = Decimal(0)
+    minimum_type: MinCommissionType = MinCommissionType.CURRENCY
+    minimum_asset: str = _DEFAULT_MIN_COMMISSION_ASSET
+
+    @classmethod
+    def from_proto(cls, proto: ProtoOASymbol) -> Commission:
+        """Create a Commission from a symbol proto message.
+
+        Args:
+            proto: The proto message to read the commission fields from.
+
+        Returns:
+            A new Commission instance.
+        """
+        commission_type = _COMMISSION_TYPE_MAP.get(proto.commission_type, CommissionType.USD_PER_MILLION_USD)
+        return cls(
+            type=commission_type,
+            rate=_rate(proto, commission_type),
+            minimum=_minimum(proto),
+            minimum_type=_MIN_COMMISSION_TYPE_MAP.get(proto.min_commission_type, MinCommissionType.CURRENCY),
+            minimum_asset=proto.min_commission_asset or _DEFAULT_MIN_COMMISSION_ASSET,
+        )
+
+
+def _rate(proto: ProtoOASymbol, commission_type: CommissionType) -> Decimal:
+    """Descale the commission rate, preferring the precise field over the deprecated one.
+
+    A percentage rate is scaled by 10^5 in both fields. Every other rate is money,
+    so it is scaled by 10^8 in the precise field and by 10^2 in the deprecated one.
+
+    Args:
+        proto: The proto message to read the rate from.
+        commission_type: The type the rate is expressed in.
+
+    Returns:
+        The rate in the unit its type names.
+    """
+    if commission_type is CommissionType.PERCENTAGE_OF_VALUE:
+        scaled = proto.precise_trading_commission_rate or proto.commission
+        return Decimal(scaled) / _PERCENTAGE_SCALE
+    if proto.precise_trading_commission_rate != _UNSET:
+        return Decimal(proto.precise_trading_commission_rate) / _PRECISE_SCALE
+    return Decimal(proto.commission) / _DEPRECATED_SCALE
+
+
+def _minimum(proto: ProtoOASymbol) -> Decimal:
+    """Descale the minimum commission, preferring the precise field over the deprecated one.
+
+    A minimum is always money, so it carries the money scales: 10^8 in the precise
+    field and 10^2 in the deprecated one.
+
+    Args:
+        proto: The proto message to read the minimum from.
+
+    Returns:
+        The minimum commission per trade.
+    """
+    if proto.precise_min_commission != _UNSET:
+        return Decimal(proto.precise_min_commission) / _PRECISE_SCALE
+    return Decimal(proto.min_commission) / _DEPRECATED_SCALE