Add Company Discounted Cash FLow Value API

Author: Matthiee

FinancialModelingPrepApi/Abstractions/CompanyValuation/ICompanyValuation.cs

@@ -9,6 +9,10 @@ public interface ICompanyValuation
     {
         public Task<ApiResponse<CompanyProfileResponse>> GetCompanyProfileAsync(string symbol);
 
+        public Task<ApiResponse<DCFResponse>> GetDiscountedCashFlowAsync(string symbol);
+        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<List<SymbolResponse>>> GetSymbolsListAsync();
         public Task<ApiResponse<List<SymbolResponse>>> GetTradableSymbolsListAsync();
         public Task<ApiResponse<List<SymbolResponse>>> GetETFListAsync();

FinancialModelingPrepApi/Core/CompanyValuation/CompanyValuation.cs

@@ -215,5 +215,62 @@ public Task<ApiResponse<List<CompanyRatingResponse>>> GetHistoricalCompanyRating
 
             return client.GetAsync<List<CompanyRatingResponse>>(url, pathParams, queryString);
         }
+
+        public async Task<ApiResponse<DCFResponse>> GetDiscountedCashFlowAsync(string symbol)
+        {
+            const string url = "[version]/discounted-cash-flow/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var result = await client.GetAsync<List<DCFResponse>>(url, pathParams, null);
+
+            if (result.HasError)
+            {
+                return ApiResponse.FromError<DCFResponse>(result.Error);
+            }
+
+            return ApiResponse.FromSucces(result.Data.First());
+        }
+
+        public Task<ApiResponse<List<HistoricalDCFResponse>>> GetHistoricalDiscountedCashFlowAsync(string symbol, Period period = Period.Annual)
+        {
+            const string url = "[version]/historical-discounted-cash-flow-statement/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var queryString = new QueryStringBuilder();
+
+            if (period != Period.Annual)
+            {
+                queryString.Add("period", period.ToString().ToLower());
+            }
+
+            return client.GetAsync<List<HistoricalDCFResponse>>(url, pathParams, queryString);
+        }
+
+        public Task<ApiResponse<List<HistoricalDailyDCFResponse>>> GetHistoricalDiscountedCashFlowDailyAsync(string symbol, int limit = 100)
+        {
+            const string url = "[version]/historical-discounted-cash-flow-statement/[symbol]";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+                { "symbol", symbol }
+            };
+
+            var queryString = new QueryStringBuilder();
+
+            queryString.Add("limit", limit);
+
+            return client.GetAsync<List<HistoricalDailyDCFResponse>>(url, pathParams, queryString);
+        }
     }
 }

FinancialModelingPrepApi/Model/CompanyValuation/DCFResponse.cs

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

FinancialModelingPrepApi/Model/CompanyValuation/HistoricalDCFResponse.cs

@@ -0,0 +1,20 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace MatthiWare.FinancialModelingPrepApi.Model.CompanyValuation
+{
+    public class HistoricalDCFResponse
+    {
+        [JsonPropertyName("symbol")]
+        public string Symbol { get; set; }
+
+        [JsonPropertyName("date")]
+        public string Date { get; set; }
+
+        [JsonPropertyName("price")]
+        public double Price { get; set; }
+
+        [JsonPropertyName("dcf")]
+        public double? Dcf { get; set; }
+    }
+}

FinancialModelingPrepApi/Model/CompanyValuation/HistoricalDailyDCFResponse.cs

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

Tests/CompanyValuation/CompanyValuationTests.cs

@@ -157,5 +157,41 @@ public async Task GetHistoricalCompanyRatingAsync()
             Assert.Equal(5, result.Data.Count);
             Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
         }
+
+        [Fact]
+        public async Task GetDiscountedCashFlowAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetDiscountedCashFlowAsync("AAPL");
+
+            result.AssertNoErrors();
+            Assert.Equal("AAPL", result.Data.Symbol);
+        }
+
+        [Fact]
+        public async Task GetHistoricalDiscountedCashFlowAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetHistoricalDiscountedCashFlowAsync("AAPL", Period.Quarter);
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
+        }
+
+        [Fact]
+        public async Task GetHistoricalDiscountedCashFlowDailyAsync()
+        {
+            var api = ServiceProvider.GetRequiredService<IFinancialModelingPrepApiClient>();
+
+            var result = await api.CompanyValuation.GetHistoricalDiscountedCashFlowDailyAsync("AAPL", 5);
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            Assert.Equal(5, result.Data.Count);
+            Assert.All(result.Data, data => Assert.Equal("AAPL", data.Symbol));
+        }
     }
 }