typed-lighter 0.1.0__tar.gz

typed_lighter-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_lighter-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: typed-lighter
+Version: 0.1.0
+Summary: A fully typed, validated async client for the Lighter 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/lighter
+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.9.2
+Requires-Dist: lazy-loader
+Requires-Dist: httpx
+Requires-Dist: pydantic
+Requires-Dist: websockets
+Requires-Dist: eth-account>=0.13
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://tribulnation.com/typed/lighter">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://tribulnation.com/media/lockups/lighter-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://tribulnation.com/media/lockups/lighter-light.svg">
+      <img alt="Typed Lighter" src="https://tribulnation.com/media/lockups/lighter-light.svg" width="520">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <em>A fully typed, validated async client for the Lighter API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-lighter/">
+    <img src="https://img.shields.io/pypi/v/typed-lighter.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-lighter/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-lighter.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/lighter">
+    <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-lighter.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/lighter](https://tribulnation.com/typed/lighter)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/lighter](https://github.com/tribulnation/typed/tree/main/packages/lighter)
+
+---
+
+```python
+from typed_lighter import Lighter
+
+async with Lighter.new(public=True) as client:
+  books = await client.api.markets.order_books(filter='perp')
+  for book in books['order_books'][:5]:
+    print(book['market_id'], book['symbol'], book['supported_price_decimals'])
+```
+
+[Lighter](https://apidocs.lighter.xyz/) is a perpetuals and spot order book running on its own
+ZK rollup. Every state change (orders, transfers, leverage, API keys) is a signed L2
+transaction; everything else is a REST read, a WebSocket stream, or an auth-token-gated
+account write. The client mirrors that split:
+
+| Surface | What it covers | Credentials |
+|---|---|---|
+| `client.api` | REST: markets, candles, accounts, orders and trades, transfers, blocks, pools, referrals, RFQ | public, or an auth token for private reads |
+| `client.tx` | Signed transactions: orders, cancels, leverage, margin, transfers, sub-accounts, API keys, pools, staking | API key |
+| `client.streams` | WebSocket channels: order books, trades, candles, market stats, account orders, positions, notifications | public, or an auth token for private channels |
+| `client.signer` | Local signing with no network: every transaction type, auth tokens, key generation | API key |
+| `client.explorer` | The public block explorer (mainnet and testnet): blocks, batches, logs, account history | none |
+| `client.deposit_bridge` | Universal deposit addresses from other chains | bridge API key |
+
+Signing happens in pure Python, inside the package: no compiled library, no external
+process. Transactions go over HTTP or over the shared WebSocket connection, chosen per call.
+
+## Authenticated Quick Start
+
+```python
+from typed_lighter import Lighter
+
+async with Lighter.new() as client:  # reads LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_INDEX, LIGHTER_API_PRIVATE_KEY
+  account = client.signer.account_index
+  orders = await client.api.account.orders.active(account_index=account)
+  for order in orders['orders']:
+    print(order['market_index'], order['order_index'], order['price'], order['status'])
+```
+
+See [Authenticated Setup](https://tribulnation.com/typed/lighter/authenticated-setup) for how
+accounts, API keys and auth tokens work on Lighter.
+
+## Why Typed Lighter?
+
+- **🎯 Precise Types**: Typed requests and responses on every surface, down to order-type unions and `Literal` statuses, not `dict`/`Any`.
+- **✅ Runtime Validation**: REST replies, WebSocket frames and transaction receipts validated by default, not just typed on paper.
+- **⚡ Async First**: Async HTTP and one multiplexed WebSocket connection for streams and transactions, built for concurrent workflows.
+- **📚 Full Surface**: Every REST endpoint and stream channel, all 20 user transaction types, the explorer and the deposit bridge, not just the popular ones.
+
+## Installation
+
+```bash
+pip install typed-lighter
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/lighter/how-to/fetch-market-data)
+- [Fetch Account Data](https://tribulnation.com/typed/lighter/how-to/fetch-account-data)
+- [Paginate Through Results](https://tribulnation.com/typed/lighter/how-to/paginate-through-results)
+- [Place & Manage Orders](https://tribulnation.com/typed/lighter/how-to/place-and-manage-orders)
+- [Listen To Streams](https://tribulnation.com/typed/lighter/how-to/listen-to-streams)
+- [Batch Transactions](https://tribulnation.com/typed/lighter/how-to/batch-transactions)
+- [Transfers & Sub-Accounts](https://tribulnation.com/typed/lighter/how-to/transfers-and-sub-accounts)
+- [Sign Offline](https://tribulnation.com/typed/lighter/how-to/sign-offline)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/lighter/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/lighter/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/lighter/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/lighter/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/lighter/reference/timestamps)
+- [Numbers](https://tribulnation.com/typed/lighter/reference/numbers)
+
+## Design Philosophy
+
+Typed Lighter follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_lighter-0.1.0/README.md

@@ -0,0 +1,119 @@
+<p align="center">
+  <a href="https://tribulnation.com/typed/lighter">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://tribulnation.com/media/lockups/lighter-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://tribulnation.com/media/lockups/lighter-light.svg">
+      <img alt="Typed Lighter" src="https://tribulnation.com/media/lockups/lighter-light.svg" width="520">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <em>A fully typed, validated async client for the Lighter API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-lighter/">
+    <img src="https://img.shields.io/pypi/v/typed-lighter.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-lighter/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-lighter.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/lighter">
+    <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-lighter.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/lighter](https://tribulnation.com/typed/lighter)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/lighter](https://github.com/tribulnation/typed/tree/main/packages/lighter)
+
+---
+
+```python
+from typed_lighter import Lighter
+
+async with Lighter.new(public=True) as client:
+  books = await client.api.markets.order_books(filter='perp')
+  for book in books['order_books'][:5]:
+    print(book['market_id'], book['symbol'], book['supported_price_decimals'])
+```
+
+[Lighter](https://apidocs.lighter.xyz/) is a perpetuals and spot order book running on its own
+ZK rollup. Every state change (orders, transfers, leverage, API keys) is a signed L2
+transaction; everything else is a REST read, a WebSocket stream, or an auth-token-gated
+account write. The client mirrors that split:
+
+| Surface | What it covers | Credentials |
+|---|---|---|
+| `client.api` | REST: markets, candles, accounts, orders and trades, transfers, blocks, pools, referrals, RFQ | public, or an auth token for private reads |
+| `client.tx` | Signed transactions: orders, cancels, leverage, margin, transfers, sub-accounts, API keys, pools, staking | API key |
+| `client.streams` | WebSocket channels: order books, trades, candles, market stats, account orders, positions, notifications | public, or an auth token for private channels |
+| `client.signer` | Local signing with no network: every transaction type, auth tokens, key generation | API key |
+| `client.explorer` | The public block explorer (mainnet and testnet): blocks, batches, logs, account history | none |
+| `client.deposit_bridge` | Universal deposit addresses from other chains | bridge API key |
+
+Signing happens in pure Python, inside the package: no compiled library, no external
+process. Transactions go over HTTP or over the shared WebSocket connection, chosen per call.
+
+## Authenticated Quick Start
+
+```python
+from typed_lighter import Lighter
+
+async with Lighter.new() as client:  # reads LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_INDEX, LIGHTER_API_PRIVATE_KEY
+  account = client.signer.account_index
+  orders = await client.api.account.orders.active(account_index=account)
+  for order in orders['orders']:
+    print(order['market_index'], order['order_index'], order['price'], order['status'])
+```
+
+See [Authenticated Setup](https://tribulnation.com/typed/lighter/authenticated-setup) for how
+accounts, API keys and auth tokens work on Lighter.
+
+## Why Typed Lighter?
+
+- **🎯 Precise Types**: Typed requests and responses on every surface, down to order-type unions and `Literal` statuses, not `dict`/`Any`.
+- **✅ Runtime Validation**: REST replies, WebSocket frames and transaction receipts validated by default, not just typed on paper.
+- **⚡ Async First**: Async HTTP and one multiplexed WebSocket connection for streams and transactions, built for concurrent workflows.
+- **📚 Full Surface**: Every REST endpoint and stream channel, all 20 user transaction types, the explorer and the deposit bridge, not just the popular ones.
+
+## Installation
+
+```bash
+pip install typed-lighter
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/lighter/how-to/fetch-market-data)
+- [Fetch Account Data](https://tribulnation.com/typed/lighter/how-to/fetch-account-data)
+- [Paginate Through Results](https://tribulnation.com/typed/lighter/how-to/paginate-through-results)
+- [Place & Manage Orders](https://tribulnation.com/typed/lighter/how-to/place-and-manage-orders)
+- [Listen To Streams](https://tribulnation.com/typed/lighter/how-to/listen-to-streams)
+- [Batch Transactions](https://tribulnation.com/typed/lighter/how-to/batch-transactions)
+- [Transfers & Sub-Accounts](https://tribulnation.com/typed/lighter/how-to/transfers-and-sub-accounts)
+- [Sign Offline](https://tribulnation.com/typed/lighter/how-to/sign-offline)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/lighter/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/lighter/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/lighter/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/lighter/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/lighter/reference/timestamps)
+- [Numbers](https://tribulnation.com/typed/lighter/reference/numbers)
+
+## Design Philosophy
+
+Typed Lighter follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_lighter-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "typed-lighter"
+version = "0.1.0"
+authors = [
+  {name="Marcel Claramunt", email="marcel@tribulnation.com"}
+]
+description = "A fully typed, validated async client for the Lighter API."
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+readme = {file="README.md", content-type="text/markdown"}
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Typing :: Typed",
+]
+dependencies = [
+  "typed-core>=0.9.2", "lazy-loader", "httpx", "pydantic", "websockets",
+  "eth-account>=0.13",
+]
+
+[tool.setuptools.package-data]
+"typed_lighter" = ["py.typed", "*.pyi", "**/*.pyi"]
+
+[project.urls]
+Repository = "https://github.com/tribulnation/typed"
+Documentation = "https://tribulnation.com/typed/lighter"
+Website = "https://tribulnation.com/typed"

typed_lighter-0.1.0/setup.cfg

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

typed_lighter-0.1.0/src/typed_lighter/__init__.py

@@ -0,0 +1,15 @@
+"""A fully typed, validated async client for the Lighter API.
+
+Examples:
+  ```python
+  from typed_lighter import Lighter
+
+  async with Lighter.new(public=True) as client:
+    books = await client.api.markets.order_books()
+    print(books['order_books'][0]['symbol'])
+  ```
+"""
+
+import lazy_loader as lazy
+
+__getattr__, __dir__, __all__ = lazy.attach_stub(__name__, __file__)

typed_lighter-0.1.0/src/typed_lighter/__init__.pyi

@@ -0,0 +1,35 @@
+from .main import Lighter
+from .core import (
+  Error,
+  NetworkError,
+  ValidationError,
+  ApiError,
+  BadRequest,
+  AuthError,
+  RateLimited,
+  LogicError,
+  error_code,
+  Network,
+)
+from .core.signer import Signer, PythonSigner, SignedTx, AccountSigner
+from .scaling import Scaler, Rounding
+
+__all__ = [
+  'Lighter',
+  'Error',
+  'NetworkError',
+  'ValidationError',
+  'ApiError',
+  'BadRequest',
+  'AuthError',
+  'RateLimited',
+  'LogicError',
+  'error_code',
+  'Network',
+  'Signer',
+  'SignedTx',
+  'PythonSigner',
+  'AccountSigner',
+  'Scaler',
+  'Rounding',
+]

typed_lighter-0.1.0/src/typed_lighter/api/__init__.py

@@ -0,0 +1,111 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from functools import cached_property
+from .account import Account
+from .bridge import Bridge
+from .chain import Chain
+from .markets import Markets
+from .notifications import Notifications
+from .points import Points
+from .pools import Pools
+from .referral import Referral
+from .rfq import Rfq
+from .system import System
+from typed_lighter.core.endpoint.rpc import RpcEndpoint
+
+
+class Api(RpcEndpoint):
+  """The main REST API (`/api/v1/*`): public reads, auth-token reads and auth-token account writes. Signed L2 transactions are `client.tx`.
+
+  References:
+    - [Upstream docs](https://apidocs.lighter.xyz/docs/get-started)
+  """
+
+  @cached_property
+  def account(self) -> Account:
+    """Accounts by index or L1 address, metadata, limits, PnL, fundings, liquidations, exports and account settings.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/account-1)
+    """
+    return Account(client=self.client)
+
+  @cached_property
+  def bridge(self) -> Bridge:
+    """Deposits through bridges: latest deposit, supported networks, CCTP intent addresses and fast-bridge limits.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals)
+    """
+    return Bridge(client=self.client)
+
+  @cached_property
+  def chain(self) -> Chain:
+    """L2 chain state: transactions by hash, block or account, blocks and the current height.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/tx)
+    """
+    return Chain(client=self.client)
+
+  @cached_property
+  def markets(self) -> Markets:
+    """Market metadata, order books, trades, exchange statistics, candles, fundings and price charts.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/orderbooks)
+    """
+    return Markets(client=self.client)
+
+  @cached_property
+  def notifications(self) -> Notifications:
+    """Acknowledging account notifications (liquidations, deleverages, announcements).
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/notification_ack)
+    """
+    return Notifications(client=self.client)
+
+  @cached_property
+  def points(self) -> Points:
+    """Live points, the points leaderboard and the PnL leaderboard.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/pnlleaderboard)
+    """
+    return Points(client=self.client)
+
+  @cached_property
+  def pools(self) -> Pools:
+    """Public pools and staking pools, and LIT lease options and leases.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/docs/manage-public-pools-shares)
+    """
+    return Pools(client=self.client)
+
+  @cached_property
+  def referral(self) -> Referral:
+    """Referral codes, kickbacks, referred users, referral points and referral trade stats.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/docs/referrals)
+    """
+    return Referral(client=self.client)
+
+  @cached_property
+  def rfq(self) -> Rfq:
+    """Requests for quote (whitelisted accounts): create, respond, update, get and list.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/rfq_create)
+    """
+    return Rfq(client=self.client)
+
+  @cached_property
+  def system(self) -> System:
+    """Exchange status, L1 contract and chain configuration, announcements, the token list and the testnet faucet.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/status)
+    """
+    return System(client=self.client)

typed_lighter-0.1.0/src/typed_lighter/api/account/__init__.py

@@ -0,0 +1,75 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from functools import cached_property
+from .by_l1_address import ByL1Address
+from .change_tier import ChangeTier
+from .export import Export
+from .get import Get
+from .keys import Keys
+from .l1_metadata import L1MetadataEndpoint
+from .limits import Limits
+from .liquidations import Liquidations
+from .metadata import Metadata
+from .orders import Orders
+from .partner_stats import PartnerStatsEndpoint
+from .pnl import Pnl
+from .position_funding import PositionFundingEndpoint
+from .set_metadata import SetMetadata
+from .tokens import Tokens
+from .transfers import Transfers
+
+
+class Account(
+  ByL1Address,
+  ChangeTier,
+  Export,
+  Get,
+  L1MetadataEndpoint,
+  Limits,
+  Liquidations,
+  Metadata,
+  PartnerStatsEndpoint,
+  Pnl,
+  PositionFundingEndpoint,
+  SetMetadata,
+):
+  """Accounts by index or L1 address, metadata, limits, PnL, fundings, liquidations, exports and account settings.
+
+  References:
+    - [Upstream docs](https://apidocs.lighter.xyz/reference/account-1)
+  """
+
+  @cached_property
+  def keys(self) -> Keys:
+    """An account's registered API keys, their next nonces, and maker-only key settings.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/docs/api-keys)
+    """
+    return Keys(client=self.client)
+
+  @cached_property
+  def orders(self) -> Orders:
+    """An account's open and closed orders, orders by client index, and its trades.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/accountactiveorders)
+    """
+    return Orders(client=self.client)
+
+  @cached_property
+  def tokens(self) -> Tokens:
+    """Server-issued read-only API tokens: list, create and revoke.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/reference/tokens)
+    """
+    return Tokens(client=self.client)
+
+  @cached_property
+  def transfers(self) -> Transfers:
+    """An account's deposit, withdrawal and transfer history, transfer fees and fast-withdrawal limits.
+
+    References:
+      - [Upstream docs](https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals)
+    """
+    return Transfers(client=self.client)

typed_lighter-0.1.0/src/typed_lighter/api/account/by_l1_address.py

@@ -0,0 +1,92 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typing_extensions import Literal, NotRequired, TypedDict
+from typed_lighter.core import TimestampMicros, TimestampMillis
+from typed_lighter.core.endpoint.rpc import RpcEndpoint
+
+
+class Account(TypedDict):
+  """One account in summary form."""
+
+  code: int
+  """Per-account status code, normally `0`; only the top-level `code` signals an error."""
+  message: NotRequired[str]
+  """Optional human-readable detail; usually absent on success."""
+  account_type: int
+  """Account kind. Lighter documents no numeric mapping; observed values: `0` a master account, `1` a sub-account, `2` a user-operated public pool, `3` the LLP, `4` a staking pool."""
+  account_trading_mode: Literal[0, 1]
+  """`0` classic (separate spot and perps balances), `1` unified (USDC shared by spot and perps)."""
+  index: int
+  """Account index."""
+  l1_address: str
+  """L1 address owning the account; the zero address for protocol pools."""
+  cancel_all_time: TimestampMillis
+  """Time of a scheduled cancel-all (dead man's switch); `0` when none is scheduled, which parses to the Unix epoch (1970-01-01 UTC)."""
+  total_order_count: int
+  """Open orders of the account."""
+  total_isolated_order_count: int
+  """Open orders in isolated-margin positions."""
+  pending_order_count: int
+  """Untriggered conditional orders."""
+  available_balance: Decimal | Literal['']
+  """Available balance, in USDC. Always `""` in this summary form; `account` reports the value."""
+  status: int
+  """Account status code (values undocumented; `1` active and `0` inactive observed)."""
+  collateral: Decimal
+  """Perps collateral (USDC)."""
+  transaction_time: TimestampMicros
+  """Time of the account's last transaction; `0` in `accountsByL1Address`."""
+
+
+class Request(TypedDict):
+  l1_address: str
+  """Ethereum (L1) address, `0x`-prefixed hex."""
+  cursor: NotRequired[str]
+  """Opaque cursor; the response carries none, so it is never needed."""
+
+
+class SubAccounts(TypedDict):
+  """Every account of one L1 address, in summary form."""
+
+  code: int
+  """`200` on success."""
+  message: NotRequired[str]
+  """Optional human-readable detail; usually absent on success."""
+  l1_address: str
+  """The queried L1 address."""
+  sub_accounts: list[Account]
+  """Accounts of the address, master first."""
+
+
+class ByL1Address(RpcEndpoint):
+  """List every account (master, sub-accounts, pools it created) of an L1 address, in summary form."""
+
+  async def by_l1_address(
+    self,
+    *,
+    l1_address: str,
+    cursor: str | None = None,
+    validate: bool | None = None,
+  ) -> SubAccounts:
+    """List every account (master, sub-accounts, pools it created) of an L1 address, in summary form.
+
+    Args:
+      l1_address: Ethereum (L1) address, `0x`-prefixed hex.
+      cursor: Opaque cursor; the response carries none, so it is never needed.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://apidocs.lighter.xyz/reference/accountsbyl1address)
+    """
+    request: Request = Request(l1_address=l1_address)
+    if cursor is not None:
+      request['cursor'] = cursor
+    return await self.request(
+      request,
+      method='GET',
+      path='/api/v1/accountsByL1Address',
+      meta={},
+      validate=validate,
+      request_type=Request,
+      response_type=SubAccounts,
+    )