Binance.Net
May 9, 2026 · View on GitHub
Binance.Net is a strongly typed client library for accessing the Binance REST and Websocket API.
For AI Coding Assistants
This library provides first-class support for AI coding assistants. The relevant skill files are in this repository:
- Agents:
AGENTS.md(auto-detected at repo root) - Cursor:
.cursor/rules/binance-net.mdc - GitHub Copilot:
.github/copilot-instructions.md - Other tools (Windsurf, Codex, Continue, Aider, etc.):
llms.txtat repo root - API quick map:
docs/ai-api-map.md - Compilable examples:
Examples/ai-friendly/
Quick prompt to verify your assistant is using these:
"Show me a minimal example of placing a limit buy order on Binance Spot using Binance.Net, including authentication setup."
The expected output should use BinanceRestClient, BinanceCredentials, and the WebCallResult pattern.
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 (binance.com, binance.us, testnet)
- Easy integration with other exchange client 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 Binance.Net
GitHub packages
Binance.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 BinanceRestClient();
var tickerResult = await restClient.SpotApi.ExchangeData.GetTickerAsync("ETHUSDT");
var lastPrice = tickerResult.Data.LastPrice;
Place order:
var restClient = new BinanceRestClient(opts => {
opts.ApiCredentials = new BinanceCredentials("APIKEY", "APISECRET");
});
// Place Limit order to go long for 0.1 ETH at 2000
var orderResult = await restClient.UsdFuturesApi.Trading.PlaceOrderAsync(
"ETHUSDT",
OrderSide.Buy,
FuturesOrderType.Limit,
0.1m,
2000,
timeInForce: TimeInForce.GoodTillCanceled,
positionSide: PositionSide.Long);
WebSocket subscription:
// Subscribe to ETH/USDT ticker updates via the websocket API
var socketClient = new BinanceSocketClient();
var tickerSubscriptionResult = socketClient.SpotApi.ExchangeData.SubscribeToTickerUpdatesAsync("ETHUSDT", (update) =>
{
var lastPrice = update.Data.LastPrice;
});
Get started and request the last price of a symbol in 40 seconds
For information on the clients, dependency injection, response processing and more see the documentation, or have a look at the examples here or here.
CryptoExchange.Net
Binance.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 |
|---|---|---|
| Aster | JKorf/Aster.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 | |
| HyperLiquid | JKorf/HyperLiquid.Net | |
| HTX | JKorf/HTX.Net | |
| Kraken | JKorf/Kraken.Net | |
| Kucoin | JKorf/Kucoin.Net | |
| Mexc | JKorf/Mexc.Net | |
| OKX | JKorf/OKX.Net | |
| Polymarket | JKorf/Polymarket.Net | |
| Toobit | JKorf/Toobit.Net | |
| Upbit | JKorf/Upbit.Net | |
| Weex | JKorf/Weex.Net | |
| WhiteBit | JKorf/WhiteBit.Net | |
| XT | JKorf/XT.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/Margin/Savings/Mining REST
| API | Supported | Location |
|---|---|---|
| Wallet endpoints | ✓ | restClient.SpotApi.Account |
| SubAccount endpoints | ✓ | restClient.GeneralApi.SubAccount |
| Market data endpoints | ✓ | restClient.SpotApi.ExchangeData |
| Websocket Market Streams | ✓ | socketClient.SpotApi.ExchangeData |
| Spot Trading Endpoints | ✓ | restClient.SpotApi.Trading |
| Spot Account Endpoints | ✓ | restClient.SpotApi.Account |
| Margin Account/Trade | Partial | restClient.SpotApi.Account / restClient.SpotApi.Trading |
| User Data Streams | ✓ | socketClient.SpotApi.Account |
| Margin User Data Streams | X | |
| Simple Earn Endpoints | ✓ | restClient.GeneralApi.SimpleEarn |
| Auto-Invest Endpoints | ✓ | restClient.GeneralApi.AutoInvest |
| Staking Endpoints | ✓ | restClient.GeneralApi.Staking |
| Mining Endpoints | ✓ | restClient.GeneralApi.Mining |
| Futures | ✓ | restClient.GeneralApi.Futures |
| Futures Algo Endpoints | ✓ | restClient.UsdFuturesApi.Trading |
| Spot Algo Endpoints | ✓ | restClient.SpotApi.Trading |
| Classic Portfolio Margin Endpoints | Partial | restClient.SpotApi.Account |
| BLVT Endpoints | Partial | restClient.SpotApi.Account / restClient.SpotApi.ExchangeData / restClient.SpotApi.Trading |
| Fiat Endpoints | ✓ | restClient.SpotApi.Account |
| C2C Endpoints | ✓ | restClient.SpotApi.Trading |
| VIP Loans Endpoints | X | |
| Crypto Loans Endpoints | Partial | restClient.GeneralApi.CryptoLoans |
| Pay Endpoints | ✓ | restClient.SpotApi.Trading |
| Convert Endpoints | ✓ | restClient.SpotApi.ExchangeData / restClient.SpotApi.Trading |
| Rebate Endpoints | ✓ | restClient.SpotApi.Account |
| NFT Endpoints | X | |
| Binance Gift Card Endpoints | X |
USD-M Futures REST
| API | Supported | Location |
|---|---|---|
| Market Data | ✓ | restClient.UsdFuturesApi.ExchangeData |
| Trade | ✓ | restClient.UsdFuturesApi.Account / restClient.UsdFuturesApi.Trading |
| Websocket Market Streams | ✓ | socketClient.UsdFuturesApi |
| User Data Streams | ✓ | socketClient.UsdFuturesApi |
| Account | ✓ | restClient.UsdFuturesApi.Account / restClient.UsdFuturesApi.Trading |
| Convert | ✓ | restClient.UsdFuturesApi.ExchangeData / restClient.UsdFuturesApi.Trading |
| Classic Portfolio Margin Endpoints | X |
COIN-M Futures REST
| API | Supported | Location |
|---|---|---|
| Market Data | ✓ | restClient.CoinFuturesApi.ExchangeData |
| Websocket Market Streams | ✓ | socketClient.CoinFuturesApi |
| Trade | ✓ | restClient.CoinFuturesApi.Account / restClient.CoinFuturesApi.Trading |
| User Data Streams | ✓ | socketClient.CoinFuturesApi |
| Account | ✓ | restClient.CoinFuturesApi.Account / restClient.CoinFuturesApi.Trading |
| Classic Portfolio Margin Endpoints | X |
Spot Websocket API
| API | Supported | Location |
|---|---|---|
| Market data requests | ✓ | socketClient.SpotApi.ExchangeData |
| Trading requests | ✓ | socketClient.SpotApi.Trading |
| Account requests | ✓ | socketClient.SpotApi.Account |
USD-M Futures Websocket API
| API | Supported | Location |
|---|---|---|
| * | ✓ | socketClient.UsdFuturesApi.Account / socketClient.UsdFuturesApi.ExchangeData / socketClient.UsdFuturesApi.Trading |
European Options
| API | Supported | Location |
|---|---|---|
| * | X |
Portfolio Margin
| API | Supported | Location |
|---|---|---|
| * | 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 12.12.0 - 01 May 2026
- Added REST and WebSocket SpotApi.Trading.AmendOrderAsync endpoint
-
Version 12.11.4 - 24 Apr 2026
- Added Transfer value to SelfTradePerventionMode enum
- Updated websocket Spot (margin) user data subscriptions to use subscriptionId to prevent events being propagated for both margin and normal subscriptions for a single message
-
Version 12.11.3 - 09 Apr 2026
- Updated CryptoExchange.Net to version 11.1.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fixed TradeFi contracts not showing up in Shared GetFuturesSymbolsAsync response
-
Version 12.11.2 - 02 Apr 2026
- Updated CryptoExchange.Net to version 11.0.3, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fixed TradeFi contracts not showing up in Shared GetFuturesSymbolsAsync response
-
Version 12.11.1 - 27 Mar 2026
-
Removed socketClient.SpotApi.ExchangeData.SubscribeToAllTickerUpdatesAsync as it's no longer available in the API
-
Updated Shared Spot SubscribeToAllTickersUpdatesAsync to alternative stream
-
Notes for updating:
- If you previously relied on Spot SubscribeToAllTickerUpdatesAsync you can switch to either SubscribeToAllMiniTickerUpdatesAsync or SubscribeToAllRollingWindowTickerUpdatesAsync with timespan
TimeSpan.FromDays(1)
- If you previously relied on Spot SubscribeToAllTickerUpdatesAsync you can switch to either SubscribeToAllMiniTickerUpdatesAsync or SubscribeToAllRollingWindowTickerUpdatesAsync with timespan
-
-
Version 12.11.0 - 24 Mar 2026
-
Updated CryptoExchange.Net to version 11.0.1, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
-
Updated class for supplying API credentials from ApiCredentials to BinanceCredentials
-
Updated Shared status parsing to default to Unknown value if not parsable
-
Added support for specifying non-HMAC credentials via Configuration
-
Added FeeBurn property to BinanceFuturesAccountInfo model
-
Added UpdateTime property to BinanceFuturesFundingInfo model
-
Added CirculatingSupply property to BinacneFuturesOpenInterestHistory model
-
Added MaxMoveOrderLimit and PermissionSets properties to BinanceFuturesSymbol model
-
Added IsolatedWallet, Notional and BreakEvenPrice properties to BinancePositionInfoBase model
-
Added Isolated and AdlQuantile properties to BinancePositionDetailsUsdt model
-
Added FromIsBase to BinanceConvertAssetPair model
-
Added IsPublic to BinanceIsolatedMarginFeeData model
-
Added TransferInEnabled, TransferOutEnabled, Created and WithdrawCollateralMarginLevel properties to BinanceMarginAccount model
-
Added RiskBasedLiquidationRatio and UpdateTime to BinancePortfolioMarginCollateralRate model
-
Added Direction property to BinanceDividendRecords model
-
Added ToAsset to BinanceDustLog model
-
Added OPOAllowed and AmendAllowed properties to BinanceSymbol model
-
Added SpecialWithdrawTips, ResetAddressStatus and DepositDust properties to BinanceUserAsset model
-
Added MarkPriceMovingAverage property to UsdFuturesApimark price subscriptions
-
Fixed IsRpiTrade mapping on BinanceRecentTrade model
-
Fixed restClient.SpotApi.Account.GetFiatPaymentHistoryAsync returning null in data instead of empty array
-
Notes for updating:
- Update ApiCredentials to BinanceCredentials for authentication, i.e.
ApiCredentials = new ApiCredentials(..)=>ApiCredentials = new BinanceCredentials(..) - When using AddBinance with the Configuration overload (loading config from appsettings), the API credentials path has been changed from ApiCredentials:Key to ApiCredentials:HMAC:Key (and secret)
- Update ApiCredentials to BinanceCredentials for authentication, i.e.
-
-
Version 12.10.0 - 09 Mar 2026
- Added restClient.SpotApi.ExchangeData.GetExecutionRulesAsync endpoint
- Added restClient.SpotApi.ExchangeData.GetReferencePriceAsync endpoint
- Added restClient.SpotApi.ExchangeData.GetReferencePriceCalculationAsync endpoint
- Added socketClient.SpotApi.ExchangeData.GetExecutionRulesAsync request
- Added socketClient.SpotApi.ExchangeData.GetReferencePriceAsync request
- Added socketClient.SpotApi.ExchangeData.GetReferencePriceCalculationAsync request
- Added socketClient.SpotApi.ExchangeData.SubscribeToReferencePriceUpdatesAsync stream
- Added Identifier to binanceRestClient.SpotApi.Account.GetTravelRuleVaspListAsync response model
- Updated UsdFuturesApi WebSocket connection urls to include public/market/private in the URL as per API documentation update
- Updated xml comments to include json fields
-
Version 12.9.0 - 06 Mar 2026
- Updated CryptoExchange.Net to version 10.8.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Improved XML comments
-
Version 12.8.1 - 26 Feb 2026
- Fixed websocket cancel-replace query not outputting data when partially failing
- Fixed json serializing BinanceExchangeInfo model throwing stackoverflow exception
-
Version 12.8.0 - 25 Feb 2026
- Updated CryptoExchange.Net to version 10.7.1
- Added restClient.SpotApi.Account.GetMarginUserListenTokenAsync endpoint for starting/maintaining margin user data subscription
- Added socketClient.SpotApi.Account.SubscribeToMarginUserDataUpdatesAsync subscription for margin user data stream
- Added socketClient.SpotApi.Account.UpdateMarginUserDataTokenAsync for keeping alive the margin user data stream
- Removed deprecated margin stream endpoints
-
Version 12.7.0 - 24 Feb 2026
- Updated CryptoExchange.Net to version 10.7.0
- Added additional Http settings to client options
- Updated Shared REST interfaces pagination logic
- Updated HttpClient registration, fixing issue of DNS changes not getting processed
- Fixed UserClientProvider using unconfigured HttpClient
-
Version 12.6.0 - 16 Feb 2026
- Updated CryptoExchange.Net to version 10.6.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fixed SymbolOrderBook websocket subscription not getting closed if when waiting for initial data times out
-
Version 12.5.2 - 12 Feb 2026
- Updated CryptoExchange.Net to version 10.5.4, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Added support for travel rule ExchangeParameters in Shared withdrawal/deposit endpoints
-
Version 12.5.1 - 11 Feb 2026
- Updated CryptoExchange.Net to version 10.5.3, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fixed restClient.SpotApi.Account.GetTravelRuleWithdrawalHistoryAsync deserialization if questionnaire has value
- Added unknown TravelRuleApproveStatus Enum value
-
Version 12.5.0 - 10 Feb 2026
- Updated CryptoExchange.Net to version 10.5.1, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fix futures websocket subscription account topic filtering
- Updated UserClientProvider internal client cache to non-static to prevent cleanup issues
-
Version 12.4.0 - 06 Feb 2026
- Updated CryptoExchange.Net to version 10.4.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Added BinanceUserSpotDataTracker, BinanceUserUsdFuturesDataTracker and BinanceUserCoinFuturesDataTracker
- Added Travel Rule withdrawal/deposit endpoints
- Added Status mapping for SharedDeposit models
- Added additional methods for requesting supported symbols to Shared ISpotSymbolRestClient/IFuturesSymbolRestClient interfaces
- Added PositionMode mapping on SharedPosition models
- Updated Spot websocket logic to support authentication via the websocket instead of via listen key
- Updated DepositStatus enum
- Updated websocket rate limit for futures to 9 requests per second to accomedate for ping frames from the websocket client
- Removed deprecated Spot listen key endpoints
- Removed onListenKeyExpired event from user data stream
- Fixed disposed clients getting returned from UserClientProvider
- Fixed activationPrice parameter mapping in socketClient.UsdFuturesApi.Trading.PlaceConditionalOrderAsync endpoint
-
Version 12.3.1 - 29 Jan 2026
- Added CompleteTime property to BinanceDeposit model
- Added Equity value for UnderlyingType enum
-
Version 12.3.0 - 22 Jan 2026
- Updated CryptoExchange.Net to version 10.3.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Removed legacy websocket message handling and the corresponding UseUpdatedDeserialization client option
- Added Metadata to BinanceExchange
- Removed restClient.SpotApi.ExchangeData.GetIsolatedMarginTierDataAsync endpoint (duplicate)
-
Version 12.2.2 - 19 Jan 2026
- Updated CryptoExchange.Net to version 10.2.5, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Fixed some order book sync issues
-
Version 12.2.1 - 14 Jan 2026
- Updated CryptoExchange.Net to version 10.2.3, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
-
Version 12.2.0 - 13 Jan 2026
- Updated CryptoExchange.Net to version 10.2.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Added SequenceNumber to order book websocket updates
- Added QuantityWithoutRpi to BinanceStreamAggregatedTrade model
- Updated SymbolOrderBook implementations to correctly check sequence numbers
- Fixed CancelConditionalOrderAsync result type
-
Version 12.1.0 - 07 Jan 2026
- Updated CryptoExchange.Net version to 10.1.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Added DataTimeLocal and DataAge properties to DataEvent object
- Added UpdateServerTime, UpdateLocalTime and DataAge properties to (I)SymbolOrderBook
- Added support for Ed25519 signing for websocket API
- Added restClient.SpotApi.Account.GetMarginCapitalFlowDataAsync endpoint
- Fixed error response parsing on rate limit response
-
Version 12.0.1 - 30 Dec 2025
- Updated CryptoExchange.Net version to 10.0.2, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added Symbol property to BinanceStreamMinimalTrade model
- Fixed activation price parameter serialization in restClient.UsdFuturesApi.Trading.PlaceConditionalOrderAsync endpoint
-
Version 12.0.0 - 16 Dec 2025
- Added Net10.0 target framework
- Updated CryptoExchange.Net version to 10.0.0, see https://github.com/JKorf/CryptoExchange.Net/releases/ for full release notes
- Improved performance across the board, biggest gains in websocket message processing
- Updated REST message response handling
- Updated WebSocket message handling
- Added support for Ed25519 credentials when using Net8.0 and newer
- Added UseUpdatedDeserialization socket client options to toggle by new and old message handling
- Added various Performance websocket subscriptions for public streams
- Added SocketIndividualSubscriptionCombineTarget socket client option
- Added RPI support for futures orders
- Added restClient.UsdFuturesApi.ExchangeData.GetSymbolAdlRiskRatingAsync endpoint
- Added restClient.UsdFuturesApi.ExchangeData.GetSymbolAdlRiskRatingsAsync endpoint
- Added RpiCommissionRate to restClient.UsdFuturesApi.Account.GetUserCommissionRateAsync response
- Added socketClient.UsdFuturesApi.ExchangeData.SubscribeToPartialRpiOrderBookUpdatesAsync stream
- Added restClient.UsdFuturesApi.ExchangeData.GetRpiOrderBookAsync endpoint
- Added restClient.UsdFuturesApi.ExchangeData.GetTradingScheduleAsync endpoint
- Added restClient.UsdFuturesApi.Account.SignTradFiAgreementAsync endpoint
- Added socketClient.UsdFuturesApi.ExchangeData.SubscribeToTradingSessionUpdatesAsync stream
- Updated Shared API's subscription update types from ExchangeEvent to DataEvent
- Updated BinanceLiabilityUpdate Principle and Interest property types to decimal?
- Fixed RSA request signing issue
- Removed deprecated BLVT streams/endpoints
-
Version 11.11.0 - 11 Nov 2025
- Updated CryptoExchange.Net version to 9.13.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added new conditional orders REST endpoints for UsdFutures API
- Added new conditional orders Websocket queries for UsdFutures API
- Added new onAlgoOrderUpdate Websocket event for UsdFutures API
-
Version 11.10.0 - 03 Nov 2025
- Updated CryptoExchange.Net to version 9.12.0
- Added support for using SharedSymbol.UsdOrStable in Shared APIs
- Added symbolStatus parameter to SpotApi.ExchangeData endpoints
- Fixed exception when initial trade snapshot has no items in TradeTracker
- Removed some unhelpful verbose logs
-
Version 11.9.1 - 27 Oct 2025
- Added ExpireReason to UsdtFutures order update event
- Added Aggregated exchange parameter to Shared Spot API SubscribeToTradeUpdatesAsync subscription
-
Version 11.9.0 - 16 Oct 2025
- Updated CryptoExchange.Net version to 9.10.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added ClientOrderId mapping on SharedUserTrade models
- Added ITransferRestClient.TransferAsync implementation
- Updated SpotApi IBalanceRestClient.GetBalancesAsync to support funding wallet balance retrieval
-
Version 11.8.0 - 30 Sep 2025
- Updated CryptoExchange.Net version to 9.8.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added ITrackerFactory to TrackerFactory implementation
- Added ContractAddress mapping in Shared IAssetClient implementation
- Added Demo environment
- Added WithdrawNeedsTag property to restClient.SpotApi.Account.GetUserAssetsAsync response model
- Added TravelRuleStatus property to restClient.SpotApi.Account.GetDepositHistoryAsync response model
-
Version 11.7.1 - 10 Sep 2025
- Added page parameter to restClient.CoinFuturesApi.Account.GetIncomeHistoryAsync endpoint
- Fixed some deserialization issues in Mining endpoints
-
Version 11.7.0 - 01 Sep 2025
- Updated CryptoExchange.Net version to 9.7.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- HTTP REST requests will now use HTTP version 2.0 by default
- Added idList parameter to restClient.SpotApi.Account.GetWithdrawalHistoryAsync endpoint
- Added missing OrderRejectReason enum values
- Updated socketClient.SpotApi.Trading.ReplaceOrderAsync response checking
- Updated SimpleEarn API to latest docs
- Fixed Shared spot order status getting reported as filled while actually expired
-
Version 11.6.0 - 25 Aug 2025
- Updated CryptoExchange.Net version to 9.6.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added ClearUserClients method to user client provider
- Added PreMarket value to UnderlyingType Enum
- Added socketClient.SpotApi.Account.SubscribeToUserRiskDataUpdatesAsync subscription and listenkey endpoints
- Added VIP Loan Endpoints (Full Support)
- Updated restClient.SpotApi.Trading.ReplaceOrderAsync response checking
- Fixed Gift Card API deserialization error
-
Version 11.5.1 - 21 Aug 2025
- Added Invalid api key error mapping
-
Version 11.5.0 - 20 Aug 2025
- Updated CryptoExchange.Net to version 9.5.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added improved error parsing
- Added SpecialCommissions to fee responses
- Added Spot API price peg support
- Added support for OrderAmends and OrderLists filter in Spot API symbol
- Added support for priceIndex klines subscription in UsdFutures websocket API
- Added socketClient.UsdFuturesApi.Account.GetAccountInfoV1Async query
- Updated rest request sending too prevent duplicate parameter serialization
- Removed leverage values checks no longer valid
-
Version 11.4.0 - 04 Aug 2025
- Updated CryptoExchange.Net to version 9.4.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Updated CryptoLoans API from partially supported V1 to fully supported V2
- Added Gift Card API endpoints
- Added support for multi-symbol Shared socket subscriptions
-
Version 11.3.0 - 23 Jul 2025
- Updated CryptoExchange.Net to version 9.3.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Updated websocket message matching
-
Version 11.2.0 - 15 Jul 2025
- Updated CryptoExchange.Net to version 9.2.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Fixed exception socketClient.SpotApi.ExchangeData.GetServerTimeAsync
-
Version 11.1.0 - 02 Jun 2025
- Updated CryptoExchange.Net to version 9.1.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added (I)BingXUserClientProvider allowing for easy client management when handling multiple users
- Added restClient.SpotApi.Account.GetDepositAddressesAsync endpoint
-
Version 11.0.1 - 23 May 2025
- Updated spot testnet websocket URLs
- Updated request weight for MarginBorrowAsync and MarginRepayAsync endpoints
-
Version 11.0.0 - 13 May 2025
- Updated CryptoExchange.Net to version 9.0.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added support for Native AOT compilation
- Added RateLimitUpdated event
- Added IBookTickerRestClient implementation to CoinFutures, UsdtFutures and Spot Shared clients
- Added IFuturesOrderClientIdClient implementation to CoinFutures, UsdtFutures Shared clients
- Added ISpotOrderClientIdClient implementation to Spot Shared client
- Added IFuturesTriggerOrderRestClient implementation to CoinFutures, UsdtFutures Shared clients
- Added ISpotTriggerOrderRestClient implementation to Spot Shared client
- Added IFuturesTpSlRestClient implementation to CoinFutures, UsdtFutures Shared clients
- Added SharedSymbol response property to all Shared interfaces response models returning a symbol name
- Added GenerateClientOrderId method to CoinFutures, UsdtFutures and Spot Shared clients
- Added OptionalExchangeParameters and Supported properties to EndpointOptions
- Added TriggerPrice, IsTriggerOrder, IsCloseOrder to SharedFuturesOrder response model
- Added TriggerPrice, IsTriggerOrder to SharedSpotOrder response model
- Added MaxShortLeverage and MaxLongLeverage to SharedFuturesSymbol response model
- Added StopLossPrice and TakeProfitPrice to SharedPosition response model
- Added TriggerPrice and IsTriggerOrder to SharedSpotOrder response model
- Added QuoteVolume to SharedSpotTicker response model
- Added All property to retrieve all available environment on BinanceEnvironment
- Added restClient.UsdtFuturesApi.ExchangeData.GetIndexPriceConstituentsAsync endpoint
- Added restClient.CoinFuturesApi.ExchangeData.GetIndexPriceConstituentsAsync endpoint
- Added restClient.UsdFuturesApi.ExchangeData.GetInsuranceFundBalancesAsync endpoint
- Refactored Shared clients quantity parameters and responses to use SharedQuantity
- Updated all IEnumerable response and model types to array response types
- Updated all PlaceMultipleOrdersAsync methods to return an error if all orders fail to place
- Updated restClient.SpotApi.Trading.GetUserTradesAsync weight from 20 to 5 if orderId parameter is provided
- Fixed incorrect DataTradeMode on certain Shared interface responses
- Fixed deserialization error for trailing orders
- Removed Newtonsoft.Json dependency
- Removed legacy ISpotClient and IFuturesClient implementations
- Removed legacy AddBinance(restOptions, socketOptions) DI overload
-
Version 11.0.0-beta4 - 01 May 2025
- Updated CryptoExchange.Net version to 9.0.0-beta5
- Added property to retrieve all available API environments
-
Version 11.0.0-beta3 - 29 Apr 2025
- Fixed order deserialization error for trailing orders
-
Version 11.0.0-beta2 - 23 Apr 2025
- Updated CryptoExchange.Net to version 9.0.0-beta2
- Added Shared spot ticker QuoteVolume mapping
- Fixed incorrect DataTradeMode on responses
-
Version 11.0.0-beta1 - 22 Apr 2025
- Updated CryptoExchange.Net to version 9.0.0-beta1, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added support for Native AOT compilation
- Added RateLimitUpdated event
- Added IBookTickerRestClient implementation to CoinFutures, UsdtFutures and Spot Shared clients
- Added IFuturesOrderClientIdClient implementation to CoinFutures, UsdtFutures Shared clients
- Added ISpotOrderClientIdClient implementation to Spot Shared client
- Added IFuturesTriggerOrderRestClient implementation to CoinFutures, UsdtFutures Shared clients
- Added ISpotTriggerOrderRestClient implementation to Spot Shared client
- Added IFuturesTpSlRestClient implementation to CoinFutures, UsdtFutures Shared clients
- Added SharedSymbol response property to all Shared interfaces response models returning a symbol name
- Added GenerateClientOrderId method to CoinFutures, UsdtFutures and Spot Shared clients
- Added OptionalExchangeParameters and Supported properties to EndpointOptions
- Added TriggerPrice, IsTriggerOrder, IsCloseOrder to SharedFuturesOrder response model
- Added TriggerPrice, IsTriggerOrder to SharedSpotOrder response model
- Added MaxShortLeverage and MaxLongLeverage to SharedFuturesSymbol response model
- Added StopLossPrice and TakeProfitPrice to SharedPosition response model
- Added TriggerPrice and IsTriggerOrder to SharedSpotOrder response model
- Refactored Shared clients quantity parameters and responses to use SharedQuantity
- Updated all IEnumerable response and model types to array response types
- Updated all PlaceMultipleOrdersAsync methods to return an error if all orders fail to place
- Updated restClient.SpotApi.Trading.GetUserTradesAsync weight from 20 to 5 if orderId parameter is provided
- Removed Newtonsoft.Json dependency
- Removed legacy ISpotClient and IFuturesClient implementations
- Removed legacy AddBinance(restOptions, socketOptions) DI overload
-
Version 10.20.0 - 07 May 2025
- Added NFT Endpoints
- Added missing margin market data endpoints
- Added SelfTradePreventionMode missing enum value
- Removed ceased BVLT endpoints
- Fix Coin-M stream path
-
Version 10.19.1 - 15 Apr 2025
- Added listClientOrderId to restClient.SpotApi.Trading.PlaceOcoOrderListAsync endpoint
- Fixed warning for unknown symbol filter type
-
Version 10.19.0 - 26 Mar 2025
- Added quoteAsset parameter to restClient.SpotApi.Account.GetWalletBalancesAsync endpoint
- Added Denomination property to restClient.SpotApi.Account.GetUserAssetsAsync response model
- Updated SimpleEarn locked response models
- Updated request weight of restClient.SpotApi.ExchangeData.GetAggregatedTradeHistoryAsync to 4
-
Version 10.18.0 - 25 Feb 2025
- Added Coin-M websocket Trade API implementation
- Added SOL staking endpoints to restClient.GeneralApi.Staking
- Added orderId parameter to Spot.GetMarginUserTradesAsync
- Updated futures GetTradeHistoryAsync max limit value from 1000 to 500
- Fixed API doc references for endpoints and subscriptions
- Fixed various spelling mistakes
-
Version 10.17.0 - 11 Feb 2025
- Updated CryptoExchange.Net to version 8.8.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added support for more SharedKlineInterval values
- Added setting of DataTime value on websocket DataEvent updates
- Added contract address and URL properties to BinanceUserAsset model
- Fix Mono runtime exception on rest client construction using DI
-
Version 10.16.2 - 22 Jan 2025
- Updated RewardType Enum values
- Updated weight of restClient.SpotApi.Account.WithdrawAsync from 600 to 900
- Fixed restClient.SpotApi.Account.GetTradeFeeAsync for Us environment
-
Version 10.16.1 - 07 Jan 2025
- Updated CryptoExchange.Net version
- Added Type property to BinanceExchange class
-
Version 10.16.0 - 03 Jan 2025
- Added PriceMatch parameter to UsdFutures order editing
- Added support for premium index klines in socketClient.UsdFuturesApi.ExchangeData.SubscribeToKlineUpdatesAsync
- Updated ETH history response models
-
Version 10.15.0 - 23 Dec 2024
- Updated CryptoExchange.Net to version 8.5.0, see https://github.com/JKorf/CryptoExchange.Net/releases/
- Added SetOptions methods on Rest and Socket clients
- Added setting of DefaultProxyCredentials to CredentialCache.DefaultCredentials on the DI http client
- Improved websocket disconnect detection
- Set Symbol on Spot and UsdFutures socket ExchangeData.GetOrderBookAsync response
-
Version 10.14.0 - 12 Dec 2024
- Added initial Agent endpoints
- Added onUserDataStreamTerminated and onBalanceLockUpdate updates to socketClient.SpotApi.SubscribeUserDataUpdatesAsync
- Added IsLiquidationOrder, IsAdlAutoCloseOrder and IsSettlementOrder helper properties to BinanceFuturesOrder model
- Added PreMarket handling to PermissionType enum
- Split AccountType enum into AccountType and PermissionType
- Changed restClient.UsdFuturesApi.Trading.GetOrdersAsync symbol parameter to be optional
-
Version 10.13.2 - 08 Dec 2024
- Updated CryptoExchange.Net to version 8.4.4 to fix deserialization error in .net framework
-
Version 10.13.1 - 05 Dec 2024
- Fixed null exception caused by invalid key for copy trading
- Fixed BinanceSubAccountTransferSubAccount model deserialization
-
Version 10.13.0 - 03 Dec 2024
- Updated client order id logic
- Added AllowAppendingClientOrderId option
- Added listClientOrderId parameter to restClient.SpotApi.Trading.PlaceOcoOrderListAsync
- Removed BrokerId option
- Fixed restClient.GeneralApi.SimpleEarn.GetLockedProductPositionsAsync deserialization
- Fixed orderbook creation via BinanceOrderBookFactory
-
Version 10.12.0 - 28 Nov 2024
- Updated CryptoExchange.Net to version 8.4.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.4.0
- Added GetFeesAsync Shared REST client implementations
- Updated BinanceOptions to LibraryOptions implementation
- Updated test and analyzer package versions
-
Version 10.11.0 - 25 Nov 2024
- Added WithdrawInternalMin to restClient.SpotApi.Account.GetUserAssetsAsync response model
- Added EnableFixApiTrade and EnableFixReadOnly to restClient.SpotApi.Account.GetAPIKeyPermissionsAsync response model
- Added IsOptionsEnabled and IsPortfolioMarginRetailEnabled to restClient.SpotApi.Account.GetAccountVipLevelAndStatusAsync response model
- Fixed inverted order side for Shared trades
- Removed restClient.SpotApi.Account.GetAutoConvertStableCoinConfigAsync, SetAutoConvertStableCoinConfigAsync and ConvertBusdAsync as theyre deprecated
-
Version 10.10.0 - 19 Nov 2024
- Updated CryptoExchange.Net to version 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 BinanceExchange class
- Updated client constructors to accept IOptions from DI
- Removed redundant BinanceSocketClient constructor
- Fixed ListenKey property not set on spot websocket account data updates
-
Version 10.9.2 - 08 Nov 2024
- Fixed mixed up page and limit parameter on restClient.UsdFuturesApi.Account.GetIncomeHistoryAsync endpoint
-
Version 10.9.1 - 08 Nov 2024
- Added page parameter to restClient.UsdFuturesApi.Account.GetIncomeHistoryAsync endpoint
-
Version 10.9.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 10.8.1 - 01 Nov 2024
- Added restClient.CoinFuturesApi.Account.GetDownloadIdForOrderHistoryAsync endpoint
- Added restClient.CoinFuturesApi.Account.GetDownloadLinkForOrderHistoryAsync endpoint
- Added restClient.CoinFuturesApi.Account.GetDownloadIdForTradeHistoryAsync endpoint
- Added restClient.CoinFuturesApi.Account.GetDownloadLinkForTradeHistoryAsync endpoint
-
Version 10.8.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 BinanceExchange class
- Added support Side setting on SharedTrade model
- Added BinanceTrackerFactory for creating trackers
- Added overload to Create method on BinanceOrderBookFactory support SharedSymbol parameter
- Fixed Shared rest GetTradeHistoryAsync pagination
- Added catch around HttpClientHandler.AutomaticDecompression setting as it's not support on Blazor WASM
-
Version 10.7.0 - 21 Oct 2024
- Added SelfTradePreventionMode and PriceMatch parameters and responses for Coin-M Futures API
- Added returnPermissionSets and symbolStatus parameters to restClient.SpotApi.ExchangeData.GetExchangeInfoAsync endpoint
- Fixed issues with restClient.GeneralApi.AutoInvest.GetSubscriptionTransactionHistoryAsync
- Fixed deserialization issue subaccount transfer
-
Version 10.6.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 10.6.0 - 09 Oct 2024
- Updated CryptoExchange.Net to version 8.0.2, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/8.0.2
- Added USD-M Futures web socket order API
- Fixed pagination for shared closed orders USD futures
-
Version 10.5.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, USD-M Futures, Coin-M Futures Rest and Socket clients
- Updated Id property from
string?tostringon BinanceWithdrawalPlaced model - Updated Sourcelink package version
- Marked ISpotClient and IFuturesClient references as deprecated
-
Version 10.4.0 - 11 Sep 2024
- Added onTradeUpdate callback for UsdFuturesApi.SubscribeToUserDataUpdatesAsync
- Changed CrossUnrealizedPnl field in futures balances to support testnet response
- Fix for UsdFuturesApi.Trading.EditMultipleOrdersAsync order id serialization
- Fix for GeneralApi.AutoInvest.GetPlansAsync deserialization
- Fixed incorrect api docs reference for CoinFuturesApi.ExchangeData.GetFundingRatesAsync
-
Version 10.3.0 - 28 Aug 2024
- Updated CryptoExchange.Net to version 7.11.2, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.11.2
- Added GeneralApi.AutoInvest endpoints
- Added UsdFuturesApi convert endpoints
- Fixed SubAccountId property deserialization in deposit history
- Updated some request weights for ratelimiting
-
Version 10.2.1 - 18 Aug 2024
- Fixed walletType serialization on SpotApi.Trading.ConvertQuoteRequestAsync endpoint
-
Version 10.2.0 - 13 Aug 2024
- Re-added the UsdFuturesApi.Account.GetAccountInfoV2Async endpoint as the V3 endpoint is missing data
- Renamend UsdFuturesApi.Account.GetAccountInfoAsync to GetAccountInfoV3Async
- Fixed SpotApi.ExchangeData.GetProductsAsync deserialization
- Fixed GeneralApi.SimpleEarn.GetLockedRewardRecordsAsync deserialization
-
Version 10.1.1 - 08 Aug 2024
- Fix UnrealizedPnl deserialization in CoinFuturesApi.Account.GetPositionInformationAsync
-
Version 10.1.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 BinanceFuturesAccountAsset MaintMargin deserialization
- Fixed BinancePosition MaintMargin deserialization
- Fixed BinancePosition UnrealizedProfit deserialization for Coin-M futures
-
Version 10.0.1 - 05 Aug 2024
- Fixed deserialization issue UsdtFuturesApi.Account.GetIncomeHistoryAsync
-
Version 10.0.0 - 27 Jul 2024
- Updated CryptoExchange.Net to version 7.10.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.10.0
- Switch from Newtonsoft.Json implementation to System.Text.Json for (de)serialization
- Refactored from old per type enum converter to EnumConverter usage
- Added SpotApi.Account.GetCommissionRatesAsync endpoint
- Added UsdFuturesApi.Account.GetSymbolConfigurationAsync endpoint
- Added UsdFuturesApi.Account.GetAccountConfigurationAsync endpoint
- Added UsdFuturesApi.Trading.GetPositionsAsync endpoint
- Added PermissionSets property to SpotApi.ExchangeData.GetExchangeInfoAsync symbol response
- Updated UsdFuturesApi.Account.GetBalancesAsync to V3
- Updated UsdFuturesApi.Account.GetAccountInfoAsync to V3
-
Version 9.12.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
- Updated WebSocket rate limit rule to prevent triggering disconnect
-
Version 9.11.1 - 02 Jul 2024
- Updated CryptoExchange.Net to V7.8.0
- Updated ratelimiting for per-endpoint limits
-
Version 9.11.0 - 23 Jun 2024
- Updated CryptoExchange.Net to version 7.7.0, see https://github.com/JKorf/CryptoExchange.Net/releases/tag/7.7.0
- Added dedicated connection configuration; a websocket connection can now be established before making the first request by calling
binanceSocketClient.SpotApi.PrepareConnectionsAsync(); - Added CancellationToken optional parameter to websocket requests
- Updated response models from classes to records
-
Version 9.10.0 - 11 Jun 2024
- Added new SpotApi.Trading.PlaceOtoOrderListAsync and SpotApi.Trading.PlaceOtocoOrderListAsync endpoints
- Fixed GetProductsAsync endpoints by allowing automatic decompression
- Updated CryptoExchange.Net to v7.6.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
-
Version 9.9.8 - 02 Jun 2024
- Added SpotApi.Account.GetAccountVipLevelAndStatusAsync endpoint
- Added UsdFuturesApi.Account.GetBnbBurnStatusAsync and UsdFuturesApi.Account.SetBnbBurnStatusAsync endpoints
- Added missing GoodTillDate TimeInForce conversion
-
Version 9.9.7 - 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 9.9.6 - 05 May 2024
- Updated various response models
- Updated CoinFuturesApi.Account.GetBracketsAsync to V2 endpoint
- Updated CoinFuturesApi.Trading.PlaceMultipleOrdersAsync orders parameter from array to IEnumerable
-
Version 9.9.5 - 01 May 2024
- Updated multiple response models
- Fixed multiple bugs after new, more thorough unit testing implementation
- Removed duplicate SpotApi.Trading.ConvertTransferAsync and GetConvertTransferHistoryAsync endpoints
- Updated CryptoExchange.Net to v7.5.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
-
Version 9.9.4 - 28 Apr 2024
- Added SpotApi.Account.GetWithdrawalAddressesAsync endpoint
- Added Url and ApiDocsUrl to BinanceExchange static class
- Added BinanceOrderBookFactory book creation method
- Fixed BinanceOrderBookFactory 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 9.9.3 - 23 Apr 2024
- Added missing UniversalTransferType enum values
- Fixed CoinFuturesApi.Account.GetIncomeHistoryAsync endpoint url
- Updated CryptoExchange.Net to 7.3.3, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
-
Version 9.9.2 - 19 Apr 2024
- Added CoinFuturesApi.Account.GetDownloadIdForTransactionHistoryAsync endpoint
- Added CoinFuturesApi.Account.GetDownloadLinkForTransactionHistoryAsync endpoint
- Added SpotApi.ExchangeData.GetTradingDayTickerAsync endpoint
- Added SpotApi.ExchangeData.GetTradingDayTickersAsync endpoint
- Added computeFeeRates parameter to SpotApi.Trading.PlaceTestOrderAsync
- Updated SpotApi.Trading.PlaceTestOrderAsync response
- Updated broker reference setting
- Updated CryptoExchange.Net to 7.3.2 fixing issue which caused some endpoints with specific rate limits to fail
-
Version 9.9.1 - 19 Apr 2024
- Fixed Start/KeepAlive/Stop UserStream operations returning error
-
Version 9.9.0 - 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
- Re-implemented client side rate limiting
- Added handling of RetryAfter response for both rest and socket API
- Added omitZeroBalances parameter to SpotApi.Account.GetAccountInfoAsync
- Added new PlaceOcoOrderListAsync as replacement for deprecated PlaceOcoOrderAsync endpoint
- Added listenKeyExpired event handler for Spot websocket user data subscription
- Added OTOAllowed to SpotApi.ExchangeData.GetExchangeInfoAsync symbol response model
- Moved GetTradeFeeAsync from SpotApi.ExchangeData to SpotApi.Account
- Changed WebCallResult