coin_market_pro 0.1.0

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/coin_market_pro.gemspec

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'coin_market_pro/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'coin_market_pro'
+  spec.version       = CoinMarketPro::VERSION
+  spec.authors       = ['snogrammer']
+
+  spec.summary       = 'CoinMarketCap Pro v1 Api Ruby wrapper'
+  spec.homepage      = 'https://gitlab.com/snogrammer/coin_market_pro'
+  spec.license       = 'MIT'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activesupport', '~> 5.1'
+  spec.add_dependency 'multi_json',    '~> 1.13'
+  spec.add_dependency 'rest-client',   '~> 2.0'
+
+  spec.add_development_dependency 'bundler',    '~> 1.16'
+  spec.add_development_dependency 'pry',        '~> 0.11'
+  spec.add_development_dependency 'rake',       '~> 12.3'
+  spec.add_development_dependency 'rspec',      '~> 3.8'
+  spec.add_development_dependency 'simplecov',  '~> 0.16'
+  spec.add_development_dependency 'webmock',    '~> 3.4'
+end

data/lib/coin_market_pro/client/base.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require 'active_support'
+require 'active_support/core_ext/object'
+require 'rest_client'
+
+require_relative './result'
+Dir['./lib/coin_market_pro/endpoint/**/*.rb'].each { |f| require f }
+
+module CoinMarketPro
+  module Client
+    class Error < RuntimeError
+      def initialize(message)
+        super(message)
+      end
+    end
+
+    class Base
+      attr_reader :host, :api_key, :logger, :cryptocurrency, :exchange, :global_metrics, :tools
+
+      API_DOMAIN = 'https://pro-api.coinmarketcap.com'
+      API_VERSION = 'v1'
+      API_URL = "#{API_DOMAIN}/#{API_VERSION}"
+      DEFAULT_TIMEOUT = 10
+
+      def initialize(api_key: ENV.fetch('COIN_MARKET_PRO_API_KEY'), logger: Logger.new(STDOUT), timeout: DEFAULT_TIMEOUT)
+        @host = API_URL
+        @api_key = api_key
+        @logger = logger
+        @timeout = timeout
+
+        # services
+        @cryptocurrency = Endpoint::Cryptocurrency.new(client: self, logger: @logger)
+        @exchange = Endpoint::Exchange.new(client: self, logger: @logger)
+        @global_metrics = Endpoint::GlobalMetrics.new(client: self, logger: @logger)
+        @tools = Endpoint::Tools.new(client: self, logger: @logger)
+      end
+
+      # GET request
+      #
+      # @param uri [String]
+      # @param options [Hash]
+      # @param headers [Hash]
+      # @return [Result]
+      def get(uri, options: {}, headers: {})
+        request do
+          url = host + uri
+          options ||= {}
+          headers ||= {}
+
+          query_params = CGI.unescape(options.to_query)
+          url += '?' + query_params unless query_params.blank?
+
+          response = RestClient::Request.execute(method: :get,
+                                                 url: url,
+                                                 headers: default_headers.merge(headers),
+                                                 open_timeout: open_timeout,
+                                                 timeout: timeout)
+
+          logger.debug(message: 'GET Request', url: url, options: options, status: response.code)
+          success?(response.code) ? Result.success(response) : Result.failed(response)
+        end
+      end
+
+      # @yield [Result]
+      def request
+        result = yield
+
+        if result.success?
+          logger.debug(status: result.code, body: result.body)
+        else
+          logger.warn(error: 'Request Error', status: result.code, body: result.body)
+        end
+
+        result
+      rescue ::RestClient::GatewayTimeout
+        raise Error.new('Gateway timeout')
+      rescue ::RestClient::RequestTimeout
+        raise Error.new('Request timeout')
+      rescue ::RestClient::Exception => e
+        handle_error(e)
+      end
+
+      # Handle errors
+      # @param error [Error]
+      # @return [Result]
+      def handle_error(error)
+        response = error.response
+        message = error.message
+        logger.error(error: 'Request Error', code: response.code, message: message)
+        Result.failed(response)
+      end
+
+      # @return [Hash]
+      def default_headers
+        {
+          'Content-Type' => 'application/json',
+          'Accept' => 'application/json',
+          'User-Agent' => "coin_market_pro/#{CoinMarketPro::VERSION}",
+          'Accept-Encoding' => 'deflate, gzip',
+          'X-CMC_PRO_API_KEY' => api_key
+        }
+      end
+
+      # @return [Integer]
+      def timeout
+        @timeout || DEFAULT_TIMEOUT
+      end
+
+      # @return [Integer]
+      def open_timeout
+        @open_timeout || DEFAULT_TIMEOUT
+      end
+
+      private
+
+      # @return [Boolean]
+      def success?(status_code = 0)
+        return true if status_code.in?(200..299)
+
+        false
+      end
+    end
+  end
+end

