CryptoExchange.Net 7.5.2

CryptoExchange.Net

CryptoExchange.Net is a base library which is used to implement different cryptocurrency (exchange) API's. It provides a standardized way of implementing different API's, which results in a very similar experience for users of the API implementations. Note that the CryptoExchange.Net package itself can not be used directly for accessing API's. Either install a client library from the list below or use CryptoClients.Net which includes access to all exchange API's.

For more information on what CryptoExchange.Net and it's client libraries offers see the Documentation.

Current implementations

The following API's are directly supported. Note that there are 3rd party implementations going around, but only these are created and supported by me:

Exchange	Repository	Nuget
Binance	JKorf/Binance.Net
BingX	JKorf/BingX.Net
Bitfinex	JKorf/Bitfinex.Net
Bitget	JKorf/Bitget.Net
Bybit	JKorf/Bybit.Net
CoinEx	JKorf/CoinEx.Net
CoinGecko	JKorf/CoinGecko.Net
Huobi/HTX	JKorf/Huobi.Net
Kraken	JKorf/Kraken.Net
Kucoin	JKorf/Kucoin.Net
Mexc	JKorf/Mexc.Net
OKX	JKorf/OKX.Net

Any of these can be installed independently or install CryptoClients.Net which includes all exchange API's.

Discord

A Discord server is available here. Feel free to join for discussion and/or questions around the CryptoExchange.Net and implementation libraries.

Support the project

I develop and maintain this package on my own for free in my spare time, 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 7.5.2 - 07 May 2024

  • Fixed SetApiCredentials not correctly being used by rate limiter causing exception

• Version 7.5.1 - 03 May 2024

  • Some small improvements in unit testing components

• Version 7.5.0 - 01 May 2024

  • Added testing implementations
  • Small refactor AuthenticationProvider to allow better testing
  • Change result of MessageAccessor.Read methods to CallResult so error can be returned
  • Moved some DateTimeConverter logic to seperate methods to allow access from outside converters

• Version 7.4.0 - 28 Apr 2024

  • Added FormatSymbol on IBaseApiClient interface
  • Added IOrderBookFactory interface
  • Removed ExchangeOptions as base class for OrderBookOptions

• Version 7.3.3 - 23 Apr 2024

  • Added support for new DateTime format parsing
  • Updated some logging
  • Fixed concurrency issue in rest request sending

• Version 7.3.2 - 19 Apr 2024

  • Fix for endpoint specific rate limiting throwing exception

• Version 7.3.1 - 18 Apr 2024

  • Fixed websocket system subscriptions getting marked as unconfirmed when reconnecting

• Version 7.3.0 - 17 Apr 2024

  • Added new method for sending Rest requests which splits the static and dynamic parameters
  • Refactored rate limiting implementation
    • Ratelimiters now statically applied for all clients
    • Added support for different rate limit window types
    • Added modular configuration of rate limits
    • Added rate limit check when creating websocket connections
    • Added automatic handling and retry for Retry-After responses
    • Added configuration for setting ratelimit for each individual endpoint
    • Added event for when rate limit is triggered
  • Added SocketClient GetSocketApiClientStates method

• Version 7.2.1 - 05 Apr 2024

  • Improved websocket reconnect logic
  • Simplified SystemTextJsonMessageAccessor value retrieval
  • Fixed System.Text.Json BoolConverter value writing

• Version 7.2.0 - 24 Mar 2024

  • Added ArrayParametersSerialization.JsonArray support
  • Refactored to high-performance logging for hot paths
  • Updated SymbolOrderBook to use LoggerFactory
  • Performance improvements
  • Small bug fixes
  • Updated logging

• Version 7.1.0 - 16 Mar 2024

  • Added initial System.Text.Json deserialization support
  • Added support for setting MessageSendSizeLimit for websocket clients to limit message size
  • Added Exchange name property to IRestClient and ISocketClient interface
  • Abstracted out rest client deserialization so different (de)serializers can be used
  • Cleaned up rest client response handling
  • Continued update of websocket message handling
    • Use ReadonlyMemory<byte> to represent message data to prevent copying data multiple times
    • Switched back to non-async websocket message handling to remove tasks overhead
  • Updated package dependencies to latest versions
  • Updated unit test package dependencies and updated tests accordingly
  • Moved some properties used by the RestApiClient from the BaseApiClient
  • Fixed issue with multiple concurrent subscribe calls in socket client

