yahoo_finance_client 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 396333c73bb2a3098fb03607b6c9f4ac31d6ad2fee6abc425ebacae6a3329ec2
-  data.tar.gz: 852fe8f267af779dd3d4beda42f8bc488b09aca401c98fa784351846dad7cb19
+  metadata.gz: 1a66e077f86f9aaaf9fe6017760905c53641a89c58535ee8e0308492f826e74a
+  data.tar.gz: 5ccca2925b92065e274b1747014f6b7b79e464f079ffb57b941839739b7f196c
 SHA512:
-  metadata.gz: 14e2e611856c718242e81eab276c2a988f5ea98e26ca57b3a951104785b96787e023a38c786b88dd198482a97901220a93e3070c783a1ffc71e1a3bcd82cc8c6
-  data.tar.gz: cd126e9ac493657f40ecd7429706d40ee954db197be71bdb37f5f93083d766763db7aa2bb24971aa2fcfa352df60a2e13b87421094f9208949bbeb3a36b43f79
+  metadata.gz: c979f457c9a49ed6487d2046d0aad76a7d36989dab90899319c297530e9778a8c37a6628ac21f4ef3785d4a08722bff88222873495487327e7f23897376012a7
+  data.tar.gz: dd999d278080461b7837a16a93c9344a1c079eebbf6541d78bf2e07cfc950fed9d60505dda9c4ef22a72cb0fdf52f51e241f0dc7662aacb7ea069f3bb774af1d

data/.rubocop.yml

@@ -11,7 +11,7 @@ Metrics/AbcSize:
   Max: 25
 
 Metrics/ClassLength:
-  Max: 310
+  Max: 350
 
 Metrics/MethodLength:
   Max: 11

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## [0.8.0] - 2026-05-17
+
+- Add `Stock.get_quote_summary(symbol)` returning `{ sector:, industry: }` via Yahoo's `v10/finance/quoteSummary?modules=assetProfile` endpoint. Returns `nil` for funds, ETFs, or any symbol where the asset profile is empty. Same cookie + crumb auth as the existing quote calls.
+
 ## [0.7.0] - 2026-05-16
 
 - Add `Stock.get_fx_rate(from, to)` returning the current FX rate between two ISO 4217 currency codes via Yahoo's `<FROM><TO>=X` quote symbol. Returns `1.0` for identity pairs without hitting the API; returns `nil` on error.

data/README.md

@@ -84,6 +84,16 @@ YahooFinanceClient::Stock.get_fx_rate("EUR", "USD")
 
 Identity pairs short-circuit to `1.0` without hitting the API. Returns `nil` on any upstream error.
 
+### Sector / Industry
+
+Fetch the sector and industry for a ticker via Yahoo's `quoteSummary` endpoint:
+```ruby
+YahooFinanceClient::Stock.get_quote_summary("AAPL")
+# => { sector: "Technology", industry: "Consumer Electronics" }
+```
+
+Returns `nil` for funds, ETFs, or any symbol whose `assetProfile` is empty. Sector data changes rarely — cache aggressively on the caller side.
+
 ### Dividend History
 
 Fetch historical dividend payments via the chart API:

data/lib/yahoo_finance_client/stock.rb

@@ -10,6 +10,7 @@ module YahooFinanceClient
     QUOTE_PATH = "/v7/finance/quote"
     CHART_PATH = "/v8/finance/chart"
     SEARCH_PATH = "/v1/finance/search"
+    QUOTE_SUMMARY_PATH = "/v10/finance/quoteSummary"
     SEARCH_BASE_URL = "https://query1.finance.yahoo.com"
     CACHE_TTL = 300
     MAX_RETRIES = 2
@@ -50,6 +51,17 @@ module YahooFinanceClient
         fetch_from_cache(cache_key) || fetch_and_cache_fx_rate(cache_key, from, to)
       end
 
+      # Fetch the sector and industry for a single ticker via Yahoo's
+      # quoteSummary endpoint (`assetProfile` module). Returns nil for funds,
+      # ETFs, or any symbol where Yahoo doesn't expose an asset profile.
+      #
+      # @param symbol [String] stock ticker
+      # @return [Hash{Symbol => String}, nil] { sector:, industry: } or nil
+      def get_quote_summary(symbol)
+        cache_key = "quote_summary_#{symbol}"
+        fetch_from_cache(cache_key) || fetch_and_cache_quote_summary(cache_key, symbol)
+      end
+
       # Search the Yahoo Finance autocomplete index for matching symbols.
       #
       # @param query [String] free-text query (ticker or company name)
@@ -235,6 +247,45 @@ module YahooFinanceClient
         nil
       end
 
+      def fetch_and_cache_quote_summary(cache_key, symbol)
+        profile = fetch_quote_summary_data(symbol)
+        store_in_cache(cache_key, profile) if profile
+        profile
+      end
+
+      def fetch_quote_summary_data(symbol)
+        retries = 0
+        begin
+          parse_quote_summary_response(make_quote_summary_request(symbol))
+        rescue AuthenticationError
+          retries += 1
+          retry if retries <= MAX_RETRIES
+          nil
+        end
+      end
+
+      def make_quote_summary_request(symbol)
+        session = Session.instance
+        session.ensure_authenticated
+        url = "#{session.base_url}#{QUOTE_SUMMARY_PATH}/#{symbol}?modules=assetProfile&crumb=#{session.crumb}"
+        HTTParty.get(url, headers: { "User-Agent" => Session::USER_AGENT, "Cookie" => session.cookie })
+      end
+
+      def parse_quote_summary_response(response)
+        if auth_error?(response)
+          Session.instance.invalidate!
+          raise AuthenticationError, "Authentication failed"
+        end
+        return nil unless response.success?
+
+        profile = JSON.parse(response.body).dig("quoteSummary", "result", 0, "assetProfile")
+        return nil if profile.nil? || profile["sector"].to_s.empty?
+
+        { sector: profile["sector"], industry: profile["industry"] }
+      rescue JSON::ParserError
+        nil
+      end
+
       def fetch_and_cache_dividend_history(cache_key, symbol, range)
         data = fetch_dividend_history_data(symbol, range)
         store_in_cache(cache_key, data) unless data.empty?

data/lib/yahoo_finance_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module YahooFinanceClient
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: yahoo_finance_client
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Francesc Leveque
 bindir: exe
 cert_chain: []
-date: 2026-05-16 00:00:00.000000000 Z
+date: 2026-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csv