Add market cap endpoint

Author: Matthiee

FinancialModelingPrepApi/Abstractions/CompanyValuation/ICompanyValuation.cs

@@ -17,6 +17,9 @@ public interface ICompanyValuation
         public Task<ApiResponse<List<HistoricalDCFResponse>>> GetHistoricalDiscountedCashFlowAsync(string symbol, Period period = Period.Annual);
         public Task<ApiResponse<List<HistoricalDailyDCFResponse>>> GetHistoricalDiscountedCashFlowDailyAsync(string symbol, int limit = 100);
 
+        public Task<ApiResponse<MarketCapResponse>> GetMarketCapitalizationAsync(string symbol);
+        public Task<ApiResponse<List<MarketCapResponse>>> GetHistoricalMarketCapitalizationAsync(string symbol, int limit = 100);
+
         public Task<ApiResponse<List<SymbolResponse>>> GetSymbolsListAsync();
         public Task<ApiResponse<List<SymbolResponse>>> GetTradableSymbolsListAsync();
         public Task<ApiResponse<List<SymbolResponse>>> GetETFListAsync();

FinancialModelingPrepApi/Core/CompanyValuation/CompanyValuation.cs

@@ -334,5 +334,41 @@ public async Task<ApiResponse<QuoteResponse>> GetQuoteAsync(string symbol)
 
             return ApiResponse.FromSucces(result.Data.First());
         }
+
+        public async Task<ApiResponse<MarketCapResponse>> GetMarketCapitalizationAsync(string symbol)
+        {
+            const string url = "[version]/historical-market-capitalization/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var result = await client.GetAsync<List<MarketCapResponse>>(url, pathParams, null);
+
+            if (result.HasError)
+            {
+                return ApiResponse.FromError<MarketCapResponse>(result.Error);
+            }
+
+            return ApiResponse.FromSucces(result.Data.First());
+        }
+
+        public Task<ApiResponse<List<MarketCapResponse>>> GetHistoricalMarketCapitalizationAsync(string symbol, int limit = 100)
+        {
+            const string url = "[version]/historical-market-capitalization/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var queryString = new QueryStringBuilder();
+            queryString.Add("limit", limit);
+
+            return client.GetAsync<List<MarketCapResponse>>(url, pathParams, queryString);
+        }
     }
 }

FinancialModelingPrepApi/Model/CompanyValuation/MarketCapResponse.cs

@@ -0,0 +1,16 @@
+using System.Text.Json.Serialization;
+
+namespace MatthiWare.FinancialModelingPrepApi.Model.CompanyValuation
+{
+    public class MarketCapResponse
+    {
+        [JsonPropertyName("symbol")]
+        public string Symbol { get; set; }
+
+        [JsonPropertyName("date")]
+        public string Date { get; set; }
+
+        [JsonPropertyName("marketCap")]
+        public double MarketCap { get; set; }
+    }
+}

Tests/CompanyValuation/CompanyValuationTests.cs

@@ -227,5 +227,29 @@ public async Task GetQuoteAsync()
             result.AssertNoErrors();
             Assert.Equal("AAPL", result.Data.Symbol);
         }
+
+        [Fact]
+        public async Task GetHistoricalMarketCapAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetHistoricalMarketCapitalizationAsync("AAPL", 5);
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            Assert.Equal(5, result.Data.Count);
+            Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
+        }
+
+        [Fact]
+        public async Task GetMarketCapAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetMarketCapitalizationAsync("AAPL");
+
+            result.AssertNoErrors();
+            Assert.Equal("AAPL", result.Data.Symbol);
+        }
     }
 }