Add Search by name and search by ticker endpoints

Author: Matthiee

FinancialModelingPrepApi/Abstractions/CompanyValuation/ICompanyValuationProvider.cs

@@ -10,6 +10,9 @@ public interface ICompanyValuationProvider
         public Task<ApiResponse<QuoteResponse>> GetQuoteAsync(string symbol);
         public Task<ApiResponse<List<QuoteResponse>>> GetQuotesAsync(Exchange exchange);
 
+        public Task<ApiResponse<List<TickerSearchResponse>>> SearchAsync(string query, Exchange exchange, int? limit = null);
+        public Task<ApiResponse<List<TickerSearchResponse>>> SearchByTickerAsync(string query, Exchange exchange, int? limit = null);
+
         public Task<ApiResponse<CompanyProfileResponse>> GetCompanyProfileAsync(string symbol);
         public Task<ApiResponse<KeyMetricsTTMResponse>> GetCompanyKeyMetricsTTMAsync(string symbol);
         public Task<ApiResponse<List<KeyMetricsResponse>>> GetCompanyKeyMetricsAsync(string symbol, Period period = Period.Annual, int? limit = 130);

FinancialModelingPrepApi/Core/CompanyValuation/CompanyValuationProvider.cs

@@ -87,7 +87,7 @@ public Task<ApiResponse<List<EnterpriseValueResponse>>> GetEnterpriseValueAsync(
             var queryString = new QueryStringBuilder();
 
             if (limit != null)
-            { 
+            {
                 queryString.Add("limit", limit);
             }
 
@@ -410,5 +410,34 @@ public Task<ApiResponse<List<MarketCapResponse>>> GetHistoricalMarketCapitalizat
 
             return client.GetJsonAsync<List<MarketCapResponse>>(url, pathParams, queryString);
         }
+
+        public Task<ApiResponse<List<TickerSearchResponse>>> SearchAsync(string query, Exchange exchange, int? limit = null)
+            => SearchInternalAsync(query, exchange, false, limit);
+
+        public Task<ApiResponse<List<TickerSearchResponse>>> SearchByTickerAsync(string query, Exchange exchange, int? limit = null)
+            => SearchInternalAsync(query, exchange, true, limit);
+
+        private Task<ApiResponse<List<TickerSearchResponse>>> SearchInternalAsync(string query, Exchange exchange, bool byTicker, int? limit)
+        {
+            const string url = "[version]/search";
+            const string urlByTicker = "[version]/search-ticker";
+
+            var pathParams = new NameValueCollection()
+            {
+                { "version", ApiVersion.v3.ToString() },
+            };
+
+            var queryString = new QueryStringBuilder();
+
+            queryString.Add("query", query);
+            queryString.Add("exchange", exchange.ToString());
+
+            if (limit != null)
+            {
+                queryString.Add("limit", limit);
+            }
+
+            return client.GetJsonAsync<List<TickerSearchResponse>>(byTicker ? urlByTicker : url, pathParams, queryString);
+        }
     }
 }

FinancialModelingPrepApi/Model/CompanyValuation/TickerSearchResponse.cs

@@ -0,0 +1,22 @@
+using System.Text.Json.Serialization;
+
+namespace MatthiWare.FinancialModelingPrep.Model.CompanyValuation
+{
+    public class TickerSearchResponse
+    {
+        [JsonPropertyName("symbol")]
+        public string Symbol { get; set; }
+
+        [JsonPropertyName("name")]
+        public string Name { get; set; }
+
+        [JsonPropertyName("currency")]
+        public string Currency { get; set; }
+
+        [JsonPropertyName("stockExchange")]
+        public string StockExchange { get; set; }
+
+        [JsonPropertyName("exchangeShortName")]
+        public string ExchangeShortName { get; set; }
+    }
+}

Tests/CompanyValuation/CompanyValuationTests.cs

@@ -5,6 +5,7 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Linq;
 using System.Threading.Tasks;
 using Xunit;
 using Xunit.Abstractions;
@@ -208,6 +209,32 @@ public async Task GetQuoteAsync()
             Assert.Equal("AAPL", result.Data.Symbol);
         }
 
+        [Fact]
+        public async Task SearchAsync()
+        {
+            var result = await api.SearchAsync("Ageas", Exchange.EURONEXT, 5);
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            Assert.True(result.Data.Count <= 5);
+
+            var firstResult = result.Data.First(_ => _.Symbol == "AGS.BR");
+            Assert.Equal("AGS.BR", firstResult.Symbol);
+        }
+
+        [Fact]
+        public async Task SearchByTickerAsync()
+        {
+            var result = await api.SearchByTickerAsync("AGS", Exchange.EURONEXT, 5);
+
+            result.AssertNoErrors();
+            Assert.NotEmpty(result.Data);
+            Assert.True(result.Data.Count <= 5);
+
+            var firstResult = result.Data.First(_ => _.Symbol == "AGS.BR");
+            Assert.Equal("AGS.BR", firstResult.Symbol);
+        }
+
         [Fact]
         public async Task GetHistoricalMarketCapAsync()
         {