data/lib/coin_market_pro/client/result.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module CoinMarketPro
+  module Client
+    ##
+    # Status object to capture result from an HTTP request
+    #
+    # Gives callers context of the result and allows them to
+    # implement successful strategies to handle success/failure
+    #
+    class Result
+      def self.success(response)
+        new(:success, response)
+      end
+
+      def self.failed(response)
+        new(:failed, response)
+      end
+
+      attr_reader :status, :code, :headers, :raw
+      attr_accessor :body
+
+      def initialize(status, response)
+        @raw = raw_parse(response.body)
+        @status = @raw[:status]&.merge(result: status) || { result: status }
+        @code = response.code
+        @body = @raw[:data]
+        @headers = response.headers # e.g. "Content-Type" will become :content_type.
+      end
+
+      def success?
+        @status[:result] == :success
+      end
+
+      def failure?
+        @status[:result] == :failed
+      end
+
+      def to_h
+        { status: @status, code: @code, headers: @headers, body: @body }
+      end
+
+      alias to_hash to_h
+
+      def method_missing(method, *args, &blk)
+        to_h.send(method, *args, &blk)
+      end
+
+      def respond_to_missing?(method, include_private = false)
+        to_h.respond_to?(method) || super
+      end
+
+      # @param body [JSON] Raw JSON body
+      def raw_parse(body)
+        JSON.parse(body, symbolize_names: true)
+      rescue StandardError => e
+        raise ResponseBodyParseError.new(error: 'JSON parse error', message: e.message, body: body)
+      end
+
+      class ResponseBodyParseError < StandardError; end
+    end
+  end
+end

data/lib/coin_market_pro/endpoint/base.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module CoinMarketPro
+  module Endpoint
+    class Base
+      attr_reader :client, :logger
+
+      def initialize(client:, logger:)
+        @client = client
+        @logger = logger
+      end
+
+      protected
+
+      # @param args [Hash]
+      # @return [Boolean]
+      # @raise [ArgumentError]
+      def valid_params?(args)
+        raise ArgumentError.new('At least one "id" or "symbol" is required.') if args[:id].blank? && args[:symbol].blank?
+
+        true
+      end
+
+      private
+
+      # Convert/Standardize base params
+      # @param params [Hash]
+      # @return [Hash]
+      def convert_params(**params)
+        return {} if params.blank?
+
+        params.each { |k, v| params[k] = standardize_value(v) }
+        params
+      end
+
+      # Standardize request params
+      def standardize_value(param)
+        if param.is_a?(Array)
+          param.join(',')
+        elsif param.is_a?(String)
+          param.strip
+        else
+          param
+        end
+      end
+    end
+  end
+end

data/lib/coin_market_pro/endpoint/cryptocurrency.rb

