Add ESG Score (#33)

Author: Matthiee

FinancialModelingPrepApi/Abstractions/AdvancedData/IAdvancedDataProvider.cs

@@ -23,5 +23,7 @@ public interface IAdvancedDataProvider
         Task<ApiResponse<List<IndustryPEResponse>>> GetIndustriesPriceEarningsRatioAsync(string date, string exchange);
 
         Task<ApiResponse<SharesFloatResponse>> GetSharesFloatAsync(string symbol);
+
+        Task<ApiResponse<List<ESGScoreResponse>>> GetESGScoreAsync(string symbol);
     }
 }

FinancialModelingPrepApi/Core/AdvancedData/AdvancedDataProvider.cs

@@ -158,5 +158,20 @@ public async Task<ApiResponse<SharesFloatResponse>> GetSharesFloatAsync(string s
 
             return ApiResponse.FromSucces(result.Data.First());
         }
+
+        public Task<ApiResponse<List<ESGScoreResponse>>> GetESGScoreAsync(string symbol)
+        {
+            const string url = "[version]/esg-environmental-social-governance-data";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v4.ToString() }
+            };
+
+            var queryString = new QueryStringBuilder();
+            queryString.Add("symbol", symbol);
+
+            return client.GetJsonAsync<List<ESGScoreResponse>>(url, pathParams, queryString);
+        }
     }
 }

FinancialModelingPrepApi/Model/AdvancedData/ESGScoreResponse.cs

@@ -0,0 +1,40 @@
+using System.Text.Json.Serialization;
+
+namespace MatthiWare.FinancialModelingPrep.Model.AdvancedData
+{
+    public class ESGScoreResponse
+    {
+        [JsonPropertyName("symbol")]
+        public string Symbol { get; set; }
+
+        [JsonPropertyName("cik")]
+        public string Cik { get; set; }
+
+        [JsonPropertyName("companyName")]
+        public string CompanyName { get; set; }
+
+        [JsonPropertyName("formType")]
+        public string FormType { get; set; }
+
+        [JsonPropertyName("acceptedDate")]
+        public string AcceptedDate { get; set; }
+
+        [JsonPropertyName("date")]
+        public string Date { get; set; }
+
+        [JsonPropertyName("environmentalScore")]
+        public double EnvironmentalScore { get; set; }
+
+        [JsonPropertyName("socialScore")]
+        public double SocialScore { get; set; }
+
+        [JsonPropertyName("governanceScore")]
+        public double GovernanceScore { get; set; }
+
+        [JsonPropertyName("ESGScore")]
+        public double ESGScore { get; set; }
+
+        [JsonPropertyName("url")]
+        public string Url { get; set; }
+    }
+}

Tests/AdvancedData/AdvancedDataTests.cs

@@ -91,6 +91,16 @@ public async Task GetSharesFloatAsync()
             Assert.True(result.Data.OutstandingShares > 0);
         }
 
+        [Fact]
+        public async Task GetESGScoreAsync()
+        {
+            var result = await api.GetESGScoreAsync("AAPL");
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            
+        }
+
         private Task<ApiResponse<StandardIndustrialClassificationResponse>> GetStandardIndustrialClassSwitch(string by, string value)
         {
             return by switch