Binance.Net" class="reference-link"> Binance.Net

Binance.Net is a strongly typed client library for accessing the Binance 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 (binance.com, binance.us, testnet)
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 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

REST Endpoints

// 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;

Websocket streams

// 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 Binance.Net documentation, CryptoExchange.Net 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
BingX	JKorf/BingX.Net
Bitfinex	JKorf/Bitfinex.Net
Bitget	JKorf/Bitget.Net
BitMart	JKorf/BitMart.Net
BitMEX	JKorf/BitMEX.Net
Bybit	JKorf/Bybit.Net
Coinbase	JKorf/Coinbase.Net
CoinEx	JKorf/CoinEx.Net
CoinGecko	JKorf/CoinGecko.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
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.Loans`
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

Alternatively, sponsor me on Github using Github Sponsors.

Release notes

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? to string on 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
  responses to WebCallResult
  Removed deprecated endpoints
  Version 9.8.1 - 03 Apr 2024
  - Added SpotApi.Account.GetWalletBalancesAsync endpoint
  - Fixed SpotApi.Account.GetMarginLoansAsync isolatedSymbol parameter not getting send
  - Removed pre-send symbol validation
  Version 9.8.0 - 01 Apr 2024
  - Added SpotApi.ExchangeData.GetDelistScheduleAsync endpoint
  - Added UsdFuturesApi.Account.GetOrderRateLimitAsync endpoint
  - Added UsdFuturesApi.ExchangeData.GetBasisAsync endpoint
  - Updated Spot Margin endpoints
  - Updated UsdFuturesApi.ExchangeData.GetPricesAsync endpoint to V2
  - Updated UsdFuturesApi.Trading.PlaceOrderAsync parameters
  - Removed deprecated BSwap endpoints
  Version 9.7.1 - 24 Mar 2024
  - Updated CryptoExchange.Net to 7.2.0, see https://github.com/JKorf/CryptoExchange.Net?tab=readme-ov-file#release-notes for release notes
  Version 9.7.0 - 16 Mar 2024