Metadata-Version: 2.4
Name: tribulnation-aster
Version: 0.7.0
Summary: Tribulnation SDK implementation for Aster spot and perpetual markets.
License-Expression: MIT
Project-URL: Repository, https://github.com/tribulnation/sdk.git
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tribulnation-sdk>=2.13.0
Requires-Dist: typed-aster>=0.2.0
Dynamic: license-file

# Aster SDK

Spot and linear perpetual Market support for [Aster](https://www.asterdex.com/),
built on `typed-aster`. Install with `pip install tribulnation-aster`.

```python
from tribulnation.aster import AsterMarket

async with AsterMarket.new(public=True) as venue:
  market = await venue.perp.market('BTCUSDT')
  book = await market.depth(levels=5)
```

Authenticated use needs the main wallet's address (`user`) and the private key of a
trading agent registered for it (`signer`). The main wallet's own key is never needed:

```python
venue = AsterMarket.new(user='0x…', signer='0x…', mainnet=False)
```

1. Exchanges are `spot` and `perp`, with native symbols such as `BTCUSDT`.
2. Public data: discovery, tickers, rules, REST depth (up to 1000 levels), shared
   depth streams (up to 20 levels), candles in the six SDK intervals, perpetual index,
   next funding, funding-rate history and bulk `perp_stats` (without open interest).
3. Account and trading: fees, order queries, open orders, fill streams, perpetual
   trade history, `MARKET`, `LIMIT` (GTC) and `POST_ONLY` (GTX) orders, and all
   cancellation methods. Market orders ignore the SDK `price`. Perpetual position and
   collateral cover one-way, cross-margin accounts. These are verified on testnet only.
   Perpetual funding payments are available per market or exchange-wide, with positive
   amounts paid, and are verified on mainnet.
4. Unsupported methods raise `NotImplementedError`: spot balances, spot trade history,
   `available_notional` and `perp_collateral`.
5. `tribulnation.aster.Report` snapshots, through `ReportSDK`, the mainnet `perp` wallet
   (without unrealized PnL) and positions with their entry prices, the `spot` wallet,
   and ASTER staked on Aster Chain with its unclaimed rewards, signed by the trading
   agent. Testnet snapshots are unsupported. Its
   `history()` streams perpetual income and spot transactions as unclassified cash
   deltas, verified on testnet only.

See [Aster Market](../../../docs/market/implementations/aster.md) for account
configuration through `MarketSDK`.

## Funding payment signs

Since 0.5.0, funding payments are positive when received and negative when
paid, for every supported history scope. Requires SDK >=2.10.0. Funding rates keep
their existing signs. See [migration notes](RELEASE.md) before upgrading.