• Version 7.0.0 - 24 Feb 2024

  • Full overhaul of Websocket message handling
  • Abstracted out Newtonsoft.Json references in preparation of moving to System.Text.Json
  • Updated SendPeriodic to operate on connection level instead of client level to prevent looping when there are no connections
  • Added check to not send an unsubscribe message if there is another subscription listening to the same events
  • Added CryptoRestClient and CryptoSocketClient as aggregate for accessing different exchange APIs
  • Updated socket client log messages
  • Updated socket client GetSubscriptionState output

• Version 6.2.5 - 09 Jan 2024

  • Added support for deserializing null and empty string values to BoolConverter

• Version 6.2.4 - 04 Jan 2024

  • Fixed parsing of DateTime value of zero with additional zero decimal places

• Version 6.2.3 - 02 Dec 2023

  • Fixed requestBodyFormat parameter handling

• Version 6.2.2 - 02 Dec 2023

  • Added support for specifying the request body content type on a per request basis
  • Added DecimalStringWriterConverter
  • Added RequestId to WebCallResult model
  • Updated response logging

• Version 6.2.1 - 28 Oct 2023

  • Utility methods

• Version 6.2.0 - 24 Oct 2023

  • Added SerializerOptions helper class for setting a default serializer
  • Added ParameterCollection helper class for easier parameter definition
  • Added extra helper methods AuthenticationProvider
  • Remove interface entries meant for internal use
  • Added support for writing int values to the EnumConverter

• Version 6.1.5 - 08 Oct 2023

  • Added UpdateType to socket DataEvent
  • Added additional scenarios for BoolConverter
  • Updated some logging

• Version 6.1.4 - 23 Sep 2023

  • Added BoolConverter
  • Added parameter for logging warning message on missing enum entry to EnumConverter

• Version 6.1.3 - 18 Sep 2023

  • Fix for concurrency exception in socket subscription

• Version 6.1.2 - 11 Sep 2023

  • Added support for multiple of the same ratelimiting type in the same rate limiter
  • Fixed nullreference on rate limit error if no Retry-After header is returned

• Version 6.1.1 - 04 Sep 2023

  • Fixes for json converters

• Version 6.1.0 - 24 Aug 2023

  • Added support for ratelimiting on socket connections
  • Added rest ratelimit handling and parsing
  • Added ServerRatelimitError error

• Version 6.0.3 - 23 Jul 2023

  • Fixed Proxy not getting applied in rest clients when not using DI

• Version 6.0.2 - 05 Jul 2023

  • Added properties generic dictionary to SocketConnection

• Version 6.0.1 - 29 Jun 2023

  • Added LogLevel optional parameter to TraceLoggerProvider

• Version 6.0.0 - 25 Jun 2023

  • Updated ApiCredentials to support RSA signing as well as the default Hmac signature
  • Removed custom logging implementation in favor of using Microsoft.Extensions.Logging ILogger directly
  • Refactored client options for easier use
  • Added easier way of switching environments
  • Added ResponseLength and ToString() override on WebCallResult object
  • Fixed memory leak in AsyncResetEvent

• Version 5.4.3 - 14 Apr 2023

  • Fixed potential threading exception in socket connection

• Version 5.4.2 - 01 Apr 2023

  • Reverted socket changes as it seems to cause reconnect to hang

• Version 5.4.1 - 18 Mar 2023

  • Added CalculateTradableAmount to SymbolOrderBook
  • Improved socket reconnect robustness
  • Fixed api rate limiter not working correctly

• Version 5.4.0 - 14 Feb 2023

  • Added unsubscribing when receiving subscribe answer after the request timeout has passed
  • Fixed socket options copying
  • Made TimeSync implementation optional
  • Cleaned up ApiCredentials and added better support for extending ApiCredentials

