Updated to version 4.2.0

Author: JKorf

.cursor/rules/bingx-net.mdc

@@ -81,6 +81,8 @@ var ticker = await shared.GetSpotTickerAsync(
 
 Same pattern works against other CryptoExchange.Net libraries such as Binance.Net, OKX.Net, and Bybit.Net.
 
+In 4.2.0, successful shared symbol retrieval populates `ISpotSymbolRestClient.SpotSymbolCatalog` and `IFuturesSymbolRestClient.FuturesSymbolCatalog`. Shared symbol queries honor `GetSymbolsRequest` filters and include display names and asset type/subtype metadata, including fiat/stablecoin spot assets and equity/commodity perpetual bases.
+
 ## Hard rules
 
 - Never write raw `HttpClient` to BingX endpoints.
@@ -99,4 +101,3 @@ Same pattern works against other CryptoExchange.Net libraries such as Binance.Ne
 - Skill: `AGENTS.md` in repo root has fuller examples
 - `llms.txt` in repo root for AI context
 - Examples: `Examples/ai-friendly/`
-

.github/copilot-instructions.md

@@ -54,6 +54,8 @@ Store the returned `UpdateSubscription` and unsubscribe on shutdown via `socketC
 
 For code that needs to work across multiple exchanges, use `CryptoExchange.Net.SharedApis` interfaces (`ISpotTickerRestClient`, `ISpotOrderRestClient`, etc.) accessed via `.SharedClient` properties.
 
+Successful shared spot and perpetual symbol retrieval populates `SpotSymbolCatalog` / `FuturesSymbolCatalog`. These symbol queries honor `GetSymbolsRequest` filters and return display names plus asset type metadata; preserve that metadata instead of reclassifying symbols from their names in application code.
+
 ## Avoid
 
 - Raw `HttpClient` calls to BingX endpoints
@@ -67,4 +69,3 @@ For code that needs to work across multiple exchanges, use `CryptoExchange.Net.S
 ## Reference
 
 For detailed patterns and pitfalls see `AGENTS.md`, `llms.txt`, `docs/ai-api-map.md`, and `Examples/ai-friendly/`.
-

AGENTS.md

@@ -143,6 +143,8 @@ var symbol = new SharedSymbol(TradingMode.Spot, "BTC", "USDT");
 var ticker = await bingXShared.GetSpotTickerAsync(new GetTickerRequest(symbol));
 ```
 
+In 4.2.0, successful shared symbol retrieval populates the `SpotSymbolCatalog` / `FuturesSymbolCatalog` properties. `GetSpotSymbolsAsync` and `GetFuturesSymbolsAsync` honor `GetSymbolsRequest` filters and return display names plus asset type metadata. Spot EUR/USD assets are marked as fiat and stablecoins use the stablecoin subtype; perpetual `NCSK...` bases are marked as equities, `NCCO...` bases as commodities, and other bases as crypto.
+
 ## Dependency Injection
 
 ```csharp

BingX.Net/BingX.Net.csproj

@@ -7,9 +7,9 @@
   <PropertyGroup>
     <PackageId>JK.BingX.Net</PackageId>
     <Authors>JKorf</Authors>
-    <PackageVersion>4.1.1</PackageVersion>
-    <AssemblyVersion>4.1.1</AssemblyVersion>
-    <FileVersion>4.1.1</FileVersion>
+    <PackageVersion>4.2.0</PackageVersion>
+    <AssemblyVersion>4.2.0</AssemblyVersion>
+    <FileVersion>4.2.0</FileVersion>
     <Description>A high-performance .NET client library for the BingX REST and WebSocket APIs, providing strongly typed models, automatic WebSocket reconnection, client-side rate limiting, local order book support, and seamless integration with other CryptoExchange.Net based clients.</Description>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
     <PackageTags>BingX;BingX.Net;BingX.com;BingX Client;BingX API;CryptoCurrency;CryptoCurrency Exchange;CryptoExchange.Net;ccxt</PackageTags>

README.md

@@ -186,6 +186,15 @@ Make a one time donation in a crypto currency of your choice. If you prefer to d
 Alternatively, sponsor me on Github using [Github Sponsors](https://github.com/sponsors/JKorf). 
 
 ## Release notes
+* Version 4.2.0 - 21 Jul 2026
+    * Updated CryptoExchange.Net to v12.2.0 
+    * Added SpotSymbolCatalog to Shared ISpotSymbolRestClient interface
+    * Added FuturesSymbolCatalog to Shared IFuturesSymbolRestClient interface
+    * Added BaseAssetType, BaseAssetSubType, QuoteAssetType and QuoteAssetSubType to GetSymbolsRequest model
+    * Added DisplayName to SharedSpotSymbol and SharedFuturesSymbol models
+    * Added BaseAssetType, BaseAssetSubType, QuoteAssetType and QuoteAssetSubType to SharedSpotSymbol and SharedFuturesSymbol models
+    * Added DebuggerDisplay attributes to Shared models
+
 * Version 4.1.1 - 13 Jul 2026
     * Fixed exception during authentication when retrying requests
 

docs/ai-api-map.md

@@ -173,6 +173,10 @@ BingX.Net examples should use hyphenated symbols such as `BTC-USDT` and `ETH-USD
 | Shared spot socket client | `new BingXSocketClient().SpotApi.SharedClient` |
 | Shared perpetual futures socket client | `new BingXSocketClient().PerpetualFuturesApi.SharedClient` |
 | Discover shared capabilities | `client.SpotApi.SharedClient.Discover()` / `client.PerpetualFuturesApi.SharedClient.Discover()` |
+| Get filtered shared spot symbols | `ISpotSymbolRestClient.GetSpotSymbolsAsync(new GetSymbolsRequest(...))` |
+| Read shared spot symbol catalog | `ISpotSymbolRestClient.SpotSymbolCatalog` |
+| Get filtered shared futures symbols | `IFuturesSymbolRestClient.GetFuturesSymbolsAsync(new GetSymbolsRequest(...))` |
+| Read shared futures symbol catalog | `IFuturesSymbolRestClient.FuturesSymbolCatalog` |
 | Shared spot ticker REST | `ISpotTickerRestClient.GetSpotTickerAsync(new GetTickerRequest(symbol))` |
 | Shared spot order REST | `ISpotOrderRestClient.PlaceSpotOrderAsync(...)` |
 | Shared futures order REST | `IFuturesOrderRestClient.PlaceFuturesOrderAsync(...)` |
@@ -181,6 +185,8 @@ BingX.Net examples should use hyphenated symbols such as `BTC-USDT` and `ETH-USD
 
 Shared REST calls return `HttpResult<T>` / `HttpResult`. Shared socket subscriptions return `WebSocketResult<UpdateSubscription>`. Shared non-I/O symbol/cache helpers such as symbol support checks return `ExchangeCallResult<T>`.
 
+Successful shared spot and futures symbol retrieval populates the corresponding catalog. Results include display names and asset type/subtype metadata: spot EUR/USD assets are fiat and known stablecoins carry the stablecoin subtype; perpetual `NCSK...` bases are TradFi equities, `NCCO...` bases are TradFi commodities, and other bases are crypto.
+
 For shared socket subscriptions, keep the concrete socket client and unsubscribe with `await socketClient.UnsubscribeAsync(subscription.Data)`.
 
 ## Result Handling

llms-full.txt

@@ -4,8 +4,8 @@
 
 BingX.Net is a strongly typed .NET client library for the BingX REST and WebSocket APIs. It is part of the CryptoExchange.Net ecosystem and uses the same result, shared API, logging, rate limiting, and socket patterns as the other JKorf exchange libraries.
 
-Current package version in this repository: 3.11.1.
-CryptoExchange.Net dependency: 11.1.0.
+Current package version in this repository: 4.2.0.
+CryptoExchange.Net dependency: 12.2.0.
 Target frameworks: netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0.
 Native AOT: supported on compatible .NET targets.
 
@@ -377,6 +377,24 @@ if (!ticker.Success)
 Console.WriteLine(ticker.Data.LastPrice);
 ```
 
+Successful shared symbol retrieval populates the corresponding catalog and returns classified asset metadata:
+
+```csharp
+ISpotSymbolRestClient spotSymbols = new BingXRestClient().SpotApi.SharedClient;
+var symbols = await spotSymbols.GetSpotSymbolsAsync(new GetSymbolsRequest());
+if (!symbols.Success)
+{
+    Console.WriteLine(symbols.Error);
+    return;
+}
+
+var catalog = spotSymbols.SpotSymbolCatalog;
+var first = symbols.Data.First();
+Console.WriteLine($"{first.DisplayName}: {first.BaseAssetType}/{first.BaseAssetSubType}");
+```
+
+`GetSpotSymbolsAsync` and `GetFuturesSymbolsAsync` honor `GetSymbolsRequest` filters. Spot symbols classify EUR/USD as fiat and known stablecoins with `SharedAssetSubType.StableCoin`. Perpetual futures classify `NCSK...` base assets as TradFi equities, `NCCO...` bases as TradFi commodities, other bases as crypto, and quote assets as crypto with stablecoin subtype metadata when applicable. The equivalent futures catalog is `IFuturesSymbolRestClient.FuturesSymbolCatalog`.
+
 Shared WebSocket subscriptions return an `UpdateSubscription` in `.Data`. For shared interface variables, unsubscribe through the concrete socket client:
 
 ```csharp

llms.txt

@@ -2,10 +2,12 @@
 
 > Strongly typed .NET client library for the BingX REST and WebSocket APIs. Supports Spot, Perpetual Futures, sub-account endpoints, account management, market data, and order placement. Part of the CryptoExchange.Net ecosystem providing a unified abstraction across cryptocurrency exchanges.
 
-BingX.Net provides strongly typed public and private endpoints, automatic WebSocket reconnection, comprehensive error handling via the `HttpResult<T>` / `WebSocketResult<T>` pattern, native AOT support, local order book support, and SharedApis integration for exchange-agnostic code. Current package version in this repository: 3.11.1. Targets netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0.
+BingX.Net provides strongly typed public and private endpoints, automatic WebSocket reconnection, comprehensive error handling via the `HttpResult<T>` / `WebSocketResult<T>` pattern, native AOT support, local order book support, and SharedApis integration for exchange-agnostic code. Current package version in this repository: 4.2.0. Targets netstandard2.0, netstandard2.1, net8.0, net9.0, net10.0.
 
 REST methods return `HttpResult<T>` / `HttpResult`, WebSocket subscriptions return `WebSocketResult<UpdateSubscription>`, and shared symbol/cache helpers return `ExchangeCallResult<T>`. Call `SharedClient.Discover()` to inspect supported shared features before routing optional multi-exchange functionality.
 
+Successful shared spot and perpetual futures symbol retrieval populates their symbol catalogs. These symbol queries honor `GetSymbolsRequest` filters and return display names plus crypto, fiat, stablecoin, equity, or commodity asset metadata where BingX supplies enough information.
+
 ## Documentation
 
 - [README](https://github.com/JKorf/BingX.Net/blob/master/README.md): Overview, installation, supported features, basic usage examples, release notes