typed-extended 0.1.0__tar.gz

typed_extended-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tribulnation Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

typed_extended-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: typed-extended
+Version: 0.1.0
+Summary: A fully typed, validated async client for the Extended API.
+Author-email: Marcel Claramunt <marcel@tribulnation.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/tribulnation/typed
+Project-URL: Documentation, https://tribulnation.com/typed/extended
+Project-URL: Website, https://tribulnation.com/typed
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typed-core>=0.13.0
+Requires-Dist: lazy-loader
+Provides-Extra: fast
+Requires-Dist: fast-stark-crypto<0.6,>=0.5; extra == "fast"
+Dynamic: license-file
+
+# Typed Extended
+
+<p align="center">
+  <em>A fully typed, validated async client for the Extended API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-extended/">
+    <img src="https://img.shields.io/pypi/v/typed-extended.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-extended/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-extended.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/extended">
+    <img src="https://img.shields.io/badge/docs-live-black" alt="Docs">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/pypi/l/typed-extended.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/extended](https://tribulnation.com/typed/extended)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/extended](https://github.com/tribulnation/typed/tree/main/packages/extended)
+
+---
+
+```python
+from typed_extended import Extended
+
+async with Extended.new(public=True) as client:
+  stats = await client.info.market_stats('BTC-USD')
+  print(stats['lastPrice'], stats['markPrice'], stats['fundingRate'])
+```
+
+## Why Typed Extended?
+
+- **🎯 Precise Types**: Typed inputs and responses for every REST call and WebSocket stream, including the order request union (limit, market, conditional, TP/SL).
+- **✅ Runtime Validation**: Responses and stream messages validated by default, with prices and sizes as exact `Decimal` and timestamps as `datetime`.
+- **⚡ Async First**: Async HTTP and WebSocket streams, with Stark order, transfer and withdrawal signing done for you.
+- **📚 Full Surface**: Market data, account, orders, transfers and withdrawals, portfolio analytics, vault, interest, points, referrals and builder endpoints.
+
+## Installation
+
+```bash
+pip install typed-extended
+```
+
+Signing runs in pure Python out of the box. For roughly 10x faster signatures, install the
+optional native backend:
+
+```bash
+pip install "typed-extended[fast]"
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/extended/how-to/fetch-market-data)
+- [Listen To Live Streams](https://tribulnation.com/typed/extended/how-to/listen-to-live-streams)
+- [Place & Manage Orders](https://tribulnation.com/typed/extended/how-to/place-and-manage-orders)
+- [Fetch Account Data](https://tribulnation.com/typed/extended/how-to/fetch-account-data)
+- [Paginate Through Results](https://tribulnation.com/typed/extended/how-to/paginate-through-results)
+- [Transfer & Withdraw](https://tribulnation.com/typed/extended/how-to/transfer-and-withdraw)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/extended/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/extended/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/extended/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/extended/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/extended/reference/timestamps)
+
+## Design Philosophy
+
+Typed Extended follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_extended-0.1.0/README.md

@@ -0,0 +1,82 @@
+# Typed Extended
+
+<p align="center">
+  <em>A fully typed, validated async client for the Extended API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-extended/">
+    <img src="https://img.shields.io/pypi/v/typed-extended.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-extended/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-extended.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/extended">
+    <img src="https://img.shields.io/badge/docs-live-black" alt="Docs">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/pypi/l/typed-extended.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/extended](https://tribulnation.com/typed/extended)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/extended](https://github.com/tribulnation/typed/tree/main/packages/extended)
+
+---
+
+```python
+from typed_extended import Extended
+
+async with Extended.new(public=True) as client:
+  stats = await client.info.market_stats('BTC-USD')
+  print(stats['lastPrice'], stats['markPrice'], stats['fundingRate'])
+```
+
+## Why Typed Extended?
+
+- **🎯 Precise Types**: Typed inputs and responses for every REST call and WebSocket stream, including the order request union (limit, market, conditional, TP/SL).
+- **✅ Runtime Validation**: Responses and stream messages validated by default, with prices and sizes as exact `Decimal` and timestamps as `datetime`.
+- **⚡ Async First**: Async HTTP and WebSocket streams, with Stark order, transfer and withdrawal signing done for you.
+- **📚 Full Surface**: Market data, account, orders, transfers and withdrawals, portfolio analytics, vault, interest, points, referrals and builder endpoints.
+
+## Installation
+
+```bash
+pip install typed-extended
+```
+
+Signing runs in pure Python out of the box. For roughly 10x faster signatures, install the
+optional native backend:
+
+```bash
+pip install "typed-extended[fast]"
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/extended/how-to/fetch-market-data)
+- [Listen To Live Streams](https://tribulnation.com/typed/extended/how-to/listen-to-live-streams)
+- [Place & Manage Orders](https://tribulnation.com/typed/extended/how-to/place-and-manage-orders)
+- [Fetch Account Data](https://tribulnation.com/typed/extended/how-to/fetch-account-data)
+- [Paginate Through Results](https://tribulnation.com/typed/extended/how-to/paginate-through-results)
+- [Transfer & Withdraw](https://tribulnation.com/typed/extended/how-to/transfer-and-withdraw)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/extended/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/extended/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/extended/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/extended/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/extended/reference/timestamps)
+
+## Design Philosophy
+
+Typed Extended follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_extended-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "typed-extended"
+version = "0.1.0"
+authors = [
+  {name="Marcel Claramunt", email="marcel@tribulnation.com"}
+]
+description = "A fully typed, validated async client for the Extended API."
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Typing :: Typed",
+]
+dependencies = [
+  "typed-core>=0.13.0", "lazy-loader",
+]
+requires-python = ">=3.10"
+readme = {file="README.md", content-type="text/markdown"}
+
+[project.optional-dependencies]
+fast = ["fast-stark-crypto>=0.5,<0.6"]
+
+[tool.setuptools.package-data]
+"typed_extended" = ["py.typed", "*.pyi", "**/*.pyi"]
+
+[project.urls]
+Repository = "https://github.com/tribulnation/typed"
+Documentation = "https://tribulnation.com/typed/extended"
+Website = "https://tribulnation.com/typed"

typed_extended-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

typed_extended-0.1.0/src/typed_extended/__init__.py

@@ -0,0 +1,14 @@
+"""A fully typed, validated async client for the Extended API.
+
+Examples:
+  ```python
+  from typed_extended import Extended
+
+  async with Extended.new(public=True) as client:
+    markets = await client.info.markets(['BTC-USD'])
+  ```
+"""
+
+import lazy_loader as lazy
+
+__getattr__, __dir__, __all__ = lazy.attach_stub(__name__, __file__)

typed_extended-0.1.0/src/typed_extended/__init__.pyi

@@ -0,0 +1,29 @@
+from .main import Extended
+from .core import (
+  Error,
+  NetworkError,
+  ValidationError,
+  ApiError,
+  BadRequest,
+  AuthError,
+  RateLimited,
+  LogicError,
+  Network,
+  StarkAccount,
+  StarknetDomain,
+)
+
+__all__ = [
+  'Extended',
+  'Error',
+  'NetworkError',
+  'ValidationError',
+  'ApiError',
+  'BadRequest',
+  'AuthError',
+  'RateLimited',
+  'LogicError',
+  'Network',
+  'StarkAccount',
+  'StarknetDomain',
+]

typed_extended-0.1.0/src/typed_extended/account/__init__.py

@@ -0,0 +1,44 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from .asset_operations import AssetOperations
+from .balance import BalanceEndpoint
+from .fees import Fees
+from .funding_history import FundingHistory
+from .info import Info
+from .leverage import Leverage
+from .open_orders import OpenOrders
+from .order import OrderEndpoint
+from .orders_by_external_id import OrdersByExternalId
+from .orders_history import OrdersHistory
+from .positions import Positions
+from .positions_history import PositionsHistory
+from .rebates import Rebates
+from .spot_balances import SpotBalances
+from .sub_accounts import SubAccounts
+from .trades import Trades
+from .update_leverage import UpdateLeverage
+
+
+class Account(
+  AssetOperations,
+  BalanceEndpoint,
+  Fees,
+  FundingHistory,
+  Info,
+  Leverage,
+  OpenOrders,
+  OrderEndpoint,
+  OrdersByExternalId,
+  OrdersHistory,
+  Positions,
+  PositionsHistory,
+  Rebates,
+  SpotBalances,
+  SubAccounts,
+  Trades,
+  UpdateLeverage,
+):
+  """The API key's sub-account: details, balances, positions, orders, trades, funding payments, rebates, leverage and fees.
+
+  References:
+    - [Upstream docs](https://api.docs.extended.exchange/#account)
+  """

typed_extended-0.1.0/src/typed_extended/account/asset_operations.py

@@ -0,0 +1,206 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typed_core import PaginatedResponse
+from typing_extensions import Literal, NotRequired, Sequence, TypedDict
+from typed_extended.core import TimestampMillis
+from typed_extended.core.endpoint.rpc import RpcEndpoint
+from typed_extended.schemas import Pagination
+
+
+class AssetOperation(TypedDict):
+  """One deposit, withdrawal, transfer or testnet claim."""
+
+  id: str
+  """Operation id: a decimal number for transfers and withdrawals, an on-chain id (hex) for deposits."""
+  type: Literal[
+    'DEPOSIT', 'CLAIM', 'TRANSFER', 'WITHDRAWAL', 'FAST_WITHDRAWAL', 'SLOW_WITHDRAWAL'
+  ]
+  """Operation type (`CLAIM`: testnet funds claim)."""
+  status: Literal['CREATED', 'IN_PROGRESS', 'COMPLETED', 'REJECTED', 'READY_FOR_CLAIM']
+  """Operation status."""
+  amount: Decimal
+  """Amount, in the collateral asset (negative for outflows in the docs example)."""
+  fee: Decimal
+  """Fee paid."""
+  asset: int
+  """Asset id of the collateral asset."""
+  time: TimestampMillis
+  """When the operation was last updated."""
+  accountId: int
+  """Source account for transfers and withdrawals; destination account for deposits."""
+  counterpartyAccountId: NotRequired[int]
+  """Destination account of a transfer."""
+  transactionHash: NotRequired[str]
+  """On-chain transaction hash; absent for transfers."""
+  chain: NotRequired[str]
+  """Source chain of a deposit, target chain of a withdrawal."""
+
+
+class Request(TypedDict):
+  """Filters and page."""
+
+  id: NotRequired[int]
+  """Only this operation (SDK only)."""
+  type: NotRequired[
+    list[
+      Literal[
+        'DEPOSIT',
+        'CLAIM',
+        'TRANSFER',
+        'WITHDRAWAL',
+        'FAST_WITHDRAWAL',
+        'SLOW_WITHDRAWAL',
+      ]
+    ]
+  ]
+  """Only these operation types (repeated `type` query key)."""
+  status: NotRequired[
+    list[Literal['CREATED', 'IN_PROGRESS', 'COMPLETED', 'REJECTED', 'READY_FOR_CLAIM']]
+  ]
+  """Only these statuses (repeated `status` query key)."""
+  startTime: NotRequired[TimestampMillis]
+  """Only operations from this time (SDK only)."""
+  endTime: NotRequired[TimestampMillis]
+  """Only operations up to this time (SDK only)."""
+  cursor: NotRequired[int]
+  """Continue after this item id: the `pagination.cursor` of the previous page."""
+  limit: NotRequired[int]
+  """Most operations per page; the docs say 50 per page."""
+
+
+class AssetOperationsPage(TypedDict):
+  """One page of operations, newest first."""
+
+  data: list[AssetOperation]
+  """The operations."""
+  pagination: NotRequired[Pagination]
+  """Where the page ends; absent when the venue sends none."""
+
+
+class AssetOperations(RpcEndpoint):
+  """Get the history of deposits, withdrawals, transfers between sub-accounts and testnet claims, newest first, 50 per page."""
+
+  def asset_operations_paged(
+    self,
+    *,
+    id: int | None = None,
+    type: list[
+      Literal[
+        'DEPOSIT',
+        'CLAIM',
+        'TRANSFER',
+        'WITHDRAWAL',
+        'FAST_WITHDRAWAL',
+        'SLOW_WITHDRAWAL',
+      ]
+    ]
+    | None = None,
+    status: list[
+      Literal['CREATED', 'IN_PROGRESS', 'COMPLETED', 'REJECTED', 'READY_FOR_CLAIM']
+    ]
+    | None = None,
+    start_time: TimestampMillis | None = None,
+    end_time: TimestampMillis | None = None,
+    limit: int | None = None,
+    validate: bool | None = None,
+  ) -> PaginatedResponse[AssetOperation, int]:
+    """Get the history of deposits, withdrawals, transfers between sub-accounts and testnet claims, newest first, 50 per page.
+
+    Paged variant of `asset_operations`: Passes each page's token back as `cursor` and stops on the first empty page. Awaitable (flattens every page) or async-iterable (one page at a time).
+
+    Args:
+      id: Only this operation (SDK only).
+      type: Only these operation types (repeated `type` query key).
+      status: Only these statuses (repeated `status` query key).
+      start_time: Only operations from this time (SDK only).
+      end_time: Only operations up to this time (SDK only).
+      limit: Most operations per page; the docs say 50 per page.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://api.docs.extended.exchange/#get-deposits-withdrawals-transfers-history)
+    """
+
+    async def next(cursor: int) -> tuple[Sequence[AssetOperation], int | None]:
+      response = await self.asset_operations(
+        id=id,
+        type=type,
+        status=status,
+        start_time=start_time,
+        end_time=end_time,
+        limit=limit,
+        cursor=(cursor or None),
+        validate=validate,
+      )
+      rows = response.get('data')
+      rows = rows if rows is not None else []
+      state_0 = response.get('pagination')
+      state = state_0.get('cursor') if state_0 is not None else None
+      return rows, (state or None) if rows else None
+
+    return PaginatedResponse(0, next)
+
+  async def asset_operations(
+    self,
+    *,
+    id: int | None = None,
+    type: list[
+      Literal[
+        'DEPOSIT',
+        'CLAIM',
+        'TRANSFER',
+        'WITHDRAWAL',
+        'FAST_WITHDRAWAL',
+        'SLOW_WITHDRAWAL',
+      ]
+    ]
+    | None = None,
+    status: list[
+      Literal['CREATED', 'IN_PROGRESS', 'COMPLETED', 'REJECTED', 'READY_FOR_CLAIM']
+    ]
+    | None = None,
+    start_time: TimestampMillis | None = None,
+    end_time: TimestampMillis | None = None,
+    cursor: int | None = None,
+    limit: int | None = None,
+    validate: bool | None = None,
+  ) -> AssetOperationsPage:
+    """Get the history of deposits, withdrawals, transfers between sub-accounts and testnet claims, newest first, 50 per page.
+
+    Args:
+      id: Only this operation (SDK only).
+      type: Only these operation types (repeated `type` query key).
+      status: Only these statuses (repeated `status` query key).
+      start_time: Only operations from this time (SDK only).
+      end_time: Only operations up to this time (SDK only).
+      cursor: Continue after this item id: the `pagination.cursor` of the previous page.
+      limit: Most operations per page; the docs say 50 per page.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://api.docs.extended.exchange/#get-deposits-withdrawals-transfers-history)
+    """
+    request: Request = Request()
+    if id is not None:
+      request['id'] = id
+    if type is not None:
+      request['type'] = type
+    if status is not None:
+      request['status'] = status
+    if start_time is not None:
+      request['startTime'] = start_time
+    if end_time is not None:
+      request['endTime'] = end_time
+    if cursor is not None:
+      request['cursor'] = cursor
+    if limit is not None:
+      request['limit'] = limit
+    return await self.request(
+      request,
+      method='GET',
+      path='/user/assetOperations',
+      meta={'auth': 'api_key', 'envelope': 'page'},
+      validate=validate,
+      request_type=Request,
+      response_type=AssetOperationsPage,
+    )

typed_extended-0.1.0/src/typed_extended/account/balance.py

@@ -0,0 +1,67 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typing_extensions import NotRequired, TypedDict
+from typed_extended.core import TimestampMillis
+from typed_extended.core.endpoint.rpc import RpcEndpoint
+
+
+class Balance(TypedDict):
+  """Collateral balance, equity, margin and exposure of the sub-account."""
+
+  collateralName: str
+  """Collateral asset name."""
+  balance: Decimal
+  """Wallet balance: deposits - withdrawals + realised PnL, in the collateral asset."""
+  equity: Decimal
+  """Equity: balance + unrealised PnL, plus the equity contribution of spot holdings."""
+  availableForTrade: Decimal
+  """Available balance for trading: equity - initial margin requirement."""
+  availableForWithdrawal: Decimal
+  """Available balance for withdrawal of the collateral asset; includes unrealised profit only from markets with `tradingConfig.uPnlWithdrawable`."""
+  unrealisedPnl: Decimal
+  """Unrealised PnL of the account."""
+  withdrawableUnrealisedPnl: Decimal
+  """Portion of `unrealisedPnl` held on markets with `tradingConfig.uPnlWithdrawable` (signed)."""
+  initialMargin: Decimal
+  """Collateral used by open positions and orders."""
+  marginRatio: Decimal
+  """Maintenance margin requirement / equity; liquidation above 100%."""
+  exposure: Decimal
+  """Sum of all position values."""
+  leverage: Decimal
+  """Account leverage: exposure / equity."""
+  spotEquity: NotRequired[Decimal]
+  """Sum of `equityContribution` over spot balances (`0` without spot holdings)."""
+  spotEquityForAvailableForTrade: NotRequired[Decimal]
+  """Portion of `spotEquity` counted towards `availableForTrade`."""
+  collateralReservedForSpotOrders: NotRequired[Decimal]
+  """Collateral reserved by open spot buy orders."""
+  updatedTime: TimestampMillis
+  """When the server generated the balance."""
+
+
+class Request(TypedDict):
+  """No parameters."""
+
+
+class BalanceEndpoint(RpcEndpoint):
+  """Get the sub-account's collateral balance, equity, available-for-trade/withdrawal, margin, exposure and spot equity. The venue answers `404` (raised as `BadRequest`) when the balance is 0."""
+
+  async def balance(self, *, validate: bool | None = None) -> Balance:
+    """Get the sub-account's collateral balance, equity, available-for-trade/withdrawal, margin, exposure and spot equity. The venue answers `404` (raised as `BadRequest`) when the balance is 0.
+
+    Args:
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://api.docs.extended.exchange/#get-balance)
+    """
+    return await self.request(
+      Request(),
+      method='GET',
+      path='/user/balance',
+      meta={'auth': 'api_key'},
+      validate=validate,
+      request_type=Request,
+      response_type=Balance,
+    )

typed_extended-0.1.0/src/typed_extended/account/fees.py

@@ -0,0 +1,65 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typing_extensions import NotRequired, TypedDict
+from typed_extended.core.endpoint.rpc import RpcEndpoint
+
+
+class Request(TypedDict):
+  """Markets and builder."""
+
+  market: NotRequired[list[str]]
+  """Only these markets (repeated `market` query key); every market when omitted."""
+  builderId: NotRequired[int]
+  """Builder client id whose fee rate to include."""
+
+
+class TradingFee(TypedDict):
+  """Fee rates on one market."""
+
+  market: str
+  """Market name."""
+  makerFeeRate: Decimal
+  """Maker fee rate."""
+  takerFeeRate: Decimal
+  """Taker fee rate."""
+  builderFeeRate: Decimal
+  """Fee rate of the given builder (`0` without one)."""
+
+
+Response = list[TradingFee]
+
+
+class Fees(RpcEndpoint):
+  """Get the sub-account's maker and taker fee rates per market (and a builder's fee rate). An order's `fee` is capped by these."""
+
+  async def fees(
+    self,
+    market: list[str] | None = None,
+    *,
+    builder_id: int | None = None,
+    validate: bool | None = None,
+  ) -> Response:
+    """Get the sub-account's maker and taker fee rates per market (and a builder's fee rate). An order's `fee` is capped by these.
+
+    Args:
+      market: Only these markets (repeated `market` query key); every market when omitted.
+      builder_id: Builder client id whose fee rate to include.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://api.docs.extended.exchange/#get-fees)
+    """
+    request: Request = Request()
+    if market is not None:
+      request['market'] = market
+    if builder_id is not None:
+      request['builderId'] = builder_id
+    return await self.request(
+      request,
+      method='GET',
+      path='/user/fees',
+      meta={'auth': 'api_key'},
+      validate=validate,
+      request_type=Request,
+      response_type=Response,
+    )