Aster SDK

Spot and linear perpetual Market support for Aster, built on typed-aster. Install with pip install tribulnation-aster.

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:

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 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 before upgrading.