coingecko_ruby 0.2.0 → 0.4.1

data/lib/coingecko_ruby/client/finance.rb

@@ -0,0 +1,100 @@
+module CoingeckoRuby
+  class Client
+    module Finance
+      # Fetches the list of finance platforms (e.g. Celsius Network, dYdX) listed in CoinGecko.
+      #
+      # @option options [Integer] :per_page (100) sets the number of results to return per page.
+      # @option options [Integer] :page sets the page for results.
+      #
+      # @return [Array<Hash>] each finance platform's name, category, url, facts (description), and centralized status.
+      #
+      # @example Get all finance platforms.
+      #   client.finance_platforms
+      # @example Sample response object (truncated)
+      #   [
+      #     {
+      #       "name"=>"Binance Staking",
+      #       "facts"=>"",
+      #       "category"=>"CeFi Platform",
+      #       "centralized"=>true,
+      #       "website_url"=>"https://www.binance.com/en/staking"
+      #     },
+      #     {
+      #       "name"=>"Celsius Network",
+      #       "facts"=>"",
+      #       "category"=>"CeFi Platform",
+      #       "centralized"=>true,
+      #       "website_url"=>"https://celsius.network/"
+      #     },
+      #     {
+      #       "name"=>"Cobo",
+      #       "facts"=>"",
+      #       "category"=>"CeFi Platform",
+      #       "centralized"=>true,
+      #       "website_url"=>"https://cobo.com/"
+      #     }
+      #   ]
+      def finance_platforms(**options)
+        get 'finance_platforms', options
+      end
+
+      # @deprecated Use {#finance_platforms} instead
+      def get_finance_platforms(options: {})
+        finance_platforms(**options)
+      end
+
+      # Fetches the list of finance products (e.g. Binance Savings, Nexo, Fulcrum) listed in CoinGecko.
+      #
+      # @option options [Integer] :per_page (100) sets the number of results to return per page.
+      # @option options [Integer] :page sets the page for results.
+      # @option options [Integer] :start_at filter results based on the launch date of the product in UNIX timestamp format.
+      # @option options [Integer] :end_at filter results based on the end date of the product in UNIX timestamp format.
+      #
+      # @return [Array<Hash>] each finance product's platform, identifier, supply and borrow rate percentage, and the product duration data.
+      #
+      # @example Get all finance products.
+      #   client.finance_products
+      # @example Sample response object (truncated)
+      #   [
+      #     {"platform"=>"Binance Savings",
+      #     "identifier"=>"XTZ001",
+      #     "supply_rate_percentage"=>"1.956035",
+      #     "borrow_rate_percentage"=>nil,
+      #     "number_duration"=>nil,
+      #     "length_duration"=>nil,
+      #     "start_at"=>0,
+      #     "end_at"=>0,
+      #     "value_at"=>0,
+      #     "redeem_at"=>0},
+      #    {"platform"=>"Binance Savings",
+      #     "identifier"=>"ZEC001",
+      #     "supply_rate_percentage"=>"0.182865",
+      #     "borrow_rate_percentage"=>nil,
+      #     "number_duration"=>nil,
+      #     "length_duration"=>nil,
+      #     "start_at"=>0,
+      #     "end_at"=>0,
+      #     "value_at"=>0,
+      #     "redeem_at"=>0},
+      #    {"platform"=>"Crypto.com",
+      #     "identifier"=>"BAT",
+      #     "supply_rate_percentage"=>"2.0",
+      #     "borrow_rate_percentage"=>nil,
+      #     "number_duration"=>nil,
+      #     "length_duration"=>nil,
+      #     "start_at"=>0,
+      #     "end_at"=>0,
+      #     "value_at"=>0,
+      #     "redeem_at"=>0}
+      #   ]
+      def finance_products(**options)
+        get 'finance_products', options
+      end
+
+      # @deprecated Use {#finance_products} instead
+      def get_finance_products(options: {})
+        finance_products(**options)
+      end
+    end
+  end
+end

data/lib/coingecko_ruby/client/indexes.rb

