stonk 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c8aaeb619986b3fff1bfa2de91c70796287bc96335c650a16b0ab98e9d9cbb9
-  data.tar.gz: 757458f818e7a2bb9b4b6465a36b3b96299bb8d502ebb9883d63372e7bc7efc3
+  metadata.gz: 6df13acd8e9222a9d5cf5c0b923e332d5e28d7aae5d9c620d986593aec063cff
+  data.tar.gz: 7e93cdb1b1b04bb62b1728f64c68d1425c412f3e5dd06c0c03dacb9467d68808
 SHA512:
-  metadata.gz: 10d76d734b74e04aa4e75d49a6ec9f64760ba70a15b494ddd26df0a9ada7707d4d2048d130bbb710154455ef70c5fb6ce72e58411d629c6db9fc350afd668251
-  data.tar.gz: a6866306f9d9c118c42ae331f2f74360751f56687c4508a0d411e2e575b6af9df6eb18e291754ed55a16c661ff24ebe9197f47e17b1cc0fc612428963800a8c0
+  metadata.gz: 744313febc98fa0c6acce5594df23fa44e8be7d49934e5f3f976cbc832de74f8c01eaea8740bc651947e919ebd652bb8006cf3cee7bdf037cebe42aa9fafc5ab
+  data.tar.gz: c38853fb6493a2e11b8a01034b3e66432311a3d5e71c58801c9346f663ce402c6dd8061e4b4bc74cf18348bff4c5c9aaa5a5e9bcc5b15d3297e7005f6ae2e4a5

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.1.0] - 2025-07-23
+
+### Data Sources
+- **CoinGecko adapter** - Cryptocurrency price data via CoinGecko API
+  - Support for .CRYPTO suffix format (e.g., BTC.CRYPTO)
+
 ## [1.0.0] - 2025-07-22
 
 ### Core Features

data/README.md

@@ -1,9 +1,10 @@
 # Stonk
 
-A Ruby gem for fetching real-time stock prices from multiple data sources with a unified interface. Stonk provides adapters for popular financial APIs and includes caching capabilities for improved performance.
+A Ruby gem for fetching real-time stock and cryptocurrency prices from multiple data sources with a unified interface. Stonk provides adapters for popular financial APIs and includes caching capabilities for improved performance.
 
 ## Features
 
+- **Multi-Asset Support**: Fetch both stock and cryptocurrency prices
 - **Caching**: Built-in file-based caching to reduce API calls
 - **Fallback Strategy**: Automatically tries multiple adapters if one fails
 - **Rate Limiting**: Built-in rate limit handling with retry logic
@@ -40,7 +41,8 @@ require 'stonk'
 cache_adapter = Stonk::Adapter::FileCacheAdapter.new('/tmp/stock_cache.json')
 service = Stonk::Service.new(
   lookup_adapters: [
-    Stonk::Adapter::AlphaVantageAdapter.new(ENV['ALPHA_VANTAGE_API_KEY'])
+    Stonk::Adapter::AlphaVantageAdapter.new(ENV['ALPHA_VANTAGE_API_KEY']),
+    Stonk::Adapter::CoinGeckoAdapter.new(ENV['COIN_GECKO_API_KEY']),
   ],
   cache_adapter:
 )
