JK.BingX.Net
1.16.0
dotnet add package JK.BingX.Net --version 1.16.0
NuGet\Install-Package JK.BingX.Net -Version 1.16.0
<PackageReference Include="JK.BingX.Net" Version="1.16.0" />
paket add JK.BingX.Net --version 1.16.0
#r "nuget: JK.BingX.Net, 1.16.0"
// Install JK.BingX.Net as a Cake Addin #addin nuget:?package=JK.BingX.Net&version=1.16.0 // Install JK.BingX.Net as a Cake Tool #tool nuget:?package=JK.BingX.Net&version=1.16.0
BingX.Net
BingX.Net is a client library for accessing the BingX 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
- Automatic websocket (re)connection management
- Client side rate limiting
- Client side order book implementation
- Extensive logging
- Support for different environments
- Easy integration with other exchange client based on the CryptoExchange.Net base library
Supported Frameworks
The library is targeting both .NET Standard 2.0
and .NET Standard 2.1
for optimal compatibility
.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 JK.BingX.Net
GitHub packages
BingX.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
REST Endpoints
// Get the ETH/USDT ticker via rest request
var restClient = new BingXRestClient();
var tickerResult = await restClient.SpotApi.ExchangeData.GetTickersAsync("ETH-USDT");
var lastPrice = tickerResult.Data.Single().LastPrice;
Websocket streams
// Subscribe to ETH/USDT ticker updates via the websocket API
var socketClient = new BingXSocketClient();
var tickerSubscriptionResult = socketClient.SpotApi.SubscribeToTickerUpdatesAsync("ETH-USDT", (update) =>
{
var lastPrice = update.Data.LastPrice;
});
For information on the clients, dependency injection, response processing and more see the BingX.Net documentation, CryptoExchange.Net documentation, or have a look at the examples here or here.
CryptoExchange.Net
BingX.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 | |
Bitfinex | JKorf/Bitfinex.Net | |
Bitget | JKorf/Bitget.Net | |
BitMart | JKorf/BitMart.Net | |
Bybit | JKorf/Bybit.Net | |
Coinbase | JKorf/Coinbase.Net | |
CoinEx | JKorf/CoinEx.Net | |
CoinGecko | JKorf/CoinGecko.Net | |
Crypto.com | JKorf/CryptoCom.Net | |
Gate.io | JKorf/GateIo.Net | |
HTX | JKorf/HTX.Net | |
Kraken | JKorf/Kraken.Net | |
Kucoin | JKorf/Kucoin.Net | |
Mexc | JKorf/Mexc.Net | |
OKX | JKorf/OKX.Net | |
WhiteBit | JKorf/WhiteBit.Net |
Discord
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 |
---|---|---|
Market Interface | ✓ | restClient.SpotApi.ExchangeData |
Wallet deposits and withdrawals | ✓ | restClient.SpotApi.Account |
Spot account | ✓ | restClient.SpotApi.Account |
Trade interface | ✓ | restClient.SpotApi.Trading |
Websocket Market Data | ✓ | socketClient.SpotApi |
Websocket Account Data | ✓ | socketClient.SpotApi |
Perpetual Futures
API | Supported | Location |
---|---|---|
Market Interface | ✓ | restClient.PerpetualFuturesApi.ExchangeData |
Account Interface | ✓ | restClient.PerpetualFuturesApi.Account |
Trade Interface | ✓ | restClient.PerpetualFuturesApi.Account /restClient.PerpetualFuturesApi.Trading |
Websocket Market Data | ✓ | socketClient.PerpetualFuturesApi |
Websocket Account Data | ✓ | socketClient.PerpetualFuturesApi |
Standard Contract
API | Supported | Location |
---|---|---|
Standard Contract Interface | X |
Account & Wallet
API | Supported | Location |
---|---|---|
Spot account | ✓ | restClient.SpotApi.Account |
Wallet deposits and withdrawals | ✓ | restClient.SpotApi.Account |
Sub-account | X |
Copy Trading
API | Supported | Location |
---|---|---|
Standard Contract Interface | X |
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 a currency not listed here please contact me.
Btc: bc1q277a5n54s2l2mzlu778ef7lpkwhjhyvghuv8qf
Eth: 0xcb1b63aCF9fef2755eBf4a0506250074496Ad5b7
USDT (TRX) TKigKeJPXZYyMVDgMyXxMf17MWYia92Rjd
Sponsor
Alternatively, sponsor me on Github using Github Sponsors.
Release notes
Version 1.16.0 - 19 Nov 2024
- Updated CryptoExchange.Net to version 8.3.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.3.0
- Added support for loading client settings from IConfiguration
- Added DI registration method for configuring Rest and Socket options at the same time
- Added DisplayName and ImageUrl properties to BingXExchange class
- Updated client constructors to accept IOptions from DI
- Removed redundant BingXSocketClient constructor
Version 1.15.1 - 15 Nov 2024
- Fixed available balance response on shared futures implementation
- Removed symbol parameters from GetPositionModeAsync and SetPositionModeAsync endpoints
Version 1.15.0 - 13 Nov 2024
- Added initial SubAccount API implementation
Version 1.14.0 - 06 Nov 2024
- Updated CryptoExchange.Net to version 8.2.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.2.0
Version 1.13.0 - 04 Nov 2024
- Added restClient.PerpetualFuturesApi.Account.GetIsolatedMarginChangeHistoryAsync endpoint
- Added settleAsset parameter to FuturesApi.Trading endpoints
Version 1.12.0 - 28 Oct 2024
- Updated CryptoExchange.Net to version 8.1.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.1.0
- Moved FormatSymbol to BingXExchange class
- Added support Side setting on SharedTrade model
- Added BingXTrackerFactory for creating trackers
- Added overload to Create method on BingXOrderBookFactory support SharedSymbol parameter
- Added Shared websocket kline subscription implementation for futures and spot APIs
Version 1.11.2 - 21 Oct 2024
- Added Tier property to restClient.PerpetualFuturesApi.Trading.GetPositionAndMarginInfoAsync response model
- Added ReduceOnly property to socketClient.PerpetualFuturesApi.SubscribeToUserDataUpdatesAsync order update model
Version 1.11.1 - 14 Oct 2024
- Updated CryptoExchange.Net to version 8.0.3, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.0.3
- Fixed TypeLoadException during initialization
Version 1.11.0 - 27 Sep 2024
- Updated CryptoExchange.Net to version 8.0.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.0.0
- Added Shared client interfaces implementation for Spot and Perpetual Futures Rest and Socket clients
- Added check for api credentials in rest user stream operations
- Added PerpetualFuturesApi.Trading.GetUserTradesAsync endpoint
- Added timeInForce parameter to SpotApi.Trading.PlaceOrderAsync endpoint
- Updated fromId parameter on SpotApi.Trading.GetuserTradesAsync from int? to long?
- Updated KlineInterval Enum values to match number of seconds
- Updated Sourcelink package version
- Marked ISpotClient references as deprecated
Version 1.10.0 - 11 Sep 2024
- Fixed request signing for requests with special characters
- Added SpotApi Oco endpoints
Version 1.9.2 - 28 Aug 2024
- Updated CryptoExchange.Net to version 7.11.2, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.11.2
- Fixed Boolean parameter serialization on PerpetualFuturesApi.Trading order endpoints
- Added RealizedPnl property to PerpetualFuturesApi websocket position update
- Added TimeOffline, TimeMaintenance properties to SpotApi symbol model
- Added BrokerProhibited property to PerpetualFuturesApi contract response model
Version 1.9.1 - 23 Aug 2024
- Fixed enum type on OrderType property on socket perpetual futures order update
Version 1.9.0 - 19 Aug 2024
- Added PerpetualFuturesApi.Trading.GetPositionHistoryAsync endpoint
- Updated PerpetualFuturesApi.Account.GetBalancesAsync to V3, returning both USDT and USDC balances
- Added sync parameter to SpotApi.Trading.PlaceMultipleOrderAsync endpoint
Version 1.8.0 - 07 Aug 2024
- Updated CryptoExchange.Net to version 7.11.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.11.0
- Updated XML code comments
- Fixed PerpetualFuturesApi.Account.SetMarginModeAsync endpoint
Version 1.7.0 - 27 Jul 2024
- Updated CryptoExchange.Net to version 7.10.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.10.0
Version 1.6.0 - 16 Jul 2024
- Updated CryptoExchange.Net to version 7.9.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.9.0
- Updated internal classes to internal access modifier
- Added PerpetualFuturesApi.ExchangeData.GetTickersAsync endpoint
- Added PerpetualFuturesApi.ExchangeData.GetLastTradePricesAsync endpoint
- Added PerpetualFuturesApi.ExchangeData.GetFundingRatesAsync endpoint
- Added SpotApi.ExchangeData.GetLastTradesAsync endpoint
- Added SpotApi.Account.GetUserIdAsync endpoint
- Added SpotApi.Account.GetApiKeyPermissionsAsync endpoint
- Added sync parameter to SpotApi.Trading.PlaceMultipleOrdersAsync
- Updated API endpoint docs references
- Fixed Spot and Futures KeepAliveUserStreamAsync endpoint
- Fixed clientOrderId deserialization in websocket order updates
Version 1.5.0 - 02 Jul 2024
- Updated CryptoExchange.Net to V7.8.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.8.0
- Added TakeProfit/StopLoss parameters to perpetual futures order endpoints
Version 1.4.0 - 26 Jun 2024
- Updated CryptoExchange.Net to 7.7.2, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.7.2
- Added rate limiting ratelimiting implementation
- Updated BingXPosition model
Version 1.3.2 - 23 Jun 2024
- Updated CryptoExchange.Net to version 7.7.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.7.0
Version 1.3.1 - 13 Jun 2024
- Fixed bingXClient.PerpetualFuturesApi.ExchangeData.GetContractsAsync response parsing by updating Status mapping
Version 1.3.0 - 11 Jun 2024
- Updated CryptoExchange.Net to v7.6.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.2.0 - 02 Jun 2024
- Added PerpetualFuturesApi.SubscribeToPartialOrderBookUpdatesAsync, PerpetualFuturesApi.SubscribeToKlineUpdatesAsync and PerpetualFuturesApi.SubscribeToTickerUpdatesAsync subscriptions for all symbols
- Added PerpetualFuturesApi.Trading.GetPositionAndMarginInfoAsync endpoint
- Added optional symbol parameter PerpetualFuturesApi.ExchangeData.GetContractsAsync
- Updated BingXWithdrawal response model
- Updated BingXPosition response model
Version 1.1.1 - 07 May 2024
- Updated CryptoExchange.Net to v7.5.2, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.1.0 - 02 May 2024
- Removed need for API credentials in certain ExchangeData calls
- Renamed PerpetualFutures.Trading.GetClosedOrderAsync to GetClosedOrdersAsync
- Changed PerpetualFutures.SubscribeToUserDataUpdatesAsync handlers to be nullable
- Fixed SpotApi.SubscribeToBalanceUpdatesAsync update handling
- Various small fixes
Version 1.0.5 - 01 May 2024
- Updated CryptoExchange.Net to v7.5.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.0.4 - 28 Apr 2024
- Added BingXExchange static info class
- Added BingXOrderBookFactory book creation method
- Fixed BingXOrderBookFactory injection issue
- Updated CryptoExchange.Net to v7.4.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.0.3 - 23 Apr 2024
- Updated CryptoExchange.Net to 7.3.3, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.0.2 - 18 Apr 2024
- Updated CryptoExchange.Net to 7.3.1, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
Version 1.0.1 - 10 Apr 2024
- Added PostOnly TimeInForce enum value
- Updated PerpetualFuturesApi.ExchangeData.GetContractsAsync response model
- Updated PerpetualFuturesApi.Trading.GetUserTradesAsync response model
- Some other minor model updates
- Updated string comparison for improved performance
- Fixed property types on Position model
Version 1.0.0 - 25 Mar 2024
- Initial release
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- CryptoExchange.Net (>= 8.3.0)
-
.NETStandard 2.1
- CryptoExchange.Net (>= 8.3.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on JK.BingX.Net:
Package | Downloads |
---|---|
CryptoClients.Net
CryptoClients.Net is a collection of multiple cryptocurrency exchange API clients for accessing both the REST API's and WebSocket API's. Supports order and account management and requesting and streaming both public and private data. |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on JK.BingX.Net:
Repository | Stars |
---|---|
JKorf/CryptoExchange.Net
A C# .netstandard base library used for implementing cryptocurrency exchange API's.
|
Version | Downloads | Last updated |
---|---|---|
1.16.0 | 94 | 11/19/2024 |
1.15.1 | 152 | 11/15/2024 |
1.15.0 | 94 | 11/13/2024 |
1.14.0 | 301 | 11/6/2024 |
1.13.0 | 104 | 11/4/2024 |
1.12.0 | 243 | 10/28/2024 |
1.11.2 | 297 | 10/21/2024 |
1.11.1 | 265 | 10/14/2024 |
1.11.0 | 658 | 9/27/2024 |
1.10.0 | 248 | 9/11/2024 |
1.9.2 | 634 | 8/28/2024 |
1.9.1 | 563 | 8/23/2024 |
1.9.0 | 274 | 8/19/2024 |
1.8.0 | 354 | 8/7/2024 |
1.7.0 | 243 | 7/29/2024 |
1.5.0 | 835 | 7/2/2024 |
1.4.0 | 150 | 6/26/2024 |
1.3.2 | 185 | 6/23/2024 |
1.3.1 | 253 | 6/13/2024 |
1.3.0 | 226 | 6/11/2024 |
1.2.0 | 983 | 6/2/2024 |
1.1.1 | 508 | 5/7/2024 |
1.1.0 | 208 | 5/2/2024 |
1.0.5 | 231 | 5/1/2024 |
1.0.4 | 255 | 4/28/2024 |
1.0.3 | 206 | 4/23/2024 |
1.0.2 | 205 | 4/18/2024 |
1.0.1 | 224 | 4/10/2024 |
1.0.0 | 957 | 3/25/2024 |