@@ -0,0 +1,235 @@
+# frozen_string_literal: true
+
+module CoinMarketPro
+  module Endpoint
+    # @see https://pro.coinmarketcap.com/api/v1#tag/cryptocurrency
+    class Cryptocurrency < Base
+      ENDPOINT = '/cryptocurrency'
+
+      # Returns all static metadata for one or more cryptocurrencies
+      #  including name, symbol, logo, and its various registered URLs.
+      #
+      # @param [Hash] args
+      # @option args [Array<Integer>] :id One or more CoinMarketCap cryptocurrency IDs.
+      # @option args [Array<String>] :symbol Alternatively pass one or more cryptocurrency symbols.
+      # @return [CoinMarketPro::Result]
+      # @note At least one "id" or "symbol" is required.
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyInfo
+      ##
+      def info(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/info", options: params.compact).tap do |resp|
+          resp.body = resp.body.map { |_k, data| data }
+        end
+      end
+
+      alias metadata info
+
+      # @note This endpoint is not yet available. It is slated for release in early Q4 2018.
+      # Returns paginated list of all cryptocurrencies with market data for a given historical time.
+      #
+      # @param [Hash] args
+      # @option args [String] :timestamp Timestamp (Unix or ISO 8601) to return historical cryptocurrency listings for.
+      # @option args [Integer] :start Optionally offset the start (1-based index) of the paginated list of items to return.
+      # @option args [Integer] :limit Optionally specify the number of results to return. Use this parameter
+      #  and the "start" parameter to determine your own pagination size.
+      # @option args [String] :convert Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the
+      #  first requires an additional call credit. A list of supported fiat options can be found here. Each conversion
+      #  is returned in its own "quote" object.
+      # @option args [String] :sort What field to sort the list of cryptocurrencies by.
+      # @option args [String] :sort_dir The direction in which to order cryptocurrencies against the specified sort.
+      # @option args [String] :cryptocurrency_type The type of cryptocurrency to include.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyListingsHistorical
+      ##
+      def listings_historical(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/listings/historical", options: params.compact)
+      end
+
+      # Get a paginated list of all cryptocurrencies with latest market data.
+      #
+      # @option timestamp [String] Timestamp (Unix or ISO 8601) to return historical cryptocurrency listings for.
+      # @option start [Integer] Optionally offset the start (1-based index) of the paginated list of items to return.
+      # @option limit [Integer] Optionally specify the number of results to return. Use this parameter
+      #  and the "start" parameter to determine your own pagination size.
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the
+      #  first requires an additional call credit. A list of supported fiat options can be found here. Each conversion
+      #  is returned in its own "quote" object.
+      # @option sort [String] What field to sort the list of cryptocurrencies by.
+      # @option sort_dir [String] The direction in which to order cryptocurrencies against the specified sort.
+      # @option cryptocurrency_type [String] The type of cryptocurrency to include.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyListingsLatest
+      ##
+      def listings(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/listings/latest", options: params.compact)
+      end
+
+      alias listings_latest listings
+
+      # Returns a paginated list of all cryptocurrencies by CoinMarketCap ID.
+      #
+      # @param [Hash] args
+      # @option args [String] :listing_status Only active coins are returned by default.
+      #  Pass 'inactive' to get a list of coins that are no longer active.
+      # @option args [Integer] :start Optionally offset the start (1-based index) of the paginated list of items to return.
+      # @option args [Integer] :limit Optionally specify the number of results to return.
+      #  Use this parameter and the "start" parameter to determine your own pagination size.
+      # @option args [Array] :symbol Optionally pass a list of cryptocurrency symbols to return
+      #  CoinMarketCap IDs for. If this option is passed, other options will be ignored.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyMap
+      ##
+      def map(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/map", options: params.compact)
+      end
+
+      # Lists all market pairs for the specified cryptocurrency with associated stats.
+      #
+      # @option id [String] A cryptocurrency by CoinMarketCap ID. Example: "1"
+      # @option symbol [String] Alternatively pass a cryptocurrency by symbol. Example: "BTC".
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option start [Integer] Optionally offset the start (1-based index) of the paginated list of items to return.
+      # @option limit [Integer] Optionally specify the number of results to return.
+      #  Use this parameter and the "start" parameter to determine your own pagination size.
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols.
+      #  Each additional convert option beyond the first requires an additional call credit.
+      #  A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyMarketpairsLatest
+      ##
+      def market_pairs(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/market-pairs/latest", options: params.compact).tap do |resp|
+          resp.body = [resp.body]
+        end
+      end
+
+      # Return an interval of historic OHLCV (Open, High, Low, Close, Volume) market quotes for a cryptocurrency.
+      #
+      # @option id [String] A cryptocurrency by CoinMarketCap ID. Example: "1"
+      # @option symbol [String] Alternatively pass a cryptocurrency by symbol. Example: "BTC".
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option time_period [String] Time period to return OHLCV data for. The default is "daily".
+      #  Additional options will be available in the future. See the main endpoint description for details.
+      # @option time_start [String] Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for.
+      #  Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date
+      #  format like "2018-09-19" without time.
+      # @option time_end [String] Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive).
+      #  Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for
+      #  daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.
+      # @option count [Number] Optionally limit the number of time periods to return results for.
+      #  The default is 10 items. The current query limit is 10000 items.
+      # @option interval [String] Optionally adjust the interval that "time_period" is sampled.
+      #  See main endpoint description for available options.
+      #  Valid Values: "daily" "weekly" "monthly" "yearly" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d"
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols.
+      #  Each additional convert option beyond the first requires an additional call credit.
+      #  A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyOhlcvHistorical
+      ##
+      def ohlcv_historical(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/ohlcv/historical", options: params.compact).tap do |resp|
+          resp.body = [resp.body]
+        end
+      end
+
+      # Return the latest OHLCV (Open, High, Low, Close, Volume) market values for one or
+      #  more cryptocurrencies in the currently UTC day.
+      #
+      # @option id [String] A cryptocurrency by CoinMarketCap ID. Example: "1"
+      # @option symbol [String] Alternatively pass a cryptocurrency by symbol. Example: "BTC".
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols.
+      #  Each additional convert option beyond the first requires an additional call credit.
+      #  A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyOhlcvLatest
+      def ohlcv(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/ohlcv/latest", options: params.compact).tap do |resp|
+          resp.body = resp.body.map { |_key, data| data }
+        end
+      end
+
+      alias ohlcv_latest ohlcv
+
+      # Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters.
+      #
+      # @option id [String] A cryptocurrency by CoinMarketCap ID. Example: "1"
+      # @option symbol [String] Alternatively pass a cryptocurrency by symbol. Example: "BTC".
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option time_period [String] Time period to return OHLCV data for. The default is "daily".
+      #  Additional options will be available in the future. See the main endpoint description for details.
+      # @option time_start [String] Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for.
+      #  Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date
+      #  format like "2018-09-19" without time.
+      # @option time_end [String] Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive).
+      #  Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for
+      #  daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.
+      # @option count [Number] Optionally limit the number of time periods to return results for.
+      #  The default is 10 items. The current query limit is 10000 items.
+      # @option interval [String] Optionally adjust the interval that "time_period" is sampled.
+      #  See main endpoint description for available options.
+      #  Valid Values: "daily" "weekly" "monthly" "yearly" "1d" "2d" "3d" "7d" "14d" "15d" "30d" "60d" "90d" "365d"
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols.
+      #  Each additional convert option beyond the first requires an additional call credit.
+      #  A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyQuotesHistorical
+      def quotes_historical(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/quotes/historical", options: params.compact).tap do |resp|
+          resp.body = [resp.body]
+        end
+      end
+
+      alias market_quotes_historical quotes_historical
+
+      # @option id [Array<String>] One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2
+      # @option symbol [String] Alternatively pass a cryptocurrency by symbol. Example: "BTC,ETH".
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option convert [String] Optionally calculate market quotes in up to 32 currencies at once by passing a
+      #  comma-separated list of cryptocurrency or fiat currency symbols.
+      #  Each additional convert option beyond the first requires an additional call credit.
+      #  A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1CryptocurrencyQuotesLatest
+      def quotes(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/quotes/latest", options: params.compact).tap do |resp|
+          resp.body = resp.body.map { |_key, data| data }
+        end
+      end
+
+      alias market_quotes quotes
+      alias quotes_latest quotes
+    end
+  end
+end

data/lib/coin_market_pro/endpoint/exchange.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module CoinMarketPro
+  module Endpoint
+    # @see https://pro.coinmarketcap.com/api/v1#tag/exchange
+    class Exchange < Base
+      ENDPOINT = '/exchange'
+
+      # Returns all static metadata for one or more exchanges including logo and homepage URL.
+      #
+      # @param [Hash] args
+      # @option args [Array<Integer>] :id
+      # @option args [Array<String>] :slug
+      # @return [CoinMarketPro::Result]
+      # @note At least one "id" or "slug" is required.
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeInfo
+      ##
+      def info(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/info", options: params.compact).tap do |resp|
+          resp.body = resp.body.map { |_k, data| data }
+        end
+      end
+
+      alias metadata info
+
+      # @note This endpoint is not yet available. It is slated for release in early Q4 2018.
+      # Get a paginated list of all cryptocurrency exchanges with historical market data for a given point in time.
+      #
+      # @param args [Hash]
+      # @option args [String] :timestamp
+      # @option args [Integer] :start
+      # @option args [Integer] :limit
+      # @option args [String] :convert
+      # @option args [String] :sort
+      # @option args [String] :sort_dir
+      # @option args [String] :market_type Default: 'fees'. Valid values: 'fees', 'no_fees', 'all'
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeListingsHistorical
+      ##
+      def listings_historical(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/listings/historical", options: params.compact)
+      end
+
+      # Get a paginated list of all cryptocurrency exchanges with 24 hour volume.
+      #
+      # @param args [Hash]
+      # @option args [String] :timestamp
+      # @option args [Integer] :start
+      # @option args [Integer] :limit
+      # @option args [String] :convert
+      # @option args [String] :sort
+      # @option args [String] :sort_dir
+      # @option args [String] :market_type Default: 'fees'. Valid values: 'fees', 'no_fees', 'all'
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeListingsLatest
+      ##
+      def listings(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/listings/latest", options: params.compact)
+      end
+
+      alias listings_latest listings
+
+      # Returns a paginated list of all cryptocurrencies by CoinMarketCap ID.
+      #
+      # @param [Hash] args
+      # @option args [String] :listing_status Optional. Defaults to 'active'
+      # @option args [Integer] :start
+      # @option args [Integer] :limit
+      # @option args [Array] :slug
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeMap
+      ##
+      def map(**args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/map", options: params.compact)
+      end
+
+      # Get a list of active market pairs for an exchange.
+      #
+      # @param [Hash] args
+      # @option args [Array<Integer>] :id
+      # @option args [Array<String>] :slug
+      # @option args [Integer] :start
+      # @option args [Integer] :limit
+      # @option args [String] :convert
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeMarketpairsLatest
+      ##
+      def market_pairs(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/market-pairs/latest", options: params.compact).tap do |resp|
+          resp.body = [resp.body]
+        end
+      end
+
+      # Returns an interval of historic quotes for any exchange based on time and interval parameters.
+      #
+      # @param [Hash] args
+      # @option args [Array<Integer>] :id
+      # @option args [Array<String>] :slug
+      #  A single cryptocurrency "id" or "symbol" is required.
+      # @option args [String] :time_period
+      # @option args [String] :time_start
+      # @option args [String] :time_end
+      # @option args [Number] :count
+      # @option args [String] :interval
+      # @option args [String] :convert
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeQuotesHistorical
+      def quotes_historical(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/quotes/historical", options: params.compact).tap do |resp|
+          resp.body = [resp.body]
+        end
+      end
+
+      alias market_quotes_historical quotes_historical
+
+      # @param [Hash] args
+      # @option args [Array<Integer>] :id
+      # @option args [Array<String>] :slug
+      # @option args [String] :convert
+      # @return [CoinMarketPro::Result]
+      #
+      # @see https://pro.coinmarketcap.com/api/v1#operation/getV1ExchangeQuotesLatest
+      def quotes(**args)
+        valid_params?(args)
+        params = convert_params(args)
+        client.get("#{ENDPOINT}/quotes/latest", options: params.compact).tap do |resp|
+          resp.body = resp.body.map { |_k, data| data }
+        end
+      end
+
+      alias market_quotes quotes
+      alias quotes_latest quotes
+
+      protected
+
+      # @param args [Hash]
+      # @return [Boolean]
+      # @raise [ArgumentError]
+      def valid_params?(args)
+        raise ArgumentError.new('At least one "id" or "slug" is required.') if args[:id].blank? && args[:slug].blank?
+
+        true
+      end
+    end
+  end
+end