@@ -0,0 +1,88 @@
+module CoingeckoRuby
+  class Client
+    module Indexes
+      # Fetches the list of market indexes listed in CoinGecko.
+      #
+      # @option options [Integer] :per_page (100) sets the number of results to return per page.
+      # @option options [Integer] :page sets the page for results.
+      #
+      # @return [Array<Hash>] each index's id, name, market name, last done, and whether it's a multiasset composite index.
+      #
+      # @example Get all market indexes.
+      #   client.indexes
+      # @example Sample response object
+      #   [
+      #     {"name"=>"CoinFLEX (Futures) DFN",
+      #     "id"=>"DFN",
+      #     "market"=>"CoinFLEX (Futures)",
+      #     "last"=>nil,
+      #     "is_multi_asset_composite"=>nil},
+      #    {"name"=>"Bibox (Futures) LINK",
+      #     "id"=>"LINK",
+      #     "market"=>"Bibox (Futures)",
+      #     "last"=>nil,
+      #     "is_multi_asset_composite"=>nil},
+      #    {"name"=>"CME Bitcoin Futures BTC",
+      #     "id"=>"BTC",
+      #     "market"=>"CME Bitcoin Futures",
+      #     "last"=>nil,
+      #     "is_multi_asset_composite"=>false}
+      #   ]
+      def indexes(**options)
+        get 'indexes', options
+      end
+
+      # @deprecated Use {#indexes} instead
+      def get_indexes(options: {})
+        indexes(**options)
+      end
+
+      # Fetches the ids of market indexes listed in CoinGecko.
+      #
+      # @return [Array<Hash>] each index's id and name.
+      #
+      # @example Get all market index ids and names.
+      #   client.index_ids
+      # @example Sample response object
+      #   [
+      #    {"id"=>"LINK", "name"=>"Bibox (Futures) LINK"},
+      #    {"id"=>"BTC", "name"=>"CME Bitcoin Futures BTC"},
+      #    {"id"=>"XRP", "name"=>"Bibox (Futures) XRP"},
+      #    {"id"=>"ETH", "name"=>"Crypto.com (Futures) ETH"}
+      #   ]
+      def index_ids
+        get 'indexes/list'
+      end
+
+      # @deprecated Use {#index_ids} instead
+      def get_indexes_ids
+        index_ids
+      end
+
+      # Fetches the list of indexes based on the market and index given.
+      #
+      # @param market_id [String] filter results by the market id.
+      # @param coin_id [String] filter indexes from the given market by the index id.
+      #
+      # @return [Array<Hash>] the index's name, market, last done, and whether it's a multiasset composite index.
+      #
+      # @example Get all BTC indexes in the CME Futures market.
+      #   client.indexes_by_market_and_coin(market_id: 'cme_futures', coin_id: 'btc')
+      # @example Sample response object
+      #   {
+      #     "name"=>"CME Bitcoin Futures BTC",
+      #     "market"=>"CME Bitcoin Futures",
+      #     "last"=>nil,
+      #     "is_multi_asset_composite"=>false
+      #   }
+      def indexes_by_market_and_coin(market_id, coin_id, **options)
+        get "indexes/#{market_id}/#{coin_id}", options
+      end
+
+      # @deprecated Use {#indexes_by_market_and_coin} instead
+      def get_indexes_by_market_and_index(market_id:, index_id:, options: {})
+        indexes_by_market_and_index(market_id, index_id, **options)
+      end
+    end
+  end
+end

data/lib/coingecko_ruby/client/infos.rb

