coinmarketcap.rb 0.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9418640a33531147099044276f4ae89f219e52f97def35df2581d85eb61f59b7
+  data.tar.gz: 565de31e863b431b9d772e7ded94cfffd0d607fa5829018600947b7cf7837ca1
+SHA512:
+  metadata.gz: 5315e3dd994ef654670772cdff4efecc7d8a992489720497b17f18223fdb7008de1127315d1f4c405d0fd656b7bd08aa593ba2a56029e98e463180a81c5e4758
+  data.tar.gz: 4e575c130f2aa09d041a0ae5183a02a617958064841d87016e028960179df70af07455859d6c1f8840e8b5960ec4f32df41fccc48e804d016daf7b391817c7aa

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gem 'http.rb'
+
+group :development, :test do
+  gem 'minitest'
+  gem 'minitest-spec-context'
+  gem 'vcr'
+end

data/README.md

@@ -0,0 +1,104 @@
+# coinmarketcap.rb
+
+## Description
+
+Access the coinmarketcap.com API with Ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+```ruby
+  gem 'coinmarketcap.rb'
+```
+And then execute:
+```bash
+  $ bundle
+```
+Or install it yourself as:
+```bash
+  $ gem install coinmarketcap.rb
+```
+
+## Notes
+
+This gem attempts to make sense of a CoinMarketCap's somewhat confused APIs and so far only partially covers off V1 and V2 APIs. It makes sense of the V1 and V2 APIs by creating a mezzanine, API version agnostic client which will use V1 or V2 endpoints/sub-clients selectively depending on which retrieves the requested information whilst giving a cleaner and more consistent overall interface. It is likely that further abstraction/simplification of the APIs is possible, further improving the usability.
+
+## Usage
+
+### Setup
+```ruby
+api_key = 'api_key0'
+coinmarketcap_client ||= CoinMarketCap::Client.new(api_key: api_key)
+```
+
+### Airdrops
+```ruby
+coinmarketcap_client.airdrops
+coinmarketcap_client.airdrops(id: 123)
+```
+
+### Categories
+```ruby
+coinmarketcap_client.categories
+coinmarketcap_client.categories(id: 123)
+```
+
+### Gainers and Losers
+```ruby
+coinmarketcap_client.gainers_and_losers
+```
+
+### Historical Price Data (OHLCV)
+```ruby
+coinmarketcap_client.historical_price_data(id: 123)
+```
+
+### Historical Quotes
+```ruby
+coinmarketcap_client.historical_quotes
+coinmarketcap_client.historical_quotes(id: 123)
+```
+
+### Info for a Specific Coin
+```ruby
+coinmarketcap_client.info(id: 123)
+```
+
+### Latest Coin Pairs Listed
+```ruby
+coinmarketcap_client.latest_listings
+```
+
+### Latest OHLCV Price Data
+```ruby
+coinmarketcap_client.latest_price_data
+```
+
+### Latest Performance Stats
+```ruby
+coinmarketcap_client.latest_price_performance_stats
+```
+
+### Latest Quotes
+```ruby
+coinmarketcap_client.latest_quotes
+coinmarketcap_client.latest_quotes(id: 123)
+```
+
+### Most Visited Coins
+```ruby
+coinmarketcap_client.most_visited
+```
+
+### Trending Coins
+```ruby
+coinmarketcap_client.trending
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/thoran/eodhd.rb/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new pull request

data/coinmarketcap.rb.gemspec

@@ -0,0 +1,28 @@
+require_relative './lib/CoinMarketCap/VERSION'
+
+Gem::Specification.new do |spec|
+  spec.name = 'coinmarketcap.rb'
+
+  spec.version = CoinMarketCap::VERSION
+  spec.date = '2025-03-30'
+
+  spec.summary = "Access the coinmarketcap.com API with Ruby."
+  spec.description = "Access the coinmarketcap.com API with Ruby."
+
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'http://github.com/thoran/coinmarketcap.rb'
+  spec.license = 'Ruby'
+
+  spec.required_ruby_version = '>= 2.7'
+
+  spec.add_dependency('http.rb')
+  spec.files = [
+    'coinmarketcap.rb.gemspec',
+    'Gemfile',
+    Dir['lib/**/*.rb'],
+    'README.md',
+    Dir['test/**/*.rb']
+  ].flatten
+  spec.require_paths = ['lib']
+end

data/lib/CoinMarketCap/Client.rb

@@ -0,0 +1,92 @@
+# CoinMarketCap/Client.rb
+# CoinMarketCap::Client
+
+require_relative './V1/Client'
+require_relative './V2/Client'
+
+module CoinMarketCap
+  class Client
+    def airdrops(id: nil)
+      if id
+        v1_client.airdrop(id: id)
+      else
+        v1_client.airdrops
+      end
+    end
+
+    def categories(id: nil)
+      if id
+        v1_client.category(id: id)
+      else
+        v1_client.categories
+      end
+    end
+
+    def gainers_and_losers
+      v1_client.trending_gainers_losers
+    end
+
+    def historical_price_data(id:)
+      v2_client.ohlcv_historical(id: id)
+    end
+
+    # I don't see the point of these endpoints at all. (Ha ha!) Either you want current prices or you want historical OHLCV. I don't see why having historical quotes is of any value.
+    def historical_quotes(id: nil)
+      if id
+        v2_client.quotes_historical(id: id)
+      else
+        v1_client.listings_historical
+      end
+    end
+
+    def info(id:)
+      v2_client.info(id: id)
+    end
+
+    def map
+      v1_client.map
+    end
+
+    def latest_listings
+      v2_client.market_pairs_latest
+    end
+
+    def latest_price_data
+      v2_client.ohlcv_latest
+    end
+
+    def most_visited
+      v1_client.trending_most_visited
+    end
+
+    def latest_price_performance_stats
+      v2_client.price_performance_stats_latest
+    end
+
+    def latest_quotes(id: nil)
+      if id
+        v2_client.quotes_latest(id: id)
+      else
+        v1_client.listings_latest
+      end
+    end
+
+    def trending
+      v1_client.trending_latest
+    end
+
+    private
+
+    def initialize(api_key:)
+      @api_key = api_key
+    end
+
+    def v1_client
+      @v1_client ||= CoinMarketCap::V1::Client.new(api_key: @api_key)
+    end
+
+    def v2_client
+      @v2_client ||= CoinMarketCap::V2::Client.new(api_key: @api_key)
+    end
+  end
+end

data/lib/CoinMarketCap/Common.rb

@@ -0,0 +1,61 @@
+# CoinMarketCap/Common.rb
+# CoinMarketCap::Common
+
+module CoinMarketCap
+  class Error < RuntimeError
+    attr_reader :code, :message, :body
+
+    private
+
+    def initialize(code:, message:, body:)
+      @code = code
+      @message = message
+      @body = body
+    end
+  end
+
+  module Common
+    API_HOST = 'pro-api.coinmarketcap.com'
+
+    private
+
+    def initialize(api_key:)
+      @api_key = api_key
+    end
+
+    def request_string(path)
+      "https://#{API_HOST}#{self.class.path_prefix}#{path}"
+    end
+
+    def headers
+      {
+        'Accept' => 'application/json',
+        'X-CMC_PRO_API_KEY' => @api_key,
+      }
+    end
+
+    def do_request(verb:, path:, args: {})
+      HTTP.send(verb.to_s.downcase, request_string(path), args, headers)
+    end
+
+    def get(path:, args: {})
+      do_request(verb: 'GET', path: path, args: args)
+    end
+
+    def post(path:, args: {})
+      do_request(verb: 'POST', path: path, args: args)
+    end
+
+    def handle_response(response)
+      if response.success?
+        JSON.parse(response.body)
+      else
+        raise CoinMarketCap::Error.new(
+          code: response.code,
+          message: response.message,
+          body: response.body,
+        )
+      end
+    end
+  end
+end

data/lib/CoinMarketCap/V1/Client.rb

@@ -0,0 +1,84 @@
+# CoinMarketCap/V1/Client.rb
+# CoinMarketCap::V1::Client
+
+# Notes:
+# 1. From https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency
+# /v1/cryptocurrency/airdrop - Airdrop
+# /v1/cryptocurrency/airdrops - Airdrops
+# /v1/cryptocurrency/categories - Categories
+# /v1/cryptocurrency/category - Category
+# /v1/cryptocurrency/listings/historical - Historical listings
+# /v1/cryptocurrency/listings/latest - Latest listings
+# /v1/cryptocurrency/map - CoinMarketCap ID map
+# /v1/cryptocurrency/trending/gainers-losers - Trending Gainers & Losers
+# /v1/cryptocurrency/trending/latest - Trending Latest
+# /v1/cryptocurrency/trending/most-visited - Trending Most Visited
+
+gem 'http.rb'
+require 'http.rb'
+require 'json'
+require_relative '../Common'
+
+module CoinMarketCap
+  module V1
+    class Client
+      include Common
+
+      class << self
+        def path_prefix
+          '/v1/cryptocurrency'
+        end
+      end # class << self
+
+      def airdrop(id:)
+        response = get(path: '/airdrop', args: {id: id})
+        handle_response(response)
+      end
+
+      def airdrops
+        response = get(path: '/airdrops')
+        handle_response(response)
+      end
+
+      def categories
+        response = get(path: '/categories')
+        handle_response(response)
+      end
+
+      def category(id:)
+        response = get(path: '/category', args: {id: id})
+        handle_response(response)
+      end
+
+      def listings_historical
+        response = get(path: '/listings/historical')
+        handle_response(response)
+      end
+
+      def listings_latest
+        response = get(path: '/listings/latest')
+        handle_response(response)
+      end
+
+      def map
+        response = get(path: '/map')
+        handle_response(response)
+      end
+
+      def trending_gainers_losers
+        response = get(path: '/trending/gainers-losers')
+        handle_response(response)
+      end
+
+      def trending_latest
+        response = get(path: '/trending/latest')
+        handle_response(response)
+      end
+
+      def trending_most_visited
+        response = get(path: '/trending/most-visited')
+        handle_response(response)
+      end
+    end
+  end
+end

data/lib/CoinMarketCap/V2/Client.rb

@@ -0,0 +1,67 @@
+# CoinMarketCap/V2/Client.rb
+# CoinMarketCap::V2::Client
+
+# Notes:
+# 1. From https://coinmarketcap.com/api/documentation/v1/#tag/cryptocurrency
+# /v2/cryptocurrency/info - Metadata
+# /v2/cryptocurrency/market-pairs/latest - Latest market pairs
+# /v2/cryptocurrency/ohlcv/historical - Historical OHLCV
+# /v2/cryptocurrency/ohlcv/latest - Latest OHLCV
+# /v2/cryptocurrency/price-performance-stats/latest - Price performance Stats
+# /v2/cryptocurrency/quotes/historical - Historical quotes
+# /v2/cryptocurrency/quotes/latest - Latest quotes
+
+gem 'http.rb'
+require 'http.rb'
+require 'json'
+require_relative '../Common'
+
+module CoinMarketCap
+  module V2
+    class Client
+      include Common
+
+      class << self
+        def path_prefix
+          '/v2/cryptocurrency'
+        end
+      end # class << self
+
+      def info(id:)
+        response = get(path: '/info', args: {id: id})
+        handle_response(response)
+      end
+
+      def market_pairs_latest
+        response = get(path: '/market-pairs/latest')
+        handle_response(response)
+      end
+
+      def ohlcv_historical(id:)
+        response = get(path: '/ohlcv/historical', args: {id: id})
+        handle_response(response)
+      end
+
+      def ohlcv_latest
+        response = get(path: '/ohlcv/latest')
+        handle_response(response)
+      end
+
+      def price_performance_stats_latest
+        response = get(path: '/price-performance-stats/latest')
+        handle_response(response)
+      end
+
+      def quotes_historical(id:)
+        response = get(path: '/quotes/historical', args: {id: id})
+        handle_response(response)
+      end
+
+      def quotes_latest(id:)
+        id = [id].compact.join(',')
+        response = get(path: '/quotes/latest', args: {id: id})
+        handle_response(response)
+      end
+    end
+  end
+end

data/lib/CoinMarketCap/VERSION.rb

@@ -0,0 +1,6 @@
+# CoinMarketCap/VERSION.rb
+# CoinMarketCap::VERSION
+
+module CoinMarketCap
+  VERSION = '0.3.1'
+end

data/lib/CoinMarketCap.rb

@@ -0,0 +1,4 @@
+# CoinMarketCap.rb
+# CoinMarketCap
+
+require_relative './CoinMarketCap/Client'

data/test/V1/client_test.rb

@@ -0,0 +1,141 @@
+require_relative '../helper'
+require_relative '../../lib/CoinMarketCap/V1/Client'
+
+describe CoinMarketCap::V1::Client do
+  let(:client) {CoinMarketCap::V1::Client.new(api_key: api_key)}
+
+  describe "#airdrop" do
+    it "returns AN airdrop" do
+      VCR.use_cassette('v1/cryptocurrency/airdrop') do
+        assert_raises CoinMarketCap::Error do
+          response = client.airdrop(id: 1)
+          # Too poor to subscribe...
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#airdrops" do
+    it "returns ALL airdrops" do
+      VCR.use_cassette('v1/cryptocurrency/airdrops') do
+        assert_raises CoinMarketCap::Error do
+          response = client.airdrops
+          # Still too poor to subscribe...
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#categories" do
+    it "returns ALL categories" do
+      VCR.use_cassette('v1/cryptocurrency/categories') do
+        assert_raises CoinMarketCap::Error do
+          response = client.categories
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#category" do
+    it "returns a specific category" do
+      VCR.use_cassette('v1/cryptocurrency/category') do
+        assert_raises CoinMarketCap::Error do
+          response = client.category(id: 1)
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#listings_historical" do
+    it "returns historical listings for all cryptos" do
+      VCR.use_cassette('v1/cryptocurrency/listings/historical') do
+        assert_raises CoinMarketCap::Error do
+          response = client.listings_historical
+          _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#listings_latest" do
+    it "returns an array of latest prices" do
+      VCR.use_cassette('v1/cryptocurrency/listings/latest') do
+        response = client.listings_latest
+        _(response).must_include('data')
+        _(response['data']).must_be_kind_of(Array)
+        _(response['data'][0]).must_be_kind_of(Hash)
+      end
+    end
+  end
+
+  describe "#map" do
+    it "returns a map of crypto IDs to symbols" do
+      VCR.use_cassette('v1/cryptocurrency/map') do
+        response = client.map
+        _(response).must_include('data')
+        _(response['data'].first['symbol']).must_equal 'BTC'
+      end
+    end
+  end
+
+  describe "#trending_gainers_losers" do
+    it "returns trending gainers and losers" do
+      VCR.use_cassette('v1/cryptocurrency/trending/gainers-losers') do
+        assert_raises CoinMarketCap::Error do
+          response = client.trending_gainers_losers
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#trending_latest" do
+    it "returns trending latest" do
+      VCR.use_cassette('v1/cryptocurrency/trending/latest') do
+        assert_raises CoinMarketCap::Error do
+          response = client.trending_latest
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#trending_most_visited" do
+    it "returns trending most visited" do
+      VCR.use_cassette('v1/cryptocurrency/trending/most-visited') do
+        assert_raises CoinMarketCap::Error do
+          response = client.trending_most_visited
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#handle_response" do
+    it "handles a successful response" do
+      raw_response = OpenStruct.new(success?: true, body: '{"data": {}}')
+      response = client.send(:handle_response, raw_response)
+      _(response).must_include('data')
+      _(response).must_be_kind_of(Hash)
+    end
+
+    it "raises an error for a failed response" do
+      raw_response = OpenStruct.new(success?: false, code: 404, message: 'Not Found')
+      assert_raises RuntimeError do
+        client.send(:handle_response, raw_response)
+      end
+    end
+  end
+end

data/test/V2/client_test.rb

@@ -0,0 +1,111 @@
+require_relative '../helper'
+require_relative '../../lib/CoinMarketCap/V2/Client'
+
+describe CoinMarketCap::V2::Client do
+  let(:client) {CoinMarketCap::V2::Client.new(api_key: api_key)}
+
+  describe "#info" do
+    it "retrieves metadata for a specific cryptocurrency" do
+      VCR.use_cassette('v2/cryptocurrency/info') do
+        response = client.info(id: 1)
+        _(response).must_include('data')
+        _(response.dig('data', '1', 'symbol')).must_equal 'BTC'
+      end
+    end
+  end
+
+  describe "#market_pairs_latest" do
+    it "retrieves the latest market pairs" do
+      VCR.use_cassette('v2/cryptocurrency/market-pairs/latest') do
+        assert_raises CoinMarketCap::Error do
+          response = client.market_pairs_latest
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#ohlcv_historical" do
+    it "retrieves historical OHLCV data" do
+      VCR.use_cassette('v2/cryptocurrency/ohlcv/historical') do
+        assert_raises CoinMarketCap::Error do
+          response = client.ohlcv_historical(id: 1)
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#ohlcv_latest" do
+    it "returns the latest OHLCV data" do
+      VCR.use_cassette('v2/cryptocurrency/ohlcv/latest') do
+        assert_raises CoinMarketCap::Error do
+          response = client.ohlcv_latest
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#price_performance_stats_latest" do
+    it "retrieves the latest price performance statistics" do
+      VCR.use_cassette('v2/cryptocurrency/price-performance-stats/latest') do
+        assert_raises CoinMarketCap::Error do
+          response = client.price_performance_stats_latest
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#quotes_historical" do
+    it "returns historical quotes" do
+      VCR.use_cassette('v2/cryptocurrency/quotes/historical') do
+        assert_raises CoinMarketCap::Error do
+          response = client.quotes_historical(id: 1)
+          # _(response).must_include('data')
+          _(JSON.parse(response.body).dig('status', 'error_message')).must_equal "Your API Key subscription plan doesn't support this endpoint."
+        end
+      end
+    end
+  end
+
+  describe "#quotes_latest" do
+    it "retrieves the latest quotes for a specific cryptocurrency" do
+      VCR.use_cassette('v2/cryptocurrency/quotes/latest') do
+        response = client.quotes_latest(id: 1)
+        _(response).must_include('data')
+        _(response['data']).must_be_kind_of(Hash)
+
+      end
+    end
+
+    it "retrieves quotes for multiple IDs" do
+      VCR.use_cassette('v2/cryptocurrency/quotes/latest_with_multiple_ids') do
+        response = client.quotes_latest(id: [1, 2])
+        _(response).must_include("data")
+        _(response["data"]).must_be_kind_of(Hash)
+      end
+    end
+  end
+
+  describe "#handle_response" do
+    it "handles a successful response" do
+      raw_response = OpenStruct.new(success?: true, body: '{"data": {}}')
+      response = client.send(:handle_response, raw_response)
+      _(response).must_include('data')
+      _(response).must_be_kind_of(Hash)
+    end
+
+    it "raises an error for a failed response" do
+      response = OpenStruct.new(success?: false, code: 404, message: 'Not Found')
+      assert_raises RuntimeError do
+        client.send(:handle_response, response)
+      end
+    end
+  end
+end

data/test/client_test.rb

@@ -0,0 +1,213 @@
+require_relative './helper'
+require_relative '../lib/CoinMarketCap/Client'
+
+describe CoinMarketCap::Client do
+  let(:client){CoinMarketCap::Client.new(api_key: api_key)}
+
+  describe "#airdrops" do
+    context "when an id IS provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect(:airdrop, {'data' => []}) do |kwargs|
+          kwargs[:id] == 1
+        end
+        client.stub :v1_client, mocked_client do
+          client.airdrops(id: 1)
+        end
+        mocked_client.verify
+      end
+    end
+
+    context "when an id is NOT provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect :airdrops, true, []
+        client.stub :v1_client, mocked_client do
+          client.airdrops
+        end
+        mocked_client.verify
+      end
+    end
+  end
+
+  describe "#categories" do
+    context "when an id IS provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect(:category, {'data' => []}) do |kwargs|
+          kwargs[:id] == 1
+        end
+        client.stub :v1_client, mocked_client do
+          client.categories(id: 1)
+        end
+        mocked_client.verify
+      end
+    end
+
+    context "when an id is NOT provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect :categories, true, []
+        client.stub :v1_client, mocked_client do
+          client.categories
+        end
+        mocked_client.verify
+      end
+    end
+  end
+
+  describe "#gainers_and_losers" do
+    it "calls the V1 client trending_gainers_losers method" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect :trending_gainers_losers, true, []
+      client.stub :v1_client, mocked_client do
+        client.gainers_and_losers
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#historical_price_data" do
+    it "calls the V2 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:ohlcv_historical, {'data' => []}) do |kwargs|
+        kwargs[:id] == 1
+      end
+      client.stub :v2_client, mocked_client do
+        client.historical_price_data(id: 1)
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#historical_quotes" do
+    context "when an ID IS provided" do
+      it "calls the V2 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect(:quotes_historical, {'data' => []}) do |kwargs|
+          kwargs[:id] == 1
+        end
+        client.stub :v2_client, mocked_client do
+          client.historical_quotes(id: 1)
+        end
+        mocked_client.verify
+      end
+    end
+
+    context "when no ID is provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect :listings_historical, {"data" => {}}, []
+        client.stub :v1_client, mocked_client do
+          client.historical_quotes
+        end
+        mocked_client.verify
+      end
+    end
+  end
+
+  describe "#info" do
+    it "calls the V2 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:info, {'data' => []}) do |kwargs|
+        kwargs[:id] == 1
+      end
+      client.stub :v2_client, mocked_client do
+        client.info(id: 1)
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#map" do
+    it "calls the V1 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:map, {'data' => []})
+      client.stub :v1_client, mocked_client do
+        client.map
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#latest_listings" do
+    it "calls the V2 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:market_pairs_latest, true, [])
+      client.stub :v2_client, mocked_client do
+        client.latest_listings
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#latest_price_data" do
+    it "calls the V2 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:ohlcv_latest, true, [])
+      client.stub :v2_client, mocked_client do
+        client.latest_price_data
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#latest_price_performance_stats" do
+    it "calls the V2 client" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect(:price_performance_stats_latest, true, [])
+      client.stub :v2_client, mocked_client do
+        client.latest_price_performance_stats
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#latest_quotes" do
+    context "when an ID IS provided" do
+      it "calls the V2 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect(:quotes_latest, {'data' => []}) do |kwargs|
+          kwargs[:id] == 1
+        end
+        client.stub :v2_client, mocked_client do
+          client.latest_quotes(id: 1)
+        end
+        mocked_client.verify
+      end
+    end
+
+    context "when an ID is NOT provided" do
+      it "calls the V1 client" do
+        mocked_client = Minitest::Mock.new
+        mocked_client.expect(:listings_latest, true, [])
+        client.stub :v1_client, mocked_client do
+          client.latest_quotes
+        end
+        mocked_client.verify
+      end
+    end
+  end
+
+  describe "#most_visited" do
+    it "calls the V1 client trending_most_visited method" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect :trending_most_visited, true, []
+      client.stub :v1_client, mocked_client do
+        client.most_visited
+      end
+      mocked_client.verify
+    end
+  end
+
+  describe "#trending" do
+    it "calls the V1 client trending_latest method" do
+      mocked_client = Minitest::Mock.new
+      mocked_client.expect :trending_latest, true, []
+      client.stub :v1_client, mocked_client do
+        client.trending
+      end
+      mocked_client.verify
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'minitest/autorun'
+require 'minitest-spec-context'
+require 'minitest/spec'
+require 'ostruct'
+require 'vcr'
+
+VCR.configure do |config|
+  config.cassette_library_dir = File.expand_path('../fixtures/vcr_cassettes', __FILE__)
+  config.hook_into :webmock
+end
+
+def api_key
+  if ENV['COINMARKETCAP_API_KEY']
+    ENV['COINMARKETCAP_API_KEY']
+  else
+    'api_key0'
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: coinmarketcap.rb
+version: !ruby/object:Gem::Version
+  version: 0.3.1
+platform: ruby
+authors:
+- thoran
+bindir: bin
+cert_chain: []
+date: 2025-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Access the coinmarketcap.com API with Ruby.
+email: code@thoran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- coinmarketcap.rb.gemspec
+- lib/CoinMarketCap.rb
+- lib/CoinMarketCap/Client.rb
+- lib/CoinMarketCap/Common.rb
+- lib/CoinMarketCap/V1/Client.rb
+- lib/CoinMarketCap/V2/Client.rb
+- lib/CoinMarketCap/VERSION.rb
+- test/V1/client_test.rb
+- test/V2/client_test.rb
+- test/client_test.rb
+- test/helper.rb
+homepage: http://github.com/thoran/coinmarketcap.rb
+licenses:
+- Ruby
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.6
+specification_version: 4
+summary: Access the coinmarketcap.com API with Ruby.
+test_files: []