• Version 5.3.1 - 08 Dec 2022

  • Added default request parameter ordering before applying authentication
  • Fixed possible issue where a socket would reconnect when it should close if it was already in reconnecting

• Version 5.3.0 - 14 Nov 2022

  • Reworked client architecture, shifting funcationality to the ApiClient
  • Fixed ArrayConverter exponent parsing
  • Fixed ArrayConverter not checking null
  • Added optional delay setting after establishing socket connection
  • Added callback for revitalizing a socket request when reconnecting
  • Fixed proxy setting websocket

• Version 5.2.4 - 31 Jul 2022

  • Added handling of PlatformNotSupportedException when trying to use websocket from WebAssembly
  • Changed DataEvent to have a public constructor for testing purposes
  • Fixed EnumConverter serializing values without proper quotes
  • Fixed websocket connection reconnecting too quickly when resubscribing/reauthenticating fails

• Version 5.2.3 - 19 Jul 2022

  • Fixed socket getting disconnected when no data timeout is reached instead of being reconnected

• Version 5.2.2 - 17 Jul 2022

  • Added support for retrieving a new url when socket connection is lost and reconnection will happen

• Version 5.2.1 - 16 Jul 2022

  • Fixed socket reconnect issue
  • Fixed message not handled messages after unsubscribing
  • Fixed error returning for non-json error responses

• Version 5.2.0 - 10 Jul 2022

  • Refactored websocket code, removed some clutter and simplified
  • Added ReconnectAsync and GetSubscriptionsState methods on socket clients

• Version 5.1.12 - 12 Jun 2022

  • Changed time sync so requests no longer wait for it to complete unless it's the first time
  • Made log client options changable after client creation
  • Fixed proxy setting not used when reconnecting socket
  • Changed MaxSocketConnections to a client options
  • Updated socket reconnection logic

• Version 5.1.12 - 12 Jun 2022

  • Changed time sync so requests no longer wait for it to complete unless it's the first time
  • Made log client options changable after client creation
  • Fixed proxy setting not used when reconnecting socket
  • Updated socket reconnection logic

• Version 5.1.11 - 24 May 2022

  • Added KeepAliveInterval setting
  • Fixed port not being copied when setting parameters on request
  • Fixed inconsistent PackageReference casing in csproj

• Version 5.1.10 - 22 May 2022

  • Fixed order book reconnecting while Diposed
  • Fixed exception when disposing socket client while reconnecting
  • Added additional null/default checking in DateTimeConverter
  • Changed ConnectionLost subscription event to run in seperate task to prevent exception/longer operations from intervering with reconnecting

• Version 5.1.9 - 08 May 2022

  • Added latency to the timesync calculation
  • Small fix for exception in socket close handling

• Version 5.1.8 - 01 May 2022

  • Cleanup socket code, fixed an issue which could cause connections to never reconnect when connection was lost
  • Added support for sending requests which expect an empty response
  • Fixed issue with the DateTimeConverter date interpretation

• Version 5.1.7 - 14 Apr 2022

  • Moved some Rest parameters from BaseRestClient to RestApiClient to allow different implementations for sub clients

• Version 5.1.6 - 10 Mar 2022

  • Updated EnumConverter to properly handle emtpy/null and default values

• Version 5.1.5 - 09 Mar 2022

  • Removed ResubscribeMaxRetries default value of 5
  • Updated logging and log verbosity

• Version 5.1.4 - 04 Mar 2022

  • Fixed ArraySerialization handling
  • Added check for invalid rate limit configured for a request

• Version 5.1.3 - 01 Mar 2022

  • Fixed some issues in websocket reconnection, should be more robust now
  • Prevent duplicate data reading on error in rest request
  • Added ApiName to time sync state to improve log feedback

• Version 5.1.2 - 27 Feb 2022

  • Fixed issue where the rate limiter was messing with time syncing
  • Added support for delegate parameters
  • Added ignoreRateLimit paramter in SendRequestAsync

