Skip to content

Repository files navigation

Pionex.Net Pionex.Net

.NET License Since

Docs

Pionex.Net is a client library for accessing the Pionex 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

Documentation

The Pionex.Net documentation is the main resource for installing, configuring, and using the library.

Resource Description
Client guide Installation, REST and WebSocket clients, authentication, dependency injection, error handling, and advanced features
Examples Common REST and WebSocket operations
API reference Client interfaces, methods, and properties
Shared API guide Common interfaces and models for working with multiple exchanges

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

NuGet version Nuget downloads

dotnet add package Pionex.Net

GitHub packages

Pionex.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

GitHub 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 PionexRestClient();
var tickerResult = await restClient.SpotApi.ExchangeData.GetTickersAsync("ETH_USDT");
var lastPrice = tickerResult.Data.Single().ClosePrice;

Place order:

var restClient = new PionexRestClient(opts => {
	opts.ApiCredentials = new PionexCredentials("APIKEY", "APISECRET");
});

// Place Limit order to buy 0.1 ETH at 2000
var orderResult = await restClient.SpotApi.Trading.PlaceOrderAsync(
    "ETH_USDT",
    OrderSide.Buy,
    OrderType.Limit,
    0.1m,
    price: 2000
    );

WebSocket subscription:

// Subscribe to ETH/USDT ticker updates via the websocket API
var socketClient = new PionexSocketClient();
var tickerSubscriptionResult = socketClient.SpotApi.SubscribeToTradeUpdatesAsync("ETH_USDT", (update) =>
{
    var tradePrice = update.Data.First().Price;
});

For more examples and explanations, continue with the Pionex.Net documentation or browse the compilable repository examples.

AI / LLM documentation

Pionex.Net includes AI-oriented documentation and examples for code generation tools:

File Purpose
AGENTS.md Assistant skill with core Pionex.Net patterns, pitfalls, and examples
llms.txt Short LLM index with links to docs, examples, and critical usage rules
llms-full.txt Detailed LLM context with endpoint routing, authentication levels, code patterns, and anti-hallucination checks
docs/ai-api-map.md Table-style intent-to-method map
Examples/ai-friendly Compilable single-file examples for common REST, authentication/trading, WebSocket, DI/order book, and error handling workflows

See cryptoexchange-skills-hub for installable skills.

Shared / unified API

The CryptoExchange.Net Shared APIs provide exchange-agnostic, unified interfaces for common operations such as retrieving tickers, order books and balances, placing orders, and subscribing to market updates.

This allows the same application code to work with different exchange libraries. The supported Pionex API surfaces expose their shared functionality through a SharedClient property. Because support differs between exchanges and API surfaces, call Discover() to inspect the available trading modes, environments, endpoints, and subscriptions at runtime.

Supported shared interfaces

API Type Supported interfaces
SpotApi REST IBalanceRestClient, IBookTickerRestClient, IKlineRestClient, IOrderBookRestClient, IRecentTradeRestClient, ISpotOrderRestClient, ISpotSymbolRestClient, ISpotTickerRestClient
SpotApi WebSocket IBalanceSocketClient, IBookTickerSocketClient, IOrderBookSocketClient, ISpotOrderSocketClient, ITradeSocketClient, IUserTradeSocketClient

Discover supported functionality

var sharedClient = new PionexRestClient().SpotApi.SharedClient;
var clientInfo = sharedClient.Discover();

Console.WriteLine(clientInfo);

Example

using Pionex.Net.Clients;
using CryptoExchange.Net.SharedApis;

var sharedClient = new PionexRestClient().SpotApi.SharedClient;
ISpotTickerRestClient tickerClient = sharedClient;

var symbol = new SharedSymbol(TradingMode.Spot, "ETH", "USDT");
var result = await tickerClient.GetSpotTickerAsync(
    new GetTickerRequest(symbol));

if (!result.Success)
{
    Console.WriteLine(result.Error);
    return;
}

Console.WriteLine(result.Data.LastPrice);

The request and response models belong to CryptoExchange.Net.SharedApis, so the same pattern can be used with another exchange's SharedClient.

CryptoExchange.Net

Pionex.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 provides shared access to different exchange APIs.

Exchange Repository Nuget
Aster JKorf/Aster.Net Nuget version
Binance JKorf/Binance.Net Nuget version
BingX JKorf/BingX.Net Nuget version
Bitfinex JKorf/Bitfinex.Net Nuget version
Bitget JKorf/Bitget.Net Nuget version
BitMart JKorf/BitMart.Net Nuget version
BitMEX JKorf/BitMEX.Net Nuget version
Bitstamp JKorf/Bitstamp.Net Nuget version
BloFin JKorf/BloFin.Net Nuget version
Bybit JKorf/Bybit.Net Nuget version
Coinbase JKorf/Coinbase.Net Nuget version
CoinEx JKorf/CoinEx.Net Nuget version
CoinGecko JKorf/CoinGecko.Net Nuget version
CoinW JKorf/CoinW.Net Nuget version
Crypto.com JKorf/CryptoCom.Net Nuget version
DeepCoin JKorf/DeepCoin.Net Nuget version
Gate.io JKorf/GateIo.Net Nuget version
HTX JKorf/HTX.Net Nuget version
HyperLiquid JKorf/HyperLiquid.Net Nuget version
Kraken JKorf/Kraken.Net Nuget version
Kucoin JKorf/Kucoin.Net Nuget version
LBank JKorf/LBank.Net Nuget version
Lighter JKorf/Lighter.Net Nuget version
Mexc JKorf/Mexc.Net Nuget version
OKX JKorf/OKX.Net Nuget version
Toobit JKorf/Toobit.Net Nuget version
Upbit JKorf/Upbit.Net Nuget version
Weex JKorf/Weex.Net Nuget version
WhiteBit JKorf/WhiteBit.Net Nuget version
XT JKorf/XT.Net Nuget version

When using multiple of these API's the CryptoClients.Net package can be used which combines this and the other packages and allows easy access to all exchange API's.

Discord

Nuget version
A Discord server is available here. For discussion and/or questions around the CryptoExchange.Net and implementation libraries, feel free to join.

Supported functionality

Spot

API Supported Location
REST Common restClient.SpotApi.ExchangeData
REST Market restClient.SpotApi.ExchangeData
REST Account restClient.SpotApi.Account
REST Trades restClient.SpotApi.Trading
REST Wallet restClient.SpotApi.Account
WebSocket Public Stream socketClient.SpotApi
WebSocket Private Stream socketClient.SpotApi

Futures

The futures API is not currently publicly available and therefor not implemented at this moment

Support the project

Any support is greatly appreciated.

Donate

Make a one time donation in a crypto currency of your choice. If you prefer to donate in a different currency or network send me a message.

USDT (TRX) TKigKeJPXZYyMVDgMyXxMf17MWYia92Rjd

Sponsor

Alternatively, sponsor me on Github using Github Sponsors.

Release notes

  • Version 1.1.0 - 29 Jul 2026

    • Updated CryptoExchange.Net to version 12.4.0
    • Added calculation of AveragePrice on Shared order models if data is available and AveragePrice is not set
    • Added DebuggerDisplay attributes to Result models
    • Added AveragePrice property to SharedQuantity model
    • Updated SharedFuturesTicker, SharedSpotTicker, SharedTrade and SharedKline to use SharedOrderQuantity for volumes/quantities
  • Version 1.0.0 - 23 Jul 2026

    • Initial release

About

C#/.NET client library for the Pionex.com cryptocurrency exchange REST and WebSocket APIs, supporting Spot trading and market data with strongly typed models.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages