Aster.Net
A C# .netstandard client library for the Aster DEX REST and Websocket Spot and Futures API focusing on clear usage and models
Install / Use
/learn @JKorf/Aster.NetREADME
Aster.Net
Aster.Net is a client library for accessing the Aster DEX REST and Websocket API.
Features
- Response data is mapped to descriptive models
- Input parameters and response values are mapped to discriptive enum values where possible
- High performance
- Automatic websocket (re)connection management
- Client side rate limiting
- Client side order book implementation
- Support for managing different accounts
- Extensive logging
- Support for different environments
- Easy integration with other exchange clients based on the CryptoExchange.Net base library
- Native AOT support
Supported Frameworks
The library is targeting both .NET Standard 2.0 and .NET Standard 2.1 for optimal compatibility, as well as the latest dotnet versions to use the latest framework features.
|.NET implementation|Version Support|
|--|--|
|.NET Core|2.0 and higher|
|.NET Framework|4.6.1 and higher|
|Mono|5.4 and higher|
|Xamarin.iOS|10.14 and higher|
|Xamarin.Android|8.0 and higher|
|UWP|10.0.16299 and higher|
|Unity|2018.1 and higher|
Install the library
NuGet
dotnet add package JKorf.Aster.Net
GitHub packages
Aster.Net is available on GitHub packages. You'll need to add https://nuget.pkg.github.com/JKorf/index.json as a NuGet package source.
Download release
The NuGet package files are added along side the source with the latest GitHub release which can found here.
How to use
Basic request:
// Get the ETH/USDT ticker via rest request
var restClient = new AsterRestClient();
var tickerResult = await restClient.SpotApiV3.ExchangeData.GetTickerAsync("ETHUSDT");
var lastPrice = tickerResult.Data.LastPrice;
Place order:
var restClient = new AsterRestClient(opts => {
opts.ApiCredentials = new AsterV3Credential("PRIVATEKEY", "SIGNERPRIVATEKEY");
});
// Place Limit order to go long for 0.1 ETH at 2000
var orderResult = await asterRestClient.FuturesV3Api.Trading.PlaceOrderAsync(
"ETHUSDT",
OrderSide.Buy,
OrderType.Limit,
0.1m,
2000,
positionSide: PositionSide.Long);
WebSocket subscription:
// Subscribe to ETH/USDT ticker updates via the websocket API
var socketClient = new AsterSocketClient();
var tickerSubscriptionResult = socketClient.SpotApiV3.SubscribeToTickerUpdatesAsync("ETHUSDT", (update) =>
{
var lastPrice = update.Data.LastPrice;
});
For information on the clients, dependency injection, response processing and more see the documentation, or have a look at the examples here or here.
NOTE
Aster.Net uses the Builder Code mechanism for Aster when using the V3 API, which means that an additional 1bps / 0.01% fee is charged on top of orders placed with the library to fund development. This is entirely optional and can be disabled in the client options by setting BuilderFeePercentage to 0 or null in the client options.
Authentication
Depending on the API used different credentials types are required.
SpotV3Api / FuturesV3Api
The V3 API is recommended, API credentials can be provided via the AsterV3Credential overload available on the AsterCredentials object. The private key is the user private key, the private signer key can be obtained via the Aster UI under [Api Management] => [Pro Api]
var credentials = new AsterCredentials(new AsterV3Credential("PRIVATEKEY", "SIGNERPRIVATEKEY"));
var client = new AsterRestClient(opts => { opts.ApiCredentials = credentials; });
var result = await client.FuturesV3Api.Account.GetBalancesAsync();
SpotApi / FuturesApi
The API key and secret can be obtained via the Aster UI under [Api Management] => [Api]
var credentials = new AsterCredentials(new HMACCredential("APIKEY", "APISECRET"));
var client = new AsterRestClient(opts => { opts.ApiCredentials = credentials; });
var result = await client.FuturesApi.Account.GetBalancesAsync();
CryptoExchange.Net
Aster.Net is based on the CryptoExchange.Net base library. Other exchange API implementations based on the CryptoExchange.Net base library are available and follow the same logic.
CryptoExchange.Net also allows for easy access to different exchange API's.
|Exchange|Repository|Nuget|
|--|--|--|
|Binance|JKorf/Binance.Net||
|BingX|JKorf/BingX.Net|
|
|Bitfinex|JKorf/Bitfinex.Net|
|
|Bitget|JKorf/Bitget.Net|
|
|BitMart|JKorf/BitMart.Net|
|
|BitMEX|JKorf/BitMEX.Net|
|
|Bitstamp|JKorf/Bitstamp.Net|
|
|BloFin|JKorf/BloFin.Net|
|
|Bybit|JKorf/Bybit.Net|
|
|Coinbase|JKorf/Coinbase.Net|
|
|CoinEx|JKorf/CoinEx.Net|
|
|CoinGecko|JKorf/CoinGecko.Net|
|
|CoinW|JKorf/CoinW.Net|
|
|Crypto.com|JKorf/CryptoCom.Net|
|
|DeepCoin|JKorf/DeepCoin.Net|
|
|Gate.io|JKorf/GateIo.Net|
|
|HTX|JKorf/HTX.Net|
|
|HyperLiquid|JKorf/HyperLiquid.Net|
|
|Kraken|JKorf/Kraken.Net|
|
|Kucoin|JKorf/Kucoin.Net|
|
|Mexc|JKorf/Mexc.Net|
|
|OKX|JKorf/OKX.Net|
|
|Polymarket|JKorf/Polymarket.Net|[
](https://www.
