Feature/9.0.0 (#236)

* Added support for Native AOT compilation * Updated all IEnumerable response types to array response types * Added Pass support for ApiCredentials, removing the need for most implementations to add their own ApiCredentials type * Added KeepAliveTimeout setting setting ping frame timeouts for SocketApiClient * Added IBookTickerRestClient Shared interface for requesting book tickers * Added ISpotTriggerOrderRestClient Shared interface for managing spot trigger orders * Added ISpotOrderClientIdClient Shared interface for managing spot orders by client order id * Added IFuturesTriggerOrderRestClient Shared interface for managing futures trigger orders * Added IFuturesOrderClientIdClient Shared interface for managing futures orders by client order id * Added IFuturesTpSlRestClient Shared interface for setting TP/SL on open futures positions * Added GenerateClientOrderId to ISpotOrderRestClient and IFuturesOrderRestClient interface * Added OptionalExchangeParameters and Supported properties to EndpointOptions * Refactor Shared interfaces quantity parameters and properties to use SharedQuantity * Added SharedSymbol property to Shared interface models returning a symbol * Added TriggerPrice, IsTriggerOrder, TakeProfitPrice, StopLossPrice and IsCloseOrder to SharedFuturesOrder 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 property to SharedSpotTicker response model * Added AssetAlias configuration models * Added static ExchangeSymbolCache for tracking symbol information from exchanges * Added static CallResult.SuccessResult to be used instead of constructing success CallResult instance * Added static ApplyRules, RandomHexString and RandomLong helper methods to ExchangeHelpers class * Added AsErrorWithData To CallResult * Added OriginalData property to CallResult * Added support for adjusting the rate limit key per call, allowing for ratelimiting depending on request parameters * Added implementation for integration testing ISymbolOrderBook instances * Added implementation for integration testing socket subscriptions * Added implementation for testing socket queries * Updated request cancellation logging to Debug level * Updated logging SourceContext to include the client type * Updated some logging logic, errors no longer contain any data, exception are not logged as string but instead forwarded to structured logging * Fixed warning for Enum parsing throwing exception and output warnings for each object in a response to only once to prevent slowing down execution * Fixed memory leak in AsyncAutoRestEvent * Fixed logging for ping frame timeout * Fixed warning getting logged when user stops SymbolOrderBook instance * Fixed socket client `UnsubscribeAll` not unsubscribing dedicated connections * Fixed memory leak in Rest client cache * Fixed integers bigger than int16 not getting correctly parsed to enums * Fixed issue where the default options were overridden when using SetApiCredentials * Removed Newtonsoft.Json dependency * Removed legacy Rest client code * Removed legacy ISpotClient and IFuturesClient support
2026-08-19 04:13:02 +00:00 · 2025-05-13 10:15:30 +02:00
parent 3d6267da93
commit 6b14cdbf06
182 changed files with 3159 additions and 3950 deletions
@@ -0,0 +1,116 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace CryptoExchange.Net.SharedApis
+{
+    /// <summary>
+    /// Quantity reference
+    /// </summary>
+    public record SharedQuantityReference
+    {
+        /// <summary>
+        /// Quantity denoted in the base asset of the symbol
+        /// </summary>
+        public decimal? QuantityInBaseAsset { get; set; }
+        /// <summary>
+        /// Quantity denoted in the quote asset of the symbol
+        /// </summary>
+        public decimal? QuantityInQuoteAsset { get; set; }
+        /// <summary>
+        /// Quantity denoted in the number of contracts
+        /// </summary>
+        public decimal? QuantityInContracts { get; set; }
+
+        /// <summary>
+        /// ctor
+        /// </summary>
+        protected SharedQuantityReference(decimal? baseAssetQuantity, decimal? quoteAssetQuantity, decimal? contractQuantity)
+        {
+            QuantityInBaseAsset = baseAssetQuantity;
+            QuantityInQuoteAsset = quoteAssetQuantity;
+            QuantityInContracts = contractQuantity;
+        }
+    }
+
+    /// <summary>
+    /// Quantity for an order
+    /// </summary>
+    public record SharedQuantity : SharedQuantityReference
+    {
+        private SharedQuantity(decimal? baseAssetQuantity, decimal? quoteAssetQuantity, decimal? contractQuantity)
+            : base(baseAssetQuantity, quoteAssetQuantity, contractQuantity)
+        {
+        }
+
+        /// <summary>
+        /// Specify quantity in base asset
+        /// </summary>
+        public static SharedQuantity Base(decimal quantity) => new SharedQuantity(quantity, null, null);
+        /// <summary>
+        /// Specify quantity in quote asset
+        /// </summary>
+        public static SharedQuantity Quote(decimal quantity) => new SharedQuantity(null, quantity, null);
+        /// <summary>
+        /// Specify quantity in number of contracts
+        /// </summary>
+        public static SharedQuantity Contracts(decimal quantity) => new SharedQuantity(null, null, quantity);
+
+        /// <summary>
+        /// Get the base asset quantity from a quote quantity using a price
+        /// </summary>
+        /// <param name="quoteQuantity">Quantity in quote asset to convert</param>
+        /// <param name="price">Price to use for conversion</param>
+        /// <param name="decimalPlaces">The max number of decimal places for the result</param>
+        /// <param name="lotSize">The lot size (step per quantity) for the base asset</param>
+        public static SharedQuantity BaseFromQuote(decimal quoteQuantity, decimal price, int decimalPlaces = 8, decimal lotSize = 0.00000001m) 
+            => new SharedQuantity(ExchangeHelpers.ApplyRules(quoteQuantity / price, decimalPlaces, lotSize), null, null);
+        /// <summary>
+        /// Get the quote asset quantity from a base quantity using a price
+        /// </summary>
+        /// <param name="baseQuantity">Quantity in base asset to convert</param>
+        /// <param name="price">Price to use for conversion</param>
+        /// <param name="decimalPlaces">The max number of decimal places for the result</param>
+        /// <param name="lotSize">The lot size (step per quantity) for the quote asset</param>
+        public static SharedQuantity QuoteFromBase(decimal baseQuantity, decimal price, int decimalPlaces = 8, decimal lotSize = 0.00000001m) 
+            => new SharedQuantity(ExchangeHelpers.ApplyRules(baseQuantity * price, decimalPlaces, lotSize), null, null);
+        /// <summary>
+        /// Get a quantity in number of contracts from a base asset
+        /// </summary>
+        /// <param name="baseQuantity">Quantity in base asset to convert</param>
+        /// <param name="contractSize">The contract size of a single contract</param>
+        /// <param name="decimalPlaces">The max number of decimal places for the result</param>
+        /// <param name="lotSize">The lot size (step per quantity) for the contract</param>
+        public static SharedQuantity ContractsFromBase(decimal baseQuantity, decimal contractSize, int decimalPlaces = 8, decimal lotSize = 0.00000001m)
+            => new SharedQuantity(ExchangeHelpers.ApplyRules(baseQuantity / contractSize, decimalPlaces, lotSize), null, null);
+        /// <summary>
+        /// Get a quantity in number of contracts from a quote asset
+        /// </summary>
+        /// <param name="quoteQuantity">Quantity in quote asset to convert</param>
+        /// <param name="contractSize">The contract size of a single contract</param>
+        /// <param name="price">The price to use for conversion</param>
+        /// <param name="decimalPlaces">The max number of decimal places for the result</param>
+        /// <param name="lotSize">The lot size (step per quantity) for the contract</param>
+        public static SharedQuantity ContractsFromQuote(decimal quoteQuantity, decimal contractSize, decimal price, int decimalPlaces = 8, decimal lotSize = 0.00000001m) 
+            => new SharedQuantity(ExchangeHelpers.ApplyRules(quoteQuantity / price / contractSize, decimalPlaces, lotSize), null, null);
+    }
+
+    /// <summary>
+    /// Order quantity
+    /// </summary>
+    public record SharedOrderQuantity : SharedQuantityReference
+    {
+        /// <summary>
+        /// ctor
+        /// </summary>
+        public SharedOrderQuantity(): base(null, null,null) { }
+
+        /// <summary>
+        /// ctor
+        /// </summary>
+        public SharedOrderQuantity(decimal? baseAssetQuantity = null, decimal? quoteAssetQuantity = null, decimal? contractQuantity = null)
+            : base(baseAssetQuantity, quoteAssetQuantity, contractQuantity)
+        {
+        }
+    }
+}