Add Get BEP-20 Token CirculatingSupply by ContractAddress

src/BscScan.NetCore/Constants/Constants.cs

@@ -82,6 +82,7 @@ internal static class ProxyModuleAction
 internal static class TokenModuleAction
 {
     public const string TOKEN_SUPPLY = "tokensupply";
+    public const string TOKEN_C_SUPPLY = "tokenCsupply";
 }
 
 /// <summary>

src/BscScan.NetCore/Contracts/IBscScanTokensService.cs

@@ -13,5 +13,12 @@ public interface IBscScanTokensService
         /// <param name="contractAddress">the contract address of the BEP-20 token</param>
         /// <returns>Returns the total supply of a BEP-20 token.</returns>
         Task<TokenTotalSupply?> GetBep20TokenTotalSupplyByContractAddress(string contractAddress);
+
+        /// <summary>
+        /// Get BEP-20 Token CirculatingSupply by ContractAddress
+        /// </summary>
+        /// <param name="contractAddress">the contract address of the BEP-20 token</param>
+        /// <returns>Returns the current circulating supply of a BEP-20 token. </returns>
+        Task<TokenCirculatingSupply?> GetBep20TokenCirculatingSupplyByContractAddress(string contractAddress);
     }
 }

src/BscScan.NetCore/Models/Response/Tokens/TokenCirculatingSupply.cs

@@ -0,0 +1,16 @@
+using System.Text.Json.Serialization;
+
+namespace BscScan.NetCore.Models.Response.Tokens
+{
+    /// <summary>
+    /// TokenCirculatingSupply
+    /// </summary>
+    public class TokenCirculatingSupply : BaseResponse
+    {
+        /// <summary>
+        /// result
+        /// </summary>
+        [JsonPropertyName("result")]
+        public string? Result { get; set; }
+    }
+}

src/BscScan.NetCore/Services/BscScanTokensService.cs

@@ -33,5 +33,19 @@ public BscScanTokensService(HttpClient bscScanHttpClient, BscScanConfiguration b
             var result = await JsonSerializer.DeserializeAsync<TokenTotalSupply>(responseStream);
             return result;
         }
+
+        /// <inheritdoc />
+        public async Task<TokenCirculatingSupply?> GetBep20TokenCirculatingSupplyByContractAddress(string contractAddress)
+        {
+            var queryParameters = $"{_bscScanModuleStat}".AddAction(TokenModuleAction.TOKEN_C_SUPPLY)
+                .AddQuery(BscQueryParam.ContractAddress.AppendValue(contractAddress));
+            using var response = await BscScanHttpClient.GetAsync($"{queryParameters}")
+                .ConfigureAwait(false);
+
+            response.EnsureSuccessStatusCode();
+            await using var responseStream = await response.Content.ReadAsStreamAsync().ConfigureAwait(false);
+            var result = await JsonSerializer.DeserializeAsync<TokenCirculatingSupply>(responseStream);
+            return result;
+        }
     }
 }