@@ -48,13 +50,17 @@ service = Stonk::Service.new(
 # Get stock price (automatically cached if cache_adapter is provided)
 price = service.get_stock_price('AAPL')
 puts "Apple stock price: $#{price}" if price
+
+# Get cryptocurrency price
+crypto_price = service.get_stock_price('BTC.CRYPTO')
+puts "Bitcoin price: $#{crypto_price}" if crypto_price
 ```
 
 ### Using Individual Adapters
 
 #### Alpha Vantage Adapter
 
-The Alpha Vantage adapter requires an API key from [Alpha Vantage](https://www.alphavantage.co/):
+The Alpha Vantage adapter requires an API key from [Alpha Vantage](https://www.alphavantage.co/) and provides stock data:
 
 ```ruby
 require 'stonk'
@@ -104,6 +110,30 @@ end
 cache_adapter.clear_cache
 ```
 
+#### CoinGecko Adapter
+
+The CoinGecko adapter provides cryptocurrency price data and supports the `.CRYPTO` suffix format:
+
+```ruby
+require 'stonk'
+
+# Create CoinGecko adapter
+coin_gecko_adapter = Stonk::Adapter::CoinGeckoAdapter.new
+
+# Get cryptocurrency price (use .CRYPTO suffix)
+begin
+  btc_price = coin_gecko_adapter.get_stock_price('BTC.CRYPTO')
+  puts "Bitcoin price: $#{btc_price}"
+  
+  eth_price = coin_gecko_adapter.get_stock_price('ETH.CRYPTO')
+  puts "Ethereum price: $#{eth_price}"
+rescue Stonk::Adapter::StockNotFound
+  puts "Cryptocurrency not found"
+rescue Stonk::Adapter::ServerError => e
+  puts "Server error: #{e.message}"
+end
+```
+
 ### Advanced Usage with Fallback Strategy
 
 ```ruby
@@ -112,6 +142,7 @@ require 'stonk'
 # Create adapters in order of preference
 cache_adapter = Stonk::Adapter::FileCacheAdapter.new('/tmp/stock_cache.json')
 alpha_adapter = Stonk::Adapter::AlphaVantageAdapter.new(ENV['ALPHA_VANTAGE_API_KEY'])
+coin_gecko_adapter = Stonk::Adapter::CoinGeckoAdapter.new
 alpha_adapter_with_retry = Stonk::Adapter::AlphaVantageAdapter.new(
   ENV['ALPHA_VANTAGE_API_KEY'],
   retry_on_rate_limit: true
@@ -120,8 +151,9 @@ alpha_adapter_with_retry = Stonk::Adapter::AlphaVantageAdapter.new(
 # Service will try lookup adapters in order until one succeeds, and cache results
 service = Stonk::Service.new(
   lookup_adapters: [
-    cache_adapter,           # Try looknig up in the cache first
-    alpha_adapter            # Then Alpha Vantage
+    cache_adapter,           # Try looking up in the cache first
+    alpha_adapter,           # Then Alpha Vantage for stocks
+    coin_gecko_adapter       # Then CoinGecko for cryptocurrencies
     alpha_adapter_with_retry # Then back to Alpha Vantage with a retry.
   ],
   cache_adapter:             # Cache successful results
@@ -130,6 +162,10 @@ service = Stonk::Service.new(
 # Get stock price (will try each lookup adapter until one returns a price, then cache the result)
 price = service.get_stock_price('AAPL')
 puts "Apple stock price: $#{price}" if price
+
+# Get cryptocurrency price (will use CoinGecko adapter)
+crypto_price = service.get_stock_price('BTC.CRYPTO')
+puts "Bitcoin price: $#{crypto_price}" if crypto_price
 ```
 
 ### Working with Money Objects
@@ -139,8 +175,8 @@ Stock prices are returned as `Stonk::Money` objects, which are based on `BigDeci
 ```ruby
 require 'stonk'
 
-yahoo_adapter = Stonk::Adapter::YahooFinanceAdapter.new
-price = yahoo_adapter.get_stock_price('AAPL')
+alpha_adapter = Stonk::Adapter::AlphaVantageAdapter.new(ENV['ALPHA_VANTAGE_API_KEY'])
+price = alpha_adapter.get_stock_price('AAPL')
 
 # Money objects support arithmetic operations
 puts "Price: $#{price}"
@@ -159,7 +195,7 @@ require 'stonk'
 
 service = Stonk::Service.new(
   lookup_adapters: [
-    Stonk::Adapter::YahooFinanceAdapter.new
+    Stonk::Adapter::AlphaVantageAdapter.new(ENV['ALPHA_VANTAGE_API_KEY'])
   ]
 )
 

data/Rakefile

@@ -8,6 +8,12 @@ RuboCop::RakeTask.new
 
 Minitest::TestTask.create do |t|
   t.warning = false
+  t.test_prelude = <<~RUBY if ENV["COVERAGE"]
+    require "simplecov"
+    SimpleCov.start do
+      add_filter %r{^/test/}
+    end
+  RUBY
 end
 
 task default: :test

data/bin/stonk

@@ -15,7 +15,9 @@ def setup_service(use_cache:)
     retry_on_rate_limit: true,
   )
 
-  lookup_adapters = [alpha_adapter, alpha_adapter_with_retry]
+  coin_gecko_adapter = Stonk::Adapter::CoinGeckoAdapter.new(ENV["COIN_GECKO_API_KEY"])
+
+  lookup_adapters = [alpha_adapter, coin_gecko_adapter, alpha_adapter_with_retry]
 
   lookup_adapters.unshift(cache_adapter) if use_cache
 

data/lib/stonk/adapter/coin_gecko_adapter.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Stonk
+  module Adapter
+    class CoinGeckoAdapter
+      def initialize(api_key)
+        @api_key = api_key
+      end
+
+      def get_stock_price(stock_symbol)
+        raise Stonk::Adapter::StockNotFound unless stock_symbol.end_with?(".CRYPTO")
+
+        coin = stock_symbol.gsub(".CRYPTO", "")
+
+        make_request(coin).then do |response|
+          raise Stonk::Adapter::StockNotFound if response.empty?
+
+          Stonk::Money.new(response.first.dig("current_price"))
+        end
+      end
+
+      private
+
+      def make_request(coin)
+        url = URI("https://api.coingecko.com/api/v3/coins/markets?vs_currency=USD&symbols=" + coin)
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Get.new(url)
+        request["accept"] = "application/json"
+        request["x-cg-demo-api-key"] = @api_key
+
+        response = http.request(request)
+
+        if response.is_a?(Net::HTTPSuccess)
+          JSON.parse(response.body)
+        elsif response.is_a?(Net::HTTPTooManyRequests)
+          raise Stonk::Adapter::RateLimitExceeded, "Too many requests"
+        else
+          raise Stonk::Adapter::ServerError, "Failed to fetch price for #{coin}: #{response.body}"
+        end
+      end
+    end
+  end
+end

data/lib/stonk/adapter.rb

@@ -11,7 +11,7 @@ module Stonk
     class ServerError < AdapterError; end
 
     autoload :AlphaVantageAdapter, "stonk/adapter/alpha_vantage_adapter"
+    autoload :CoinGeckoAdapter, "stonk/adapter/coin_gecko_adapter"
     autoload :FileCacheAdapter, "stonk/adapter/file_cache_adapter"
-    autoload :YahooFinanceAdapter, "stonk/adapter/yahoo_finance_adapter"
   end
 end

data/lib/stonk/money.rb

@@ -6,7 +6,7 @@ require "delegate"
 module Stonk
   class Money < SimpleDelegator
     def initialize(amount)
-      super(BigDecimal(amount))
+      super(BigDecimal(amount, Float::DIG + 1))
     end
   end
 end

data/lib/stonk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stonk
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stonk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Nick Jones
@@ -68,6 +68,7 @@ files:
 - lib/stonk.rb
 - lib/stonk/adapter.rb
 - lib/stonk/adapter/alpha_vantage_adapter.rb
+- lib/stonk/adapter/coin_gecko_adapter.rb
 - lib/stonk/adapter/file_cache_adapter.rb
 - lib/stonk/money.rb
 - lib/stonk/service.rb
@@ -96,5 +97,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.7
 specification_version: 4
-summary: A Ruby gem that fetches real-time stock prices from multiple sources.
+summary: A Ruby gem that fetches real-time stock and cryptocurrency prices from multiple
+  sources.
 test_files: []