@@ -0,0 +1,174 @@
+module CoingeckoRuby
+  class Client
+    module Infos
+      # Fetches global crypto data from CoinGecko.
+      #
+      # @return [Hash] global crypto data (e.g. market cap, total volume, active ICOs, etc.)
+      #
+      # @example Get global crypto data.
+      #   client.global_crypto_data
+      # @example Sample response object (truncated)
+      #   {
+      #     "data" => {
+      #       "active_cryptocurrencies" => 7361,
+      #       "upcoming_icos" => 0,
+      #       "ongoing_icos" => 50,
+      #       "ended_icos" => 3375,
+      #       "markets" => 616,
+      #       "total_market_cap" => {
+      #         "btc" => 48541739.601360835,
+      #         "eth" => 628896708.615425,
+      #         "ltc" => 7052042789.61238,
+      #         "bch" => 1934433566.5425043
+      #       },
+      #       "total_volume" => {
+      #         "btc" => 6568919.505737251,
+      #         "eth" => 85105558.43783577,
+      #         "ltc" => 954318939.049309,
+      #         "usd" => 286508058915.08606
+      #       }
+      #       "market_cap_percentage" => {
+      #         "btc" => 38.55040456662042,
+      #         "eth" => 18.387297257364622,
+      #       },
+      #       "market_cap_change_percentage_24h_usd" => -3.133283965790086,
+      #       "updated_at" => 1621344957
+      #     }
+      #   }
+      def global_crypto_data
+        get 'global'
+      end
+
+      # @deprecated Use {#global_crypto_data} instead
+      def get_global_crypto_data
+        global_crypto_data
+      end
+
+      # Fetches global crypto data from CoinGecko.
+      #
+      # @return [Hash] global defi data.
+      #
+      # @example Get global defi data.
+      #   client.global_defi_data
+      # @example Sample response object
+      #   {
+      #     "data" => {
+      #       "defi_market_cap" => "125745676087.2760332093360054945",
+      #       "eth_market_cap" => "394420680555.8088822113739591981",
+      #       "defi_to_eth_ratio" =>
+      #       "31.8811062112863892278072770612100063079659263284319798945238447",
+      #       "trading_volume_24h" => "15011166214.23270941006219308344",
+      #       "defi_dominance" =>
+      #       "5.8997291574682455351428477202615510371051549446051010984545824",
+      #       "top_coin_name" => "Uniswap",
+      #       "top_coin_defi_dominance" => 14.449398175884316
+      #     }
+      #   }
+      def global_defi_data
+        get 'global/decentralized_finance_defi'
+      end
+
+      # @deprecated Use {#global_defi_data} instead
+      def get_global_defi_data
+        global_defi_data
+      end
+
+      # Fetches the top 7 coin searches from CoinGecko in the last 24 hours.
+      #
+      # @return [Hash] the ternding searches and its information.
+      #
+      # @example Get trending searches in the last 24 hours.
+      #   client.trending_searches
+      # @example Sample response object (truncated)
+      #   {
+      #     "coins" => [{
+      #         "item" => {
+      #           "id" => "shiba-inu",
+      #           "coin_id" => 11939,
+      #           "name" => "Shiba Inu",
+      #           "symbol" => "SHIB",
+      #           "market_cap_rank" => 24,
+      #           "thumb" =>
+      #           "https://assets.coingecko.com/coins/images/11939/thumb/SHIBLOGO.png?1600752116",
+      #           "small" =>
+      #           "https://assets.coingecko.com/coins/images/11939/small/SHIBLOGO.png?1600752116",
+      #           "large" =>
+      #           "https://assets.coingecko.com/coins/images/11939/large/SHIBLOGO.png?1600752116",
+      #           "slug" => "shiba-inu",
+      #           "price_btc" => 3.637711629799728e-10,
+      #           "score" => 0
+      #         }
+      #       },
+      #     ],
+      #     "exchanges" => []
+      #   }
+      def trending_searches
+        get 'search/trending'
+      end
+
+      # @deprecated Use {#trending_searches} instead
+      def get_trending_searches
+        trending_searches
+      end
+
+      # Fetches coin and/or market status updates.
+      #
+      # @option options [String] :category filter results by the given category. Valid values: general, milestone, partnership, exchange_listing, software_release, fund_movement, new_listings, event
+      # @option options [String] :project_type filter results by the project type. Fetches both coin and market status updates if left blank. Valid values: coin, market
+      # @option options [Integer] :per_page sets the number of results to return per page.
+      # @option options [Integer] :page sets the page for results.
+      #
+      # @return [Hash] the list of status updates and its information.
+      #
+      # @example Get a single status update.
+      #   client.status_updates(per_page: 1)
+      # @example Sample response object
+      #   {
+      #     "status_updates" => [{
+      #       "description" =>
+      #       "📢 Community Call & AMA Invitation 📢\r\n" +
+      #       "\r\n" +
+      #       "Thursday 20th May at 4pm CET (Registration below)\r\n" +
+      #       "\r\n" +
+      #       "During this event, we will be updating our community on the latest news and developments at Fuse, covering:\r\n" +
+      #       "\r\n" +
+      #       "- Fuse Dollar (fUSD)\r\n" +
+      #       "- Fuse Cash\r\n" +
+      #       "- Latest partnerships and integrations.\r\n" +
+      #       "- Binance Smart Chain (BSC) bridge.\r\n" +
+      #       "- DeFi on Fuse.\r\n" +
+      #       "- Featured communities.\r\n" +
+      #       "- What to expect for the rest of Q2 and beyond!\r\n" +
+      #       "\r\n" +
+      #       "Please register 👉 https://bit.ly/3furWZs",
+      #       "category" => "general",
+      #       "created_at" => "2021-05-18T08:29:06.537Z",
+      #       "user" => "Robert Miller",
+      #       "user_title" => "Marcom Director ",
+      #       "pin" => false,
+      #       "project" => {
+      #         "type" => "Coin",
+      #         "id" => "fuse-network-token",
+      #         "name" => "Fuse",
+      #         "symbol" => "fuse",
+      #         "image" => {
+      #           "thumb" =>
+      #           "https://assets.coingecko.com/coins/images/10347/thumb/vUXKHEe.png?1601523640",
+      #           "small" =>
+      #           "https://assets.coingecko.com/coins/images/10347/small/vUXKHEe.png?1601523640",
+      #           "large" =>
+      #           "https://assets.coingecko.com/coins/images/10347/large/vUXKHEe.png?1601523640"
+      #         }
+      #       }
+      #     }]
+      #   }
+      def status_updates(**options)
+        get 'status_updates', options
+      end
+
+      def get_status_updates(options: {})
+        status_updates(**options)
+      end
+    end
+  end
+end