• Version 5.1.1 - 24 Feb 2022

  • Fixed issue ApiCredentials

• Version 5.1.0 - 24 Feb 2022

  • Improved dispose handling in SymbolOrderBook
  • Fixed TimeSync RecalculationInterval not being respected
  • Small rework client options

• Version 5.0.0

  • Added Github.io page for documentation: https://jkorf.github.io/CryptoExchange.Net/
  • Added single DateTimeConverter replacing the different timestamp converters
  • Added additional request related properties to WebCallResult
  • Added CancelationToken support for websockets
  • Added CancelationToken support for SymbolOrderBook starting
  • Added TimeSync support
  • Refactored base client classes into BaseClient and ApiClient to provide a more defined client structure
  • Refactored client options to have better control over each different ApiClient
  • Refactored authentication provider to be more flexible
  • Refactored rate limiter implementation
  • Refactored IExchangeClient interface to ISpotClient and IFuturesClient
  • Refactored socket reconnection to immediately try to reconnect before waiting the ReconnectTimeout
  • Improved SymbolOrderBook stability
  • Updated code docs

• Version 4.2.8 - 08 Oct 2021

  • Fixed deadlock in socket receive
  • Fixed issue in reconnection handling when the client is disconnected again during resubscribing
  • Added some additional checking of socket state to prevent sending/expecting data when socket is not connected

• Version 4.2.7 - 06 Oct 2021

  • Made receivedMessages protected again to allow implementations with custom transport (Bittrex) to use it again

• Version 4.2.6 - 06 Oct 2021

  • Fixed an issue causing socket client to stop processing data in .NET Framework

• Version 4.2.5 - 05 Oct 2021

  • Added custom async wait event implementation as previous method seems to not work 100% of the time

• Version 4.2.4 - 30 Sep 2021

  • Fix for InvalidOperationExceptions when running socket connections from .Net framework

• Version 4.2.3 - 29 Sep 2021

  • Added IncomingKbps property to socket/socket client
  • Updated logging
  • Socket performance improvements

• Version 4.2.2 - 23 Sep 2021

  • Restored missing request parameters log

• Version 4.2.1 - 22 Sep 2021

  • Fìx for websocket not automatically reconnecting when connection is closed unexpectedly

• Version 4.2.0 - 20 Sep 2021

  • Prevent reconnect spamming when invalid checksum is calculated in SymbolOrderBook
  • Added default nonce provider implementation

• Version 4.1.0 - 15 Sep 2021

  • Added overload for UnsubscribeAsync with id parameter
  • Added parameter position configuration per HttpMethod type
  • Added option to send custom headers with each requets
  • Added option to send custom headers with individual requests
  • Added debug data on error

• Version 4.0.8 - 26 Aug 2021

  • Added rate limiting option for outgoing messages per socket

• Version 4.0.7 - 24 Aug 2021

  • Additional error info on websocket exception

• Version 4.0.6 - 24 Aug 2021

  • Removed some debug logging

• Version 4.0.5 - 24 Aug 2021

  • Added ConnectionClosed event on UpdateSubscriptions to signal the connection was closed and no reconnecting is happening

• Version 4.0.4 - 24 Aug 2021

  • Websocket connection fixes/improvements
  • Added ChecksumValidationEnabled option for controlling checksum validation in SymbolOrderBook
  • Added MaxReconnectTries option
  • Added MaxResubscribeTries option
  • Added MaxConcurrentResubscriptionsPerSocket option
  • Fix for TimestampSecondsConverter rounding to nearest millisecond

• Version 4.0.3 - 20 Aug 2021

  • Fix for concurrent sent socket issue

• Version 4.0.2 - 20 Aug 2021

  • Fixed socket client continuing before the send/receive loops have been started, which could cause issues when doing concurrent connections

• Version 4.0.1 - 13 Aug 2021

  • Fixed OperationCancelledException when closing socket from a project targeting .net framework

