Add Company Ratings endpoint

Author: Matthiee

FinancialModelingPrepApi/Abstractions/CompanyValuation/ICompanyValuation.cs

@@ -20,5 +20,8 @@ public interface ICompanyValuation
         public Task<ApiResponse<List<IncomeStatementResponse>>> GetIncomeStatementAsync(string symbol, Period period = Period.Quarter, int limit = 40);
 
         public Task<ApiResponse<List<StockNewsResponse>>> GetStockNewsAsync(string symbol, int limit = 50);
+
+        public Task<ApiResponse<CompanyRatingResponse>> GetCompanyRatingAsync(string symbol);
+        public Task<ApiResponse<List<CompanyRatingResponse>>> GetHistoricalCompanyRatingAsync(string symbol, int limit = 140);
     }
 }

FinancialModelingPrepApi/Core/CompanyValuation/CompanyValuation.cs

@@ -178,5 +178,42 @@ public Task<ApiResponse<List<StockNewsResponse>>> GetStockNewsAsync(string symbo
 
             return client.GetAsync<List<StockNewsResponse>>(url, pathParams, queryString);
         }
+
+        public async Task<ApiResponse<CompanyRatingResponse>> GetCompanyRatingAsync(string symbol)
+        {
+            const string url = "[version]/rating/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var result = await client.GetAsync<List<CompanyRatingResponse>>(url, pathParams, null);
+
+            if (result.HasError)
+            {
+                return ApiResponse.FromError<CompanyRatingResponse>(result.Error);
+            }
+
+            return ApiResponse.FromSucces(result.Data.First());
+        }
+
+        public Task<ApiResponse<List<CompanyRatingResponse>>> GetHistoricalCompanyRatingAsync(string symbol, int limit = 140)
+        {
+            const string url = "[version]/historical-rating/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var queryString = new QueryStringBuilder();
+
+            queryString.Add("limit", limit);
+
+            return client.GetAsync<List<CompanyRatingResponse>>(url, pathParams, queryString);
+        }
     }
 }

FinancialModelingPrepApi/Model/CompanyValuation/CompanyRatingResponse.cs

@@ -0,0 +1,58 @@
+using System.Text.Json.Serialization;
+
+namespace MatthiWare.FinancialModelingPrepApi.Model.CompanyValuation
+{
+    public class CompanyRatingResponse
+    {
+        [JsonPropertyName("symbol")]
+        public string Symbol { get; set; }
+
+        [JsonPropertyName("date")]
+        public string Date { get; set; }
+
+        [JsonPropertyName("rating")]
+        public string Rating { get; set; }
+
+        [JsonPropertyName("ratingScore")]
+        public int RatingScore { get; set; }
+
+        [JsonPropertyName("ratingRecommendation")]
+        public string RatingRecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsDCFScore")]
+        public int RatingDetailsDCFScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsDCFRecommendation")]
+        public string RatingDetailsDCFRecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsROEScore")]
+        public int RatingDetailsROEScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsROERecommendation")]
+        public string RatingDetailsROERecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsROAScore")]
+        public int RatingDetailsROAScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsROARecommendation")]
+        public string RatingDetailsROARecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsDEScore")]
+        public int RatingDetailsDEScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsDERecommendation")]
+        public string RatingDetailsDERecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsPEScore")]
+        public int RatingDetailsPEScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsPERecommendation")]
+        public string RatingDetailsPERecommendation { get; set; }
+
+        [JsonPropertyName("ratingDetailsPBScore")]
+        public int RatingDetailsPBScore { get; set; }
+
+        [JsonPropertyName("ratingDetailsPBRecommendation")]
+        public string RatingDetailsPBRecommendation { get; set; }
+    }
+}

Tests/CompanyValuation/CompanyValuationTests.cs

@@ -142,5 +142,31 @@ public async Task GetStockNewsAsync()
             Assert.Equal(5, result.Data.Count);
             Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
         }
+
+        [Fact]
+        public async Task GetCompanyRatingAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetCompanyRatingAsync("AAPL");
+
+            Assert.NotNull(result);
+            Assert.False(result.HasError);
+            Assert.Equal("AAPL", result.Data.Symbol);
+        }
+
+        [Fact]
+        public async Task GetHistoricalCompanyRatingAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetHistoricalCompanyRatingAsync("AAPL", 5);
+
+            Assert.NotNull(result);
+            Assert.False(result.HasError);
+            Assert.NotEmpty(result.Data);
+            Assert.Equal(5, result.Data.Count);
+            Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
+        }
     }
 }