data/lib/coingecko_ruby/client/prices.rb

@@ -2,8 +2,8 @@ module CoingeckoRuby
   class Client
     module Prices
       # Fetches the current price for a coin in the given coin or currency.
-      # @param id [String] the coin id to fetch.
-      # @param currency [String] the currency to display the coin's price.
+      # @param ids [String, Array] the coin id or array of ids to fetch.
+      # @param currency [String, Array] the currency or array of currencies to display the coin's price. Defaults to 'USD'
       # @option options [Boolean] :include_market_cap include market cap data.
       # @option options [Boolean] :include_24hr_vol include 24 hour volume data.
       # @option options [Boolean] :include_24hr_change include 24 hour price change data.
@@ -12,16 +12,16 @@ module CoingeckoRuby
       # @return [Hash] returns the given coin id and its current price.
       #
       # @example Fetch the current price in USD for Bitcoin.
-      #   client.get_price(id: 'bitcoin', currency: 'usd')
-      # @example Response object
+      #   client.price('bitcoin', currency: 'usd')
+      # @example Sample response object
       #   {
       #     "bitcoin" => {
       #       "usd" => 47931 # current price in given currency
       #     }
       #   }
       # @example Fetch the current price, market cap, 24 hour volume, 24 hour price change and last updated at for Bitcoin.
-      #   client.get_price(id: 'bitcoin', currency: 'usd', options: { include_market_cap: true, include_24hr_vol: true, include_24hr_change: true, include_last_updated_at: true })
-      # @example Response object
+      #   client.price('bitcoin', 'usd', include_market_cap: true, include_24hr_vol: true, include_24hr_change: true, include_last_updated_at: true)
+      # @example Sample response object
       #   {
       #     "bitcoin" => {
       #       "usd" => 48217, # current price in given currency
@@ -31,44 +31,38 @@ module CoingeckoRuby
       #       "last_updated_at" => 1621142197 # last updated at UNIX timestamp for the given coin
       #     }
       #   }
+      def price(ids, currency: 'usd', **options)
+        ids = ids.join(',') if ids.is_a? Array
+        currency = currency.join(',') if currency.is_a? Array
+        get 'simple/price', { ids: ids, vs_currencies: currency, **options }
+      end
+
+      # @see Alias for {#price}
+      def prices(ids, currency: 'usd', **options)
+        price(ids, currency: currency, **options)
+      end
+
+      # @deprecated Use {#price} or {#prices} instead
       def get_price(id:, currency: 'usd', options: {})
-        get 'simple/price', { ids: id, vs_currencies: currency, options: options }
+        price(id, currency, **options)
       end
 
       # Fetches historical price data for a coin at a given date.
       # @param id [String] the coin id to fetch.
-      # @param date [String] the date to fetch the historical price, date given must be in the form of 'DD-MM-YYYY' (e.g: '14-05-2021').
+      # @param date [String] the date to fetch the historical price, date given must be in the form of 'DD-MM-YYYY' (e.g: '14-05-2021'). Defaults to today's date.
       #
       # @return [Hash] returns the coin's historical price data on the given date.
       #
       # @example Fetch Bitcoin's price on 30th December, 2017.
-      #   client.get_historical_price_on_date(id: 'bitcoin', date: '30-12-2017')
-      # @example Response object (truncated)
+      #   client.historical_price('bitcoin', date: '30-12-2017')
+      # @example Sample response object (truncated)
       #   {
       #     "id": "bitcoin",
       #     "symbol": "btc",
       #     "name": "Bitcoin",
       #     "localization": {
       #       "en": "Bitcoin",
-      #       "de": "Bitcoin",
-      #       "es": "Bitcoin",
-      #       "fr": "Bitcoin",
-      #       "it": "Bitcoin",
-      #       "pl": "Bitcoin",
-      #       "ro": "Bitcoin",
-      #       "hu": "Bitcoin",
-      #       "nl": "Bitcoin",
-      #       "pt": "Bitcoin",
-      #       "sv": "Bitcoin",
-      #       "vi": "Bitcoin",
-      #       "tr": "Bitcoin",
-      #       "ru": "биткоин",
       #       "ja": "ビットコイン",
-      #       "zh": "比特币",
-      #       "zh-tw": "比特幣",
-      #       "ko": "비트코인",
-      #       "ar": "بيتكوين",
-      #       "th": "บิตคอยน์",
       #       "id": "Bitcoin"
       #     },
       #     "image": {
@@ -77,175 +71,25 @@ module CoingeckoRuby
       #     },
       #     "market_data": {
       #       "current_price": {