• Version 4.0.0 - 12 Aug 2020

  • Release version, summed up changes from previous beta releases:
    • Removed Websocket4Net dependency in favor of a ClientWebSocket native implementation for websocket connections
    • Socket events now always come wrapped in a DataEvent<> object which contain the timestamp of the data, and optionally the originally received json string
    • Implemented usage of the Microsoft.Extensions.Logging.Abstractions ILogger interface instead of a custom implementation
    • Added some properties to the IExchangeClient interface
      • ICommonOrder.CommonOrderTime
      • ICommonOrder.CommonOrderStatus enum
      • ICommonTrade.CommonTradeTime
    • Added OnOrderPlaced and OnOrderCanceled events on the IExchangeClient interface
    • Added ExchangeHelpers static class for various helper methods
    • Removed non-async methods due to too much overhead in development/maintainance
      • If you were previously using non-async methods you can add .Result to the end of the async call to get the same result
    • Added Book property to SymbolOrderBook for a book snapshot
    • Added CalculateAverageFillPrice to SymbolOrderBook to calculate the average fill price for an order with the current order book state
    • Various fixes

• Version 4.0.0-beta15 - 12 Aug 2021

  • Conditional version Logging.Abstractions

• Version 4.0.0-beta14 - 09 Aug 2021

  • Fix for bug in processing order in SymbolOrderBook

• Version 4.0.0-beta13 - 31 Jul 2021

  • Fix for socket connection

• Version 4.0.0-beta12 - 26 Jul 2021

  • Fix for socket connection

• Version 4.0.0-beta11 - 09 Jul 2021

  • Added CalculateAverageFillPrice to SymbolOrderBook
  • Added Book property to SymbolOrderBook
  • Added Async postfix to async methods

• Version 4.0.0-beta10 - 07 Jul 2021

  • Updated BaseConverter to be case sensitive
  • Added ExchangeHelpers class containing some helper methods
  • Fixed responses not being logged on Trace log level
  • Added some code docs

• Version 4.0.0-beta9 - 17 Jun 2021

  • Small fixes

• Version 4.0.0-beta8 - 08 Jun 2021

  • Fixed exception socket buffer size in .net framework

• Version 4.0.0-beta7 - 07 Jun 2021

  • Added CommonOrderTime to IOrder
  • Added OrderStatus enum for IOrder
  • Added OnOrderPlaced and OnOrderCanceled events on IExchangeClient
  • Added CommonTradeTime to ICommonTrade

• Version 4.0.0-beta6 - 01 jun 2021

  • Some logging adjustments
  • Fixed some async issues

• Version 4.0.0-beta5 - 26 May 2021

  • Added DataEvent wrapper for socket updates
  • Added optional original json output
  • Changed logging implementation to use ILogger

• Version 4.0.0-beta4 - 06 mei 2021

  • Added analyzers
  • Fixed some warnings

• Version 4.0.0-beta3 - 30 Apr 2021

  • Updated socket closing

• Version 4.0.0-beta2 - 30 apr 2021

  • Fix for closing socket without timeout task

• Version 4.0.0-beta1 - 30 apr 2021

  • Removed Websocket4Net dependency
  • Added custom ClientWebSocket implementation
  • Renamed handler → subscription internally
  • Renamed socket → socketConenction when type is socketConnection

• Version 3.9.0 - 28 apr 2021

  • Added optional JsonSerializer parameter to SendRequest to use during deserialization
  • Fix for unhandled message warning when unsubscribing a socket subscription

• Version 3.8.1 - 19 apr 2021

  • Added debug logs
  • Added ValidateNullOrNotEmpty extension method

• Version 3.8.0 - 30 mrt 2021

  • Better handling of json errors while deserializing stream
  • Added string datetime converter

• Version 3.7.1 - 10 mrt 2021

  • Performance improvemnt for the ArrayConverter

• Version 3.7.0 - 01 mrt 2021

  • Changed GetResponse in RestClient to protected
  • Added configuration for deterministic build

• Version 3.6.1 - 16 feb 2021

  • Fix for timing related exception when stopping an symbol order book

• Version 3.6.0 - 22 jan 2021

  • Added CommonVolume and CommonOpenTime to ICommonKline interface

