Add IExchangeService Map endpoint

Author: iman nemati

.editorconfig

@@ -0,0 +1,4 @@
+[*.cs]
+
+# CS1591: Missing XML comment for publicly visible type or member
+dotnet_diagnostic.CS1591.severity = none

CoinMarketCapAPI.sln

@@ -11,6 +11,11 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{95D3
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Emun.CoinMarketCap.CliSample", "samples\Emun.CoinMarketCap.CliSample\Emun.CoinMarketCap.CliSample.csproj", "{EBB012C0-481A-41E0-A9B8-68E7C03A570D}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{20387BF7-0BC5-45E2-B4CE-416E238C68DA}"
+	ProjectSection(SolutionItems) = preProject
+		.editorconfig = .editorconfig
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

src/Emun.CoinMarketCap/Contracts/IExchangeService.cs

@@ -0,0 +1,31 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Collections.Generic;
+using Emun.CoinMarketCap.Models;
+
+namespace Emun.CoinMarketCap
+{
+    /// <summary>
+    /// 
+    /// </summary>
+    public interface IExchangeService
+    {
+
+        /// <summary>
+        /// Returns a paginated list of all active cryptocurrency exchanges by CoinMarketCap ID. 
+        /// We recommend using this convenience endpoint to lookup and utilize our unique exchange id across all endpoints 
+        /// as typical exchange identifiers may change over time. As a convenience you may pass a comma-separated list of 
+        /// exchanges by slug to filter this list to only those you require or the aux parameter to slim down the payload.
+        /// This endpoint is available on the following API plans:
+        /// [Startup, Standard, Professional, Enterprise]
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<ExchangeMapResult> MapAsync(
+            ExchangeMapQuery request,
+            CancellationToken cancellationToken);
+        
+    }
+}

src/Emun.CoinMarketCap/Internal/ExchangeService.cs

@@ -0,0 +1,31 @@
+using Emun.CoinMarketCap.Models;
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Emun.CoinMarketCap.Internal {
+
+    /// <inheritdoc/>
+    internal class ExchangeService : CoinMarketCapBaseService, IExchangeService {
+    
+        public ExchangeService(HttpClient httpClient, string apiKey) 
+            : base(httpClient, apiKey) { }
+
+
+        /// <inheritdoc/>
+        public async Task<ExchangeMapResult> MapAsync(
+            ExchangeMapQuery request, 
+            CancellationToken cancellationToken) {
+
+            request.CheckArgumentIsNull(nameof(request));
+
+            var api_result = await getApiResponseAsync<List<ExchangeMapData>>
+                (request, "exchange/map", cancellationToken);
+
+            return ExchangeMapResult.From(api_result);
+        }
+    }
+}

src/Emun.CoinMarketCap/Models/Output/ExchangeMapData.cs

@@ -0,0 +1,32 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Newtonsoft.Json;
+
+namespace Emun.CoinMarketCap.Models
+{
+    public class ExchangeMapData
+    {
+        [JsonProperty("id")]
+        public int Id { get; set; }
+
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        [JsonProperty("slug")]
+        public string Slug { get; set; }
+
+        [JsonProperty("is_active")]
+        public bool IsActive { get; set; }
+
+        [JsonProperty("status")]
+        public string Status { get; set; }
+
+        [JsonProperty("first_historical_data")]
+        public DateTimeOffset FirstHistoricalDate { get; set; }
+
+        [JsonProperty("last_historical_data")]
+        public DateTimeOffset LastHistoricalDate { get; set; }
+
+    }
+}

src/Emun.CoinMarketCap/Models/Query/ExchangeMapQuery.cs

@@ -0,0 +1,60 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Newtonsoft.Json;
+
+namespace Emun.CoinMarketCap {
+
+    public class ExchangeMapQuery {
+
+        /// <summary>
+        /// Only active exchanges are returned by default. Pass inactive to get a list of exchanges that are no longer active. 
+        /// Pass untracked to get a list of exchanges that are registered but do not currently meet methodology requirements 
+        /// to have active markets tracked. You may pass one or more comma-separated values.
+        /// default : `active`
+        /// </summary>
+        [JsonIgnore]
+        public ListingStatus ListingStatus { get; set; }
+
+        [JsonProperty]
+        public string listing_status => this.ListingStatus.ToStrValue();
+
+        /// <summary>
+        /// Optionally pass a comma-separated list of exchange slugs (lowercase URL friendly shorthand name with spaces replaced with dashes)
+        /// to return CoinMarketCap IDs for. If this option is passed, other options will be ignored.
+        /// </summary>
+        public string Slug { get; set; }
+
+        /// <summary>
+        /// Optionally offset the start (1-based index) of the paginated list of items to return.
+        /// </summary>
+        public int Start { get; set; } = 1;
+
+        /// <summary>
+        /// Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
+        /// </summary>
+        public int Limit { get; set; }
+
+        /// <summary>
+        /// What field to sort the list of exchanges by.
+        /// Valid values : "volume_24h", "id"
+        /// </summary>
+        [JsonProperty("sort")]
+        public string Sort { get; set; } = "id";
+
+        /// <summary>
+        /// Default : "first_historical_data,last_historical_data,is_active" 
+        /// Optionally specify a comma-separated list of supplemental data fields to return. 
+        /// Pass first_historical_data, last_historical_data, is_active, status to include all auxiliary fields.
+        /// </summary>
+        [JsonProperty("aux")]
+        public string Aux { get; set; }
+
+        /// <summary>
+        /// Optionally include one fiat or cryptocurrency IDs to filter market pairs by. 
+        /// For example ?crypto_id=1 would only return exchanges that have BTC.
+        /// </summary>
+        public string CryptoId { get; set; }
+
+    }
+}

src/Emun.CoinMarketCap/Models/Results/ExchangeMapResult.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Emun.CoinMarketCap.Models;
+
+namespace Emun.CoinMarketCap {
+
+    public class ExchangeMapResult : ApiResponse<List<ExchangeMapData>> {
+
+        public static ExchangeMapResult From(ApiResponse<List<ExchangeMapData>> model)
+            => new ExchangeMapResult {
+                Data = model.Data,
+                Status = model.Status
+            };
+
+    }
+}