-      #         "aed": 50024.57906376443,
-      #         "ars": 253468.12429692186,
-      #         "aud": 17446.3215245937,
-      #         "bch": 5.76928286478153,
-      #         "bdt": 1126110.803183989,
-      #         "bhd": 5132.860612995706,
-      #         "bmd": 13620.3618741461,
-      #         "brl": 45117.7211153463,
       #         "btc": 1,
-      #         "cad": 17128.871750393,
-      #         "chf": 13262.4868659029,
-      #         "clp": 8362902.190725706,
-      #         "cny": 88573.2132675718,
-      #         "czk": 289914.5782287119,
-      #         "dkk": 84525.1736167662,
       #         "eth": 18.483094024188404,
       #         "eur": 11345.8976447824,
       #         "gbp": 10079.0677868681,
-      #         "hkd": 106417.930376984,
-      #         "huf": 3526720.3000726495,
-      #         "idr": 184652192.175199,
-      #         "ils": 47387.96303252911,
-      #         "inr": 869671.001953725,
-      #         "jpy": 1535062.45448282,
-      #         "krw": 14537693.2463698,
-      #         "kwd": 4104.645874754543,
-      #         "lkr": 2087919.548829924,
-      #         "ltc": 60.96840666846534,
-      #         "mmk": 18414729.253845528,
-      #         "mxn": 267888.750532982,
-      #         "myr": 55317.8739192755,
-      #         "ngn": 4884546.501733771,
-      #         "nok": 111755.75019546246,
-      #         "nzd": 19178.1505368914,
-      #         "php": 680527.760679833,
-      #         "pkr": 1505414.7676248574,
-      #         "pln": 47450.61669715,
-      #         "rub": 785377.30638701,
-      #         "sar": 51079.0811004227,
-      #         "sek": 111446.704184538,
-      #         "sgd": 18213.1478981081,
-      #         "thb": 442954.59869004245,
-      #         "try": 51700.07425935065,
-      #         "twd": 404053.46952093,
-      #         "uah": 382908.08925747185,
       #         "usd": 13620.3618741461,
-      #         "vef": 140859.73944813784,
-      #         "vnd": 309201434.91677517,
-      #         "xag": 804.154745877564,
-      #         "xau": 10.4549897745945,
-      #         "xdr": 9563.95932114975,
-      #         "zar": 168771.061713303,
-      #         "bits": 1000000,
-      #         "link": 22041.447552365687,
-      #         "sats": 100000000
       #       },
       #       "market_cap": {
-      #         "aed": 839030999274.6053,
-      #         "ars": 4251262431254.5815,
-      #         "aud": 292616246981.057,
-      #         "bch": 96764575.68919012,
-      #         "bdt": 18887552682553.043,
-      #         "bhd": 86090263023.8938,
-      #         "bmd": 228445816988.881,
-      #         "brl": 756731337692.006,
       #         "btc": 16772375,
-      #         "cad": 287291860324.498,
-      #         "chf": 222443403147.498,
-      #         "clp": 140265731631172.94,
-      #         "cny": 1485583147878.69,
-      #         "czk": 4862556024018.788,
-      #         "dkk": 1417687908840.51,
       #         "eth": 310005384.13394696,
       #         "eur": 190297650009.907,
       #         "gbp": 169049904571.772,
-      #         "hkd": 1784881435006.67,
-      #         "huf": 59151475392930.96,
-      #         "idr": 3097055811734500,
-      #         "ils": 794808686467.7148,
-      #         "inr": 14586448171393.6,
-      #         "jpy": 25746643135006.3,
-      #         "krw": 243831642763082,
-      #         "kwd": 68844659853.58617,
-      #         "lkr": 35019369642806.27,
-      #         "ltc": 1022584979.7960014,
-      #         "mmk": 308858744568967.1,
-      #         "mxn": 4493130582220.62,
-      #         "myr": 927812125576.808,
-      #         "ngn": 81925445632016.88,
-      #         "nok": 1874409350684.6182,
-      #         "nzd": 321663132611.194,
-      #         "php": 11414066800032.4,
-      #         "pkr": 25249381013141.95,
-      #         "pln": 795859537225.861,
-      #         "rub": 13172642699212.8,
-      #         "sar": 856717502871.7015,
-      #         "sek": 1869225915097.14,
-      #         "sgd": 305477746477.531,
-      #         "thb": 7429400637203.895,
-      #         "try": 867133033005.6757,
-      #         "twd": 6776936310856.11,
-      #         "uah": 6422278063559.784,
       #         "usd": 228445816988.881,
-      #         "vef": 2362552372426.4595,
-      #         "vnd": 5186042416962243,
-      #         "xag": 13487584955.8882,
-      #         "xau": 175355009.120664,
-      #         "xdr": 160410312219.069,
-      #         "zar": 2830691536203.66,
-      #         "bits": 16772375000000,
-      #         "link": 369687423891.10944,
-      #         "sats": 1677237500000000
       #       },
       #       "total_volume": {