• Version 3.5.0 - 11 jan 2021

  • Additional info on exception messages
  • Added support for rate limiting using credits

• Version 3.4.0 - 21 dec 2020

  • Updated IExchangeClient interface
  • Fix for dropping message after timeout on socket
  • Added virtual HandleUnhandledMessage method in SocketClient

• Version 3.3.0 - 10 dec 2020

  • Added client name
  • Added common interfaces
  • Fixed api key plain text storing in RateLimitterApiKey

• Version 3.2.1 - 19 nov 2020

  • Fixed error code parsing

• Version 3.2.0 - 19 nov 2020

  • Fix for multiple socket subscriptions re-using the same socket connection
  • Updated errors

• Version 3.1.0 - 08 Oct 2020

  • Added CallResult without type parameter for calls which don't return data
  • Added GetErrorOrResult method on CallResult to support proper nullability checking
  • Fix for reading credentials from file
  • Fix for setting custom base addresses in clients

• Version 3.0.15 - 06 Oct 2020

  • Changed default ShouldCheckObjects to false to prevent spam in logging

• Version 3.0.14 - 24 Aug 2020

  • Updated exception message logging

• Version 3.0.13 - 24 Aug 2020

  • Added request tracing id for logging
  • Added shared HttpClient option

• Version 3.0.12 - 12 Aug 2020

  • Named parameters on SymbolOrderBook events

• Version 3.0.11 - 20 Jun 2020

  • Added support for checksum in SymbolOrderBook

• Version 3.0.10 - 16 Jun 2020

  • Fix for order book synchronization

• Version 3.0.9 - 07 Jun 2020

  • Added arraySerialization and postParameterPosition to AuthenticationProvider interface
  • Fixed array serialization in request body

• Version 3.0.8 - 02 Jun 2020

  • Added requestBodyEmptyContent setting for rest client
  • Added TryParseError for rest implementations to check for error with success status code

• Version 3.0.7 - 20 May 2020

  • Added error debug output
  • Fix for unsubscribe causing possible deadlock

• Version 3.0.6 - 03 Mar 2020

  • Added BestOffer to SymbolOrderBook, removed invalid check on proxy

• Version 3.0.5 - 05 Feb 2020

  • Added PausedActivity events on socket subscriptions

• Version 3.0.4 - 29 Jan 2020

  • Removed unnecessary json serialization

• Version 3.0.3 - 23 Jan 2020

  • Added OnBestOffersChanged event to order book implementations

• Version 3.0.2 - 10 Dec 2019

  • Removed invalid check for unauthenticated proxy

• Version 3.0.1 - 14 Nov 2019

  • Re-enabled debug response logging

• Version 3.0.0 - 23 Oct 2019

  • Updated to C# 8.0
  • Added .NetStandard2.1 support
  • Added Nullability support
  • Now using HttpClient instead of WebRequest, should result in faster consequtive requests
  • Added CancellationToken support
  • Added bool compare override to CallResult (now possible to if(callresult) instead of if(callresult.Success))
  • Added input validation methods
    • Wrong input will now throw exceptions rather than error results
  • OnOrderBookUpdate event added to SymbolOrderBook

• Version 2.1.8 - 29 Aug 2019

  • Added array serialization options for implementations

• Version 2.1.7 - 07 Aug 2019

  • Fixed bug with socket connection not being disposed after lost connection
  • Resubscribing after reconnecting socket now in parallel

• Version 2.1.6 - 06 Aug 2019

  • Fix for missing subscription events if they are also a request response, added code docs

• Version 2.1.5 - 09 jul 2019

  • Updated SymbolOrderBook

• Version 2.1.4 - 24 jun 2019

  • Added checks for json deserialization issues

• Version 2.1.3 - 16 may 2019

  • Refactored SymbolOrderBook
  • Added BestBid/BestAsk properties for order book

• Version 2.1.2 - 14 may 2019

  • Added order book base class for easy implementation
  • Added additional constructor to ApiCredentials to be able to read from file