typed-aster 0.1.0__tar.gz

typed_aster-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_aster-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: typed-aster
+Version: 0.1.0
+Summary: A fully typed, validated async client for the Aster 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/aster
+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.0
+Requires-Dist: lazy-loader
+Requires-Dist: eth-account
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://tribulnation.com/typed/aster">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://tribulnation.com/media/lockups/aster-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://tribulnation.com/media/lockups/aster-light.svg">
+      <img alt="Typed Aster" src="https://tribulnation.com/media/lockups/aster-light.svg" width="520">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <em>A fully typed, validated async client for the Aster API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-aster/">
+    <img src="https://img.shields.io/pypi/v/typed-aster.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-aster/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-aster.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/aster">
+    <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-aster.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/aster](https://tribulnation.com/typed/aster)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/aster](https://github.com/tribulnation/typed/tree/main/packages/aster)
+
+---
+
+```python
+from typed_aster import Aster
+
+async with Aster.new(public=True) as client:
+  book = await client.futures.market.depth('BTCUSDT', limit=5)
+  print(book['bids'][0])
+```
+
+One `Aster` client covers four surfaces:
+
+- `client.futures`: perpetual futures
+- `client.spot`: spot trading
+- `client.prediction`: prediction markets
+- `client.chain`: Aster Chain (staking, transfers, withdrawals, and on-chain reads by address)
+
+Public market data needs no credentials. Everything signed uses Aster's Pro API wallets. See
+[Authenticated Setup](https://tribulnation.com/typed/aster/authenticated-setup).
+
+## Why Typed Aster?
+
+- **🎯 Precise Types**: Typed order unions and `datetime` timestamps across futures, spot, prediction and Aster Chain, not `dict`/`Any`. Prices and quantities Aster sends as strings are `Decimal`; the few amounts it sends as JSON numbers (Aster Chain balances such as `walletBalance`, withdrawal fee estimates, fee caps) are `float`.
+- **✅ Runtime Validation**: Every REST, JSON-RPC and WebSocket response is validated by default, not just typed on paper.
+- **⚡ Async First**: Async HTTP plus WebSocket market and user-data streams, built for concurrent workflows.
+- **📚 Full Surface**: Every documented Pro API endpoint, including strategy orders, sub-accounts, builders, prediction outcomes and staking.
+
+## Installation
+
+```bash
+pip install typed-aster
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/aster/how-to/fetch-market-data)
+- [Fetch Account Data](https://tribulnation.com/typed/aster/how-to/fetch-account-data)
+- [Place & Manage Orders](https://tribulnation.com/typed/aster/how-to/place-and-manage-orders)
+- [Paginate Through Results](https://tribulnation.com/typed/aster/how-to/paginate-through-results)
+- [Listen To Live Streams](https://tribulnation.com/typed/aster/how-to/listen-to-live-streams)
+- [Trade Prediction Markets](https://tribulnation.com/typed/aster/how-to/trade-prediction-markets)
+- [Stake ASTER](https://tribulnation.com/typed/aster/how-to/stake-aster)
+- [Manage Deposits & Withdrawals](https://tribulnation.com/typed/aster/how-to/manage-deposits-withdrawals)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/aster/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/aster/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/aster/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/aster/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/aster/reference/timestamps)
+
+## Design Philosophy
+
+Typed Aster follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_aster-0.1.0/README.md

@@ -0,0 +1,95 @@
+<p align="center">
+  <a href="https://tribulnation.com/typed/aster">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://tribulnation.com/media/lockups/aster-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://tribulnation.com/media/lockups/aster-light.svg">
+      <img alt="Typed Aster" src="https://tribulnation.com/media/lockups/aster-light.svg" width="520">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <em>A fully typed, validated async client for the Aster API.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/typed-aster/">
+    <img src="https://img.shields.io/pypi/v/typed-aster.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/typed-aster/">
+    <img src="https://img.shields.io/pypi/pyversions/typed-aster.svg" alt="Python versions">
+  </a>
+  <a href="https://tribulnation.com/typed/aster">
+    <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-aster.svg" alt="License">
+  </a>
+</p>
+
+---
+
+- **Documentation**: [https://tribulnation.com/typed/aster](https://tribulnation.com/typed/aster)
+- **Source Code**: [https://github.com/tribulnation/typed/tree/main/packages/aster](https://github.com/tribulnation/typed/tree/main/packages/aster)
+
+---
+
+```python
+from typed_aster import Aster
+
+async with Aster.new(public=True) as client:
+  book = await client.futures.market.depth('BTCUSDT', limit=5)
+  print(book['bids'][0])
+```
+
+One `Aster` client covers four surfaces:
+
+- `client.futures`: perpetual futures
+- `client.spot`: spot trading
+- `client.prediction`: prediction markets
+- `client.chain`: Aster Chain (staking, transfers, withdrawals, and on-chain reads by address)
+
+Public market data needs no credentials. Everything signed uses Aster's Pro API wallets. See
+[Authenticated Setup](https://tribulnation.com/typed/aster/authenticated-setup).
+
+## Why Typed Aster?
+
+- **🎯 Precise Types**: Typed order unions and `datetime` timestamps across futures, spot, prediction and Aster Chain, not `dict`/`Any`. Prices and quantities Aster sends as strings are `Decimal`; the few amounts it sends as JSON numbers (Aster Chain balances such as `walletBalance`, withdrawal fee estimates, fee caps) are `float`.
+- **✅ Runtime Validation**: Every REST, JSON-RPC and WebSocket response is validated by default, not just typed on paper.
+- **⚡ Async First**: Async HTTP plus WebSocket market and user-data streams, built for concurrent workflows.
+- **📚 Full Surface**: Every documented Pro API endpoint, including strategy orders, sub-accounts, builders, prediction outcomes and staking.
+
+## Installation
+
+```bash
+pip install typed-aster
+```
+
+## How To
+
+- [Fetch Market Data](https://tribulnation.com/typed/aster/how-to/fetch-market-data)
+- [Fetch Account Data](https://tribulnation.com/typed/aster/how-to/fetch-account-data)
+- [Place & Manage Orders](https://tribulnation.com/typed/aster/how-to/place-and-manage-orders)
+- [Paginate Through Results](https://tribulnation.com/typed/aster/how-to/paginate-through-results)
+- [Listen To Live Streams](https://tribulnation.com/typed/aster/how-to/listen-to-live-streams)
+- [Trade Prediction Markets](https://tribulnation.com/typed/aster/how-to/trade-prediction-markets)
+- [Stake ASTER](https://tribulnation.com/typed/aster/how-to/stake-aster)
+- [Manage Deposits & Withdrawals](https://tribulnation.com/typed/aster/how-to/manage-deposits-withdrawals)
+
+## Reference
+
+- [Authenticated Setup](https://tribulnation.com/typed/aster/authenticated-setup)
+- [Async Usage](https://tribulnation.com/typed/aster/reference/async-usage)
+- [Error Handling](https://tribulnation.com/typed/aster/reference/error-handling)
+- [Environment Variables](https://tribulnation.com/typed/aster/reference/env-vars)
+- [Timestamps](https://tribulnation.com/typed/aster/reference/timestamps)
+
+## Design Philosophy
+
+Typed Aster follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).
+
+*Details matter. Developer experience matters.*
+
+## License
+
+MIT — see [LICENSE](LICENSE).

typed_aster-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "typed-aster"
+version = "0.1.0"
+authors = [
+  {name="Marcel Claramunt", email="marcel@tribulnation.com"}
+]
+description = "A fully typed, validated async client for the Aster 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.9.0", "lazy-loader", "eth-account",
+]
+requires-python = ">=3.10"
+readme = {file="README.md", content-type="text/markdown"}
+
+[tool.setuptools.package-data]
+"typed_aster" = ["py.typed", "*.pyi", "**/*.pyi"]
+
+[project.urls]
+Repository = "https://github.com/tribulnation/typed"
+Documentation = "https://tribulnation.com/typed/aster"
+Website = "https://tribulnation.com/typed"

typed_aster-0.1.0/setup.cfg

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

typed_aster-0.1.0/src/typed_aster/__init__.py

@@ -0,0 +1,14 @@
+"""A fully typed, validated async client for the Aster API.
+
+Examples:
+  ```python
+  from typed_aster import Aster
+
+  async with Aster.new(public=True) as client:
+    server_time = await client.futures.market.time()
+  ```
+"""
+
+import lazy_loader as lazy
+
+__getattr__, __dir__, __all__ = lazy.attach_stub(__name__, __file__)

typed_aster-0.1.0/src/typed_aster/__init__.pyi

@@ -0,0 +1,23 @@
+from .main import Aster
+from .core import (
+  Error,
+  NetworkError,
+  ValidationError,
+  ApiError,
+  BadRequest,
+  AuthError,
+  RateLimited,
+  LogicError,
+)
+
+__all__ = [
+  'Aster',
+  'Error',
+  'NetworkError',
+  'ValidationError',
+  'ApiError',
+  'BadRequest',
+  'AuthError',
+  'RateLimited',
+  'LogicError',
+]

typed_aster-0.1.0/src/typed_aster/chain/__init__.py

@@ -0,0 +1,71 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from functools import cached_property
+from .account import Account
+from .perp import Perp
+from .rpc import ChainRpc
+from .spot import Spot
+from .staking import Staking
+from .wallet import Wallet
+from typed_aster.core.base import ChainBase
+
+
+class Chain(ChainBase):
+  """Aster Chain: REST (account privacy, staking, deposits, withdrawals and transfers) and the read-only JSON-RPC. Mainnet only.
+
+  References:
+    - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/)
+  """
+
+  @cached_property
+  def account(self) -> Account:
+    """Aster Chain account: privacy mode (PUBLIC/PRIVATE) and transfers to another Aster Chain address.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-account-endpoints)
+    """
+    return Account(client=self.client)
+
+  @cached_property
+  def perp(self) -> Perp:
+    """Aster Chain perp account: withdrawals (EVM and Solana), withdraw limits, deposit/withdraw history and spot/perp transfers.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-perp-withdraw-transfer-endpoints)
+    """
+    return Perp(client=self.client)
+
+  @cached_property
+  def rpc(self) -> ChainRpc:
+    """Aster Chain read-only JSON-RPC 2.0 (`POST /info`): balances, positions, staking summary, open orders and fills of any address, honouring account privacy mode.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/rpc/endpoints/)
+    """
+    return ChainRpc(client=self.rpc_client)
+
+  @cached_property
+  def spot(self) -> Spot:
+    """Aster Chain spot account: withdrawals (EVM and Solana), spot/perp transfers and the SUI deposit address.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-spot-withdraw-transfer-endpoints)
+    """
+    return Spot(client=self.client)
+
+  @cached_property
+  def staking(self) -> Staking:
+    """ASTER staking on Aster Chain: staking position reads, stake/add/extend/claim actions and the network-wide locked total.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-staking-endpoints)
+    """
+    return Staking(client=self.client)
+
+  @cached_property
+  def wallet(self) -> Wallet:
+    """Aster Chain withdrawal helpers: public withdrawal fee estimates.
+
+    References:
+      - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-withdraw-endpoints)
+    """
+    return Wallet(client=self.client)

typed_aster-0.1.0/src/typed_aster/chain/account/__init__.py

@@ -0,0 +1,12 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from .modify_status import ModifyStatus
+from .status import Status
+from .transfer import Transfer
+
+
+class Account(ModifyStatus, Status, Transfer):
+  """Aster Chain account: privacy mode (PUBLIC/PRIVATE) and transfers to another Aster Chain address.
+
+  References:
+    - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-account-endpoints)
+  """

typed_aster-0.1.0/src/typed_aster/chain/account/modify_status.py

@@ -0,0 +1,44 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from typing_extensions import Literal, TypedDict
+from typed_aster.core.endpoint.rpc import RpcEndpoint
+
+
+class AccountPrivacyStatus(TypedDict):
+  """Account privacy mode after the change."""
+
+  status: Literal['PUBLIC', 'PRIVATE']
+  """Account privacy mode."""
+
+
+class Request(TypedDict):
+  status: Literal['PUBLIC', 'PRIVATE']
+  """New privacy mode: `PUBLIC` or `PRIVATE`."""
+
+
+class ModifyStatus(RpcEndpoint):
+  """Set the account's privacy mode. The change is broadcast to Aster Chain."""
+
+  async def modify_status(
+    self,
+    status: Literal['PUBLIC', 'PRIVATE'],
+    *,
+    validate: bool | None = None,
+  ) -> AccountPrivacyStatus:
+    """Set the account's privacy mode. The change is broadcast to Aster Chain.
+
+    Args:
+      status: New privacy mode: `PUBLIC` or `PRIVATE`.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#modify-account-status-trade)
+    """
+    return await self.request(
+      Request(status=status),
+      method='POST',
+      path='account/modify-status',
+      meta={},
+      validate=validate,
+      request_type=Request,
+      response_type=AccountPrivacyStatus,
+    )

typed_aster-0.1.0/src/typed_aster/chain/account/status.py

@@ -0,0 +1,36 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from typing_extensions import Literal, TypedDict
+from typed_aster.core.endpoint.rpc import RpcEndpoint
+
+
+class AccountPrivacyStatus(TypedDict):
+  """Account privacy mode."""
+
+  status: Literal['PUBLIC', 'PRIVATE']
+  """Account privacy mode."""
+
+
+class Request(TypedDict): ...
+
+
+class Status(RpcEndpoint):
+  """Get the account's privacy mode."""
+
+  async def status(self, *, validate: bool | None = None) -> AccountPrivacyStatus:
+    """Get the account's privacy mode.
+
+    Args:
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#get-account-status-user_data)
+    """
+    return await self.request(
+      Request(),
+      method='GET',
+      path='account/status',
+      meta={},
+      validate=validate,
+      request_type=Request,
+      response_type=AccountPrivacyStatus,
+    )

typed_aster-0.1.0/src/typed_aster/chain/account/transfer.py

@@ -0,0 +1,74 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typing_extensions import Literal, NotRequired, TypedDict
+from typed_aster.core import TimestampMillis
+from typed_aster.core.endpoint.rpc import RpcEndpoint
+
+
+class ChainTransfer(TypedDict):
+  """Accepted transfer."""
+
+  transferId: NotRequired[str]
+  """Transfer id."""
+  asset: NotRequired[str]
+  """Asset name."""
+  amount: NotRequired[Decimal]
+  """Transferred amount."""
+  toAddress: NotRequired[str]
+  """Recipient address."""
+  timestamp: NotRequired[TimestampMillis]
+  """Transfer time."""
+  status: NotRequired[Literal['SUCCESS', 'PENDING']]
+  """Transfer status."""
+
+
+class Request(TypedDict):
+  asset: str
+  """Asset name, e.g. `USDT`."""
+  amount: Decimal
+  """Transfer amount, greater than 0."""
+  toAddress: str
+  """Recipient's Aster Chain wallet address."""
+  clientTranId: NotRequired[str]
+  """Client-defined transfer id; generated by Aster when omitted."""
+
+
+class Transfer(RpcEndpoint):
+  """Transfer an asset to another Aster Chain address. The recipient must be a registered Aster Chain user."""
+
+  async def transfer(
+    self,
+    *,
+    asset: str,
+    amount: Decimal,
+    to_address: str,
+    client_tran_id: str | None = None,
+    validate: bool | None = None,
+  ) -> ChainTransfer:
+    """Transfer an asset to another Aster Chain address. The recipient must be a registered Aster Chain user.
+
+    Args:
+      asset: Asset name, e.g. `USDT`.
+      amount: Transfer amount, greater than 0.
+      to_address: Recipient's Aster Chain wallet address.
+      client_tran_id: Client-defined transfer id; generated by Aster when omitted.
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#transfer-to-address-withdraw)
+    """
+    request: Request = Request(asset=asset, amount=amount, toAddress=to_address)
+    if client_tran_id is not None:
+      request['clientTranId'] = client_tran_id
+    return await self.request(
+      request,
+      method='POST',
+      path='transfer',
+      meta={
+        'sign': 'main',
+        'order': ['asset', 'amount', 'toAddress', 'clientTranId', 'nonce', 'user'],
+      },
+      validate=validate,
+      request_type=Request,
+      response_type=ChainTransfer,
+    )

typed_aster-0.1.0/src/typed_aster/chain/perp/__init__.py

@@ -0,0 +1,16 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from .deposit_withdraw_history import DepositWithdrawHistory
+from .solana_withdraw import SolanaWithdraw
+from .transfer import Transfer
+from .withdraw import Withdraw
+from .withdraw_info import WithdrawInfoEndpoint
+
+
+class Perp(
+  DepositWithdrawHistory, SolanaWithdraw, Transfer, Withdraw, WithdrawInfoEndpoint
+):
+  """Aster Chain perp account: withdrawals (EVM and Solana), withdraw limits, deposit/withdraw history and spot/perp transfers.
+
+  References:
+    - [Upstream docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#aster-chain-perp-withdraw-transfer-endpoints)
+  """

typed_aster-0.1.0/src/typed_aster/chain/perp/deposit_withdraw_history.py

@@ -0,0 +1,68 @@
+# Generated by typed-dev — see CONTRIBUTING.md.
+from decimal import Decimal
+from typing_extensions import Literal, NotRequired, TypedDict
+from typed_aster.core import TimestampMillis
+from typed_aster.core.endpoint.rpc import RpcEndpoint
+
+
+class ChainDepositWithdrawal(TypedDict):
+  """One deposit or withdrawal."""
+
+  id: NotRequired[str]
+  """Record id."""
+  type: NotRequired[Literal['DEPOSIT', 'WITHDRAW']]
+  """Record type."""
+  asset: NotRequired[str]
+  """Asset name."""
+  amount: NotRequired[Decimal]
+  """Amount."""
+  state: NotRequired[str]
+  """Record state, e.g. `COMPLETED`."""
+  txHash: NotRequired[str]
+  """On-chain transaction hash."""
+  time: NotRequired[TimestampMillis]
+  """Record time."""
+  chainId: NotRequired[int]
+  """Chain id."""
+  accountType: NotRequired[str]
+  """Account type, e.g. `perp`."""
+
+
+class Request(TypedDict):
+  chainId: NotRequired[str]
+  """Filter by chain id (sent as a string)."""
+
+
+Response = list[ChainDepositWithdrawal]
+
+
+class DepositWithdrawHistory(RpcEndpoint):
+  """Get the deposit and withdrawal history of the user's perp account."""
+
+  async def deposit_withdraw_history(
+    self,
+    chain_id: str | None = None,
+    *,
+    validate: bool | None = None,
+  ) -> Response:
+    """Get the deposit and withdrawal history of the user's perp account.
+
+    Args:
+      chain_id: Filter by chain id (sent as a string).
+      validate: Override this call's response validation; falls back to the client-level default when omitted.
+
+    References:
+      - [Official docs](https://asterdex.github.io/aster-api-website/aster-chain/endpoints/#depositwithdraw-history-user_data)
+    """
+    request: Request = Request()
+    if chain_id is not None:
+      request['chainId'] = chain_id
+    return await self.request(
+      request,
+      method='GET',
+      path='perp/deposit-withdraw-history',
+      meta={},
+      validate=validate,
+      request_type=Request,
+      response_type=Response,
+    )