-      #         "aed": 13223772038.888288,
-      #         "ars": 67003156399.47071,
-      #         "aud": 4611856472.88116,
-      #         "bch": 1525083.9259334763,
-      #         "bdt": 297682315984.16693,
-      #         "bhd": 1356848571.721612,
-      #         "bmd": 3600481281.03768,
-      #         "brl": 11926666253.0629,
       #         "btc": 264345.493482963,
-      #         "cad": 4527940055.66402,
-      #         "chf": 3505878635.37842,
-      #         "clp": 2210695506557.1357,
-      #         "cny": 23413929770.588,
-      #         "czk": 76637612249.77382,
-      #         "dkk": 22343848731.4572,
       #         "eth": 4885922.610916088,
       #         "eur": 2999236911.91719,
       #         "gbp": 2664356147.96788,
-      #         "hkd": 28131100320.9394,
-      #         "huf": 932272618099.0865,
-      #         "idr": 48811974863263.9,
-      #         "ils": 12526794472.986298,
-      #         "inr": 229893610179.28,
-      #         "jpy": 405786842057.429,
-      #         "krw": 3842973695315.56,
-      #         "kwd": 1085044639.3347962,
-      #         "lkr": 551932123488.1709,
-      #         "ltc": 16116723.547645444,
-      #         "mmk": 4867850691962.943,
-      #         "mxn": 70815183958.1755,
-      #         "myr": 14623030679.6192,
-      #         "ngn": 1291207855441.2922,
-      #         "nok": 29542128934.978218,
-      #         "nzd": 5069657667.76511,
-      #         "php": 179894446725.766,
-      #         "pkr": 397949609644.3324,
-      #         "pln": 12543356686.879,
-      #         "rub": 207610951627.194,
-      #         "sar": 13502524900.147509,
-      #         "sek": 29460434014.7115,
-      #         "sgd": 4814563569.00357,
-      #         "thb": 117093051981.26692,
-      #         "try": 13666681643.19386,
-      #         "twd": 106809713794.014,
-      #         "uah": 101220027813.38469,
       #         "usd": 3600481281.03768,
-      #         "vef": 37235637336.29954,
-      #         "vnd": 81736005898715.08,
-      #         "xag": 212574683.135671,
-      #         "xau": 2763729.43132451,
-      #         "xdr": 2528189546.40031,
-      #         "zar": 44613869594.2467,
-      #         "bits": 264345493482.963,
-      #         "link": 5826557330.308955,
-      #         "sats": 26434549348296.3
       #       }
       #     },
       #     "community_data": {
@@ -275,20 +119,27 @@ module CoingeckoRuby
       #       "bing_matches": null
       #     }
       #   }
+      def historical_price(id, date:, **options)
+        date = Time.now.strftime('%d-%m-%Y') if date.nil?
+
+        get "coins/#{id}/history", { date: date, **options }
+      end
+
+      # @deprecated Use {#historical_price} instead
       def get_historical_price_on_date(id:, date:)
-        get("coins/#{id}/history", { query: { date: date } })
+        historical_price(id, date: date)
       end
 
       # Fetches a coin's historical price data in 5 - 10 minutes ranges.
       # @note Minutely historical data is only available within the last 24 hours.
       # @param id [String] the coin id to fetch.
-      # @param currency [String] the currency used to display minutely historical price.
+      # @param currency [String] the currency used to display minutely historical price. Defaults to 'USD'
       #
       # @return [Hash] returns the coin's minutely historical price data within the last 24 hours.
       #
       # @example Fetch Bitcoin's minutely historical price within the last 24 hours.
-      #   client.get_minutely_historical_prices(id: 'bitcoin')
-      # @example Response object (truncated)
+      #   client.minutely_historical_price('bitcoin')
+      # @example Sample response object (truncated)
       #   {
       #     "prices" => [
       #       [1621057474114, 49364.605172521166], # [UNIX timestamp for minutely price data, coin price in given currency]
@@ -306,21 +157,26 @@ module CoingeckoRuby
       #       [1621058047104, 57046967935.326035],
       #     ]
       #   }
+      def minutely_historical_price(id, currency: 'usd', **options)
+        get "coins/#{id}/market_chart", { vs_currency: currency, days: 1, **options }
+      end
+
+      # @deprecated Use {#minutely_historical_price} instead
       def get_minutely_historical_prices(id:, currency: 'usd')
-        get "coins/#{id}/market_chart", { id: id, vs_currency: currency, days: 1 }
+        minutely_historical_price(id, currency: currency)
       end
 
       # Fetches a coin's historical price data in 1 hour ranges.
       # @note Hourly historical data is only available within the last 90 days.
       # @param id [String] the coin id to fetch.
-      # @param days [Integer] the number of days to fetch hourly historical prices (min: 1 day, max: 90 days)
-      # @param currency [String] the currency used to display hourly historical price.
+      # @param currency [String] the currency used to display hourly historical price. Defaults to 'USD'
+      # @param days [Integer] the number of days to fetch hourly historical prices (min: 1 day, max: 90 days). Defaults to 7 days
       #
       # @return [Hash] returns the coin's hourly historical price data within the number of days given.
       #
-      # @example Fetch Bitcoin's hourly historical price within the last 7 days.
-      #   client.get_hourly_historical_prices(id: 'bitcoin', days: 7)
-      # @example Response object (truncated)
+      # @example Fetch Bitcoin's hourly historical price in USD within the last 7 days.
+      #   client.hourly_historical_price('bitcoin', days: 7)
+      # @example Sample response object (truncated)
       #   {
       #     "prices" => [
       #       [1620540153122, 58533.64354969528], # [UNIX timestamp for minutely price data, coin price in given currency]
@@ -336,21 +192,27 @@ module CoingeckoRuby
       #       [1620547381049, 72064327648.28767],
       #     ]
       #   }
-      def get_hourly_historical_prices(id:, days:, currency: 'usd')
-        return get_daily_historical_prices(id: id, days: days) if days > 90
+      def hourly_historical_price(id, currency: 'usd', days: 7, **options)
+        return daily_historical_price(id, currrency: currency, days: days) if days > 90
 
-        get "coins/#{id}/market_chart", { vs_currency: currency, days: days }
+        get "coins/#{id}/market_chart", { vs_currency: currency, days: days, **options }
+      end
+
+      # @deprecated Use {#hourly_historical_price} instead
+      def get_hourly_historical_prices(id:, days:, currency: 'usd')
+        hourly_historical_price(id, currency: currency, days: days)
       end
 
       # Fetches a coin's historical price data in daily ranges.
       # @param id [String] the coin id to fetch.
-      # @param days [Integer] the number of days to fetch daily historical prices.
-      # @param currency [String] the currency used to display daily historical price.
+      # @param days [Integer] the number of days to fetch daily historical prices. Defaults to 7 days.
+      # @param currency [String] the currency used to display daily historical price. Defaults to USD.
       #
       # @return [Hash] returns the coin's daily historical price data within the number of days given.
       #
       # @example Fetch Bitcoin's daily historical price within the last 14 days.
-      #   client.get_daily_historical_prices(id: 'bitcoin', days: 14)
+      #   client.daily_historical_prices('bitcoin', days: 14)
+      # @example Sample response object (truncated)
       #   {
       #     "prices" => [
       #       [1620000000000, 56600.74528738432], # [UNIX timestamp for minutely price data, coin price in given currency]
@@ -366,37 +228,40 @@ module CoingeckoRuby
       #       [1620172800000, 71296763919.13268],
       #     ]
       #   }
+      def daily_historical_price(id, currency: 'usd', days: 7, **options)
+        get "coins/#{id}/market_chart", { vs_currency: currency, days: days, interval: 'daily', **options }
+      end
+
+      # @deprecated Use {#daily_historical_price} instead
       def get_daily_historical_prices(id:, days:, currency: 'usd')
-        get "coins/#{id}/market_chart", { vs_currency: currency, days: days, interval: 'daily' }
+        daily_historical_price(id, currency: currency, days: days)
       end
 
       # Fetches a coin's open, high, low, and close (OHLC) data within the number of days given.
       # @param id [String] the coin id to fetch.
-      # @param days [Integer, String] the number of days to fetch daily historical prices. Valid values: 1/7/14/30/90/180/365/'max'
-      # @param currency [String] the currency to display OHLC data.
+      # @param days [Integer, String] the number of days to fetch daily historical prices. Valid values: 1/7/14/30/90/180/365/'max'. Defaults to 7 days.
+      # @param currency [String] the currency to display OHLC data. Defaults to 'USD'.
       #
       # @return [Array<Array<String, Float>>] returns the coin's OHLC data within the number of days given.
       #   If the number of days given is between 1-2 days, the OHLC data is returned in 30-minute intervals.
       #   If the number of days given is between 3-30 days, the OHLC data is returned in 4-hour intervals.
       #   If the number of days given is more than 30 days, the OHLC data is returned in 4-day intervals.
       #
-      # @example Fetch Bitcoin's OHLC data in USD within the last 7 days.
-      #   client.get_ohlc(id: 'bitcoin', days: 7, currency: 'usd')
-      # @example Response object (truncated)
+      # @example Fetch Bitcoin's OHLC data within the last 7 days.
+      #   client.ohlc('bitcoin', days: 7)
+      # @example Sample response object (truncated)
       #   [
       #     [1620547200000, 58384.27, 58384.27, 58384.27, 58384.27], # [UNIX timestamp for OHLC data, open, high, low, close]
       #     [1620561600000, 58022.03, 58214.96, 57943.18, 58048.35],
       #     [1620576000000, 57956.7, 57956.7, 56636.68, 57302.22],
-      #     [1620590400000, 57396.24, 57618.74, 57396.24, 57535.26],
-      #     [1620604800000, 57347.57, 58071.98, 57347.57, 58050.13],
-      #     [1620619200000, 58213.93, 59005.01, 58213.93, 58909.0],
-      #     [1620633600000, 59577.8, 59577.8, 58849.82, 58849.82],
-      #     [1620648000000, 58495.02, 58495.02, 57878.12, 57878.12],
-      #     [1620662400000, 58239.57, 58239.57, 57237.93, 57237.93],
-      #     [1620676800000, 58114.79, 58114.79, 56850.29, 56850.29],
       #   ]
+      def ohlc(id, currency: 'usd', days: 7, **options)
+        get "coins/#{id}/ohlc", { vs_currency: currency, days: days, **options }
+      end
+
+      # @deprecated Use {#ohlc} instead
       def get_ohlc(id:, days:, currency: 'usd')
-        get "coins/#{id}/ohlc", { vs_currency: currency, days: days }
+        ohlc(id, currency: currency, days: days)
       end
 
       # Fetches the list of currencies currently supported by CoinGecko's API.
@@ -405,83 +270,29 @@ module CoingeckoRuby
       #
       # @example Fetch supported currencies.
       #   client.supported_currencies
-      # @example Response object
+      # @example Sample response object (truncated)
       #   [
       #     "btc",
       #     "eth",
-      #     "ltc",
-      #     "bch",
-      #     "bnb",
-      #     "eos",
-      #     "xrp",
-      #     "xlm",
-      #     "link",
-      #     "dot",
       #     "yfi",
       #     "usd",
-      #     "aed",
-      #     "ars",
       #     "aud",
-      #     "bdt",
-      #     "bhd",
-      #     "bmd",
-      #     "brl",
-      #     "cad",
-      #     "chf",
-      #     "clp",
-      #     "cny",
-      #     "czk",
-      #     "dkk",
       #     "eur",
       #     "gbp",
-      #     "hkd",
-      #     "huf",
-      #     "idr",
-      #     "ils",
-      #     "inr",
-      #     "jpy",
-      #     "krw",
-      #     "kwd",
-      #     "lkr",
-      #     "mmk",
-      #     "mxn",
-      #     "myr",
-      #     "ngn",
-      #     "nok",
-      #     "nzd",
-      #     "php",
-      #     "pkr",
-      #     "pln",
-      #     "rub",
-      #     "sar",
-      #     "sek",
-      #     "sgd",
-      #     "thb",
-      #     "try",
-      #     "twd",
-      #     "uah",
-      #     "vef",
-      #     "vnd",
-      #     "zar",
-      #     "xdr",
-      #     "xag",
-      #     "xau",
-      #     "bits",
-      #     "sats"
       #   ]
       def supported_currencies
-        get('simple/supported_vs_currencies')
+        get 'simple/supported_vs_currencies'
       end
 
       # Fetches the exchange rate for a coin or currency in the given coin or currency.
       # @param from [String] the coin id or currency to be converted.
-      # @param to [String] the coin id or currency to convert against.
+      # @param to [String] the coin id or currency to convert against. Defaults to 'USD'.
       #
       # @return [Hash] returns the coin's exchange rate against the given coin or currency.
       #
       # @example Fetch the exchange rate for BTC-USD.
-      #   client.get_exchange_rate(from: 'bitcoin', to: 'usd')
-      # @example Response object
+      #   client.exchange_rate(from: 'bitcoin', to: 'usd')
+      # @example Sample response object
       #   {
       #     "bitcoin" => {
       #       "usd" => 47931 # current price in given currency
@@ -489,14 +300,19 @@ module CoingeckoRuby
       #   }
       # @example Fetch the exchange rate for BTC-ETH.
       #   client.get_exchange_rate(from: 'bitcoin', to: 'eth')
-      # @example Response object
+      # @example Sample response object
       #   {
       #     "bitcoin" => {
       #       "eth" => 12.71434 # current price in given currency
       #     }
       #   }
+      def exchange_rate(from:, to: 'usd')
+        price(from, currency: to)
+      end
+
+      # @deprecated Use {#exchange_rate} instead
       def get_exchange_rate(from:, to: 'usd')
-        get_price(id: from, currency: to)
+        exchange_rate(from: from, to: to)
       end
     end
   end