eodhd 0.19.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cf8b67ed05dcf07f838df21a530d42c07824fd548ce5956f0425356c6e20ab9b
+  data.tar.gz: 107375d103ae2afebd038183c256c7c4d387d47287bbcf524ef5afe058c0de24
+SHA512:
+  metadata.gz: e84643904cbe85f5d7b67961927b071e9966020677f6c48bd3c5070e4e47bcd90c18ac72cb1ed9f0d5c6158978624109136a2a3935a2373c2f8208862ee05980
+  data.tar.gz: 2a6f1e38654db71f172aa88e40ef96e3e55a3f98762930648c0b24986c6f0714cb480503386920c31eb3ee7a3d5c018fefb95b9fb15307806aa11f0bc79a10e4

data/CHANGELOG

@@ -0,0 +1,195 @@
+# CHANGELOG
+
+## 20260915
+
+0.19.5: + eodhd.gemspec, so that the gem resolves under both names.
+
+1. + eodhd.gemspec: eodhd.rb.gemspec with /eodhd.rb/eodhd/ in spec.name and in spec.files, upon measurand 0.1.4's pattern.
+2. ~ Gemfile: /gemspec/gemspec name: 'eodhd.rb'/, bundler refusing to parse a Gemfile whose bare gemspec directive finds more than one gemspec to choose from.
+3. ~ Eodhd::VERSION: /0.19.4/0.19.5/
+
+
+## 20260910
+
+0.19.4: ~ lib/Eodhd.rb: + require_relative './Eodhd/VERSION'; + test/Eodhd/VERSION_test.rb
+
+1. ~ lib/Eodhd.rb: + `require_relative './Eodhd/VERSION'`, last among the requires. The file has been present and unreached, so `require 'eodhd'` left Eodhd::VERSION undefined and the gemspec was the only thing loading it.
+2. + test/Eodhd/VERSION_test.rb: that Eodhd::VERSION is a string, that it is three numbers separated by dots, and that it matches the newest entry in the changelog. Modelled on moby's, which is where the convention comes from.
+3. The test loads the library rather than VERSION.rb, which is the whole of its value: run against v0.19.3 it fails with "uninitialized constant Eodhd::VERSION". Nine libraries were in that state and not one of them carried this test, which is how it went unseen.
+4. ~ Eodhd::VERSION: /0.19.3/0.19.4/
+
+
+## 20260821
+
+0.19.3: Rewrite the CHANGELOG in the form changelogger writes.
+
+1. ~ CHANGELOG: The Keep a Changelog form, `## [version] - date, summary` over `- ` bullets, --> the form the rest of these gems use: a `## YYYYMMDD` heading per date, newest first, holding each of that date's versions as a summary line over numbered items. No item was reworded, dropped or reordered, and all 111 are still here.
+2. ~ CHANGELOG: 20260719 carried three headings, for 0.18.1, 0.19.0 and 0.19.1, so one day's work read as three; 20251005 carried two, for 0.16.0 and 0.17.0. One heading each now, the versions under them in the same order they were in.
+3. ~ CHANGELOG: The version summaries are the commit subjects, which three of them had not been: 0.19.2 read "populate the .gitignore" against a commit saying `~ .gitignore: + current default contents`, 0.19.1 likewise, and 0.19.0 differed in case. Every other repo here keeps the two identical, which is what makes a summary checkable against something.
+4. ~ CHANGELOG: /# eodhd.rb\/CHANGELOG/# CHANGELOG/, the file's own name being no part of what it records.
+5. ~ Eodhd/VERSION: /0.19.2/0.19.3/
+
+0.19.2: ~ .gitignore: + current default contents
+
+1. ~ .gitignore: + current default contents. The file held only its filename comment, having been committed that way.
+2. ~ Eodhd/VERSION: /0.19.1/0.19.2/
+
+
+## 20260719
+
+0.19.1: ~ README.md: + a blank line before each code fence.
+
+1. ~ README.md: + a blank line before each code fence, without which the highlighting does not render.
+2. ~ Eodhd/VERSION: /0.19.0/0.19.1/
+
+0.19.0: Complete the fundamentals model wrapping.
+
+1. + Eodhd::Fundamentals::Financials::BalanceSheet::Entry: Typed entry for a balance sheet period (64 fields).
+2. + Eodhd::Fundamentals::Financials::IncomeStatement::Entry: Typed entry for an income statement period (34 fields).
+3. + Eodhd::Fundamentals::Financials::CashFlow::Entry: Typed entry for a cash flow period (32 fields).
+4. + Eodhd::Fundamentals::Earnings::AnnualEntry
+5. + Eodhd::Fundamentals::Earnings::HistoryEntry
+6. + Eodhd::Fundamentals::Earnings::TrendEntry
+7. + Eodhd::Fundamentals::Holders::Institution: Typed entry for an institutional holder.
+8. + Eodhd::Fundamentals::Holders::Fund: Typed entry for a fund holder.
+9. + Eodhd::Fundamentals::InsiderTransaction: Typed entry for an insider transaction.
+10. + Eodhd::Fundamentals::OutstandingShares::Entry: Typed entry for an outstanding shares data point.
+11. + Eodhd::Fundamentals::OutstandingShares: Wraps annual and quarterly OutstandingShares::Entry arrays.
+12. + Eodhd::Fundamentals::Financials::BalanceSheet
+13. + Eodhd::Fundamentals::Financials::IncomeStatement
+14. + Eodhd::Fundamentals::Financials::CashFlow
+15. ~ Eodhd::Fundamentals::Financials: Build BalanceSheet/IncomeStatement/CashFlow instead of the shared Statement.
+16. ~ Eodhd::Fundamentals::Financials::BalanceSheet#yearly, #quarterly: Now sorted arrays of typed entries, was raw hashes.
+17. ~ Eodhd::Fundamentals::Earnings#annual, #history, #trend: Now sorted arrays of typed entries, was raw hashes.
+18. ~ Eodhd::Fundamentals::Holders#institutions, #funds: Now arrays of typed entries, was raw hashes.
+19. ~ Eodhd::Fundamentals#insider_transactions: Now a sorted array of InsiderTransaction, was a raw hash.
+20. ~ Eodhd::Fundamentals#outstanding_shares: Now an OutstandingShares object, was a raw hash.
+21. + test/Eodhd/Fundamentals_test.rb: Cover the newly wrapped entry types and collections.
+22. - Eodhd::Fundamentals::Financials::Statement: Replaced by the three per-statement classes.
+23. ~ Eodhd/VERSION: /0.18.1/0.19.0/
+
+0.18.1: urlencode helper naming consistency
+
+1. /Thoran::String::UrlEncode#url_encode/Thoran::String::Urlencode#urlencode/ (url_encode kept as an alias).
+2. /Thoran::Hash::XWwwFormUrlEncode#x_www_form_url_encode/Thoran::Hash::XWwwFormUrlencode#x_www_form_urlencode/ (x_www_form_url_encode kept as an alias).
+3. ~ lib/Hash/x_www_form_urlencode.rb: Renamed urlencode require path.
+4. ~ eodhd.rb.gemspec: - spec.date (RubyGems stamps the build date); tidy spec.require_paths placement.
+5. ~ Eodhd/VERSION: /0.18.0/0.18.1/
+
+
+## 20260320
+
+0.18.0: + fundamentals endpoint
+
+1. + Eodhd::Fundamentals: Model for fundamental data with typed sub-objects.
+2. + Eodhd::Fundamentals::General
+3. + Eodhd::Fundamentals::Highlights
+4. + Eodhd::Fundamentals::Valuation
+5. + Eodhd::Fundamentals::SharesStats
+6. + Eodhd::Fundamentals::Technicals
+7. + Eodhd::Fundamentals::SplitsDividends
+8. + Eodhd::Fundamentals::AnalystRatings
+9. + Eodhd::Fundamentals::Holders
+10. + Eodhd::Fundamentals::ESGScores
+11. + Eodhd::Fundamentals::Earnings
+12. + Eodhd::Fundamentals::Financials
+13. + Eodhd::Fundamentals::Financials::Statement
+14. + Eodhd::Client#fundamentals: Fetch fundamental data for a symbol.
+15. + Eodhd#fundamentals: Facade method for fundamental data.
+16. + test/Eodhd/Fundamentals_test.rb
+17. ~ test/Eodhd/Client_test.rb: + tests for fundamentals endpoint.
+18. ~ test/Eodhd_test.rb: + test for fundamentals facade method.
+19. ~ test/helper.rb: + require 'minitest/mock' for minitest 6 compatibility.
+20. ~ Eodhd: Move initialize, web_socket, stream to private.
+21. ~ Eodhd: + safe navigation (&.) on exchange and exchange_symbol across all methods.
+22. ~ Eodhd#intraday: + exchange_symbol argument.
+23. ~ Eodhd#intraday: - default exchange_code of 'US'
+24. ~ test/: Reorganise test files into test/Eodhd/ subdirectory.
+25. - test/test_all.rb: Previously replaced by Rakefile.
+26. /CHANGELOG.txt/CHANGELOG/
+27. + LICENSE: MIT License.
+28. ~ README.md: Rewrite with intraday, fundamentals, and WebSocket documentation.
+
+
+## 20251005
+
+0.17.0: + intraday endpoint
+
+1. + Eodhd::Intraday: Model for intraday data.
+2. + Eodhd::Client#intraday: Fetch intraday data for US stocks.
+3. + Eodhd#intraday: Facade method for intraday data.
+4. + Eodhd::Validations#validate_interval: Validation of intraday intervals (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1mo).
+5. ~ Eodhd::Validations#validate_arguments: + interval argument.
+6. ~ test/validations_test.rb: + tests for validate_interval.
+7. ~ test/client_test.rb: + tests for intraday endpoint.
+8. ~ test/eodhd_test.rb: + tests for intraday facade method.
+
+0.16.0: + automated tests, + DefaultLogger, fix WebSocket bugs, improve validations
+
+1. + Eodhd::DefaultLogger: A shared logger for Client and WebSocketClient.
+2. ~ Eodhd::Client: Use DefaultLogger.
+3. ~ Eodhd::Client#initialize: + logger, use_default_logger arguments.
+4. + Eodhd::Client#use_logging?
+5. ~ Eodhd::Validations: Move validate_arguments() from Client to Validations.
+6. ~ Eodhd::Validations: Remove ! from all validation methods (validate_exchange_code, validate_symbol, etc).
+7. ~ Eodhd::WebSocketClient: Use DefaultLogger, add logger attribute.
+8. ~ Eodhd::WebSocketClient#initialize: + logger, use_default_logger arguments.
+9. + Eodhd::WebSocketClient#use_logging?: Check if logging is enabled.
+10. ~ Eodhd::WebSocketClient::Handler: Remove duplicate logger code.
+11. ~ Eodhd::WebSocketClient::Handler#initialize: + logger argument.
+12. ~ Eodhd::WebSocketClient::Handler#handle_response: Fix JSON parsing with proper StandardError rescue.
+13. ~ Eodhd::WebSocketClient::Handler#log_error: Use instance logger with use_logging? check.
+14. + test/validations_test.rb: Comprehensive validation tests with edge cases.
+15. + test/client_test.rb: REST client tests with VCR for all endpoints.
+16. + test/eodhd_test.rb: Facade delegation tests.
+17. + test/web_socket_client_test.rb: WebSocket client tests with stubbed Iodine.
+18. + test/helper.rb: VCR configuration with WebMock.
+19. ~ eodhd.gemspec: Add iodine as runtime dependency.
+20. ~ .gitignore: + Gemfile.lock.
+
+
+## 20250916
+
+0.15.0: Add validations, response logging, a version constant, and CHANGELOG.
+
+1. + Eodhd::Validations
+2. + Eodhd::Client#validate_arguments
+3. ~ Eodhd::Client#exchange_symbol_list: Use validate_arguments().
+4. ~ Eodhd::Client#eod_data: Use validate_arguments().
+5. ~ Eodhd::Client#eod_bulk_last_day: Use validate_arguments().
+6. + Eodhd::Client#log_response
+7. ~ Eodhd::Client#do_request: Call log_request() after construction of args.
+8. ~ Eodhd::Client#handle_response: Use log_response().
+9. + Eodhd::VERSION
+10. ~ eodhd.gemspec: Use Eodhd::VERSION and update the date.
+11. + CHANGELOG.txt
+
+
+## 20250326
+
+0.14.2: Remove reference to currently unused library UnixTime.
+
+1. ~ Eodhd::WebSocketClient: - require 'UnixTime'
+
+
+## 20250323
+
+0.14.1: Some fixes for the WebSocketClient interface.
+
+1. ~ Eodhd::WebSocketClient: + attr_accessor :consumer
+2. ~ Eodhd::WebSocketClient: /attr_accessor :symbols/attr_reader :symbols/
+3. + Eodhd::WebSocketClient#symbols=
+
+
+## 20250321
+
+0.14.0: Add WebSockets.
+
+1. + Eodhd::WebSocketClient
+2. + Eodhd#web_socket
+3. + Eodhd#stream
+4. + Eodhd#us_quote_stream
+5. + Eodhd#us_trade_stream
+6. + Eodhd#forex_stream
+7. + Eodhd#crypto_stream
+8. ~ Eodhd::Error: lib/Eodhd/Client.rb --> lib/Eodhd/Error.rb

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec name: 'eodhd.rb'

data/README.md

@@ -0,0 +1,160 @@
+# eodhd.rb
+
+## Description
+
+Access the eodhd.com API with Ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+  gem 'eodhd.rb'
+```
+
+And then execute:
+
+```bash
+  $ bundle
+```
+
+Or install it yourself as:
+
+```bash
+  $ gem install eodhd.rb
+```
+
+## Usage
+
+### Setup
+
+```ruby
+api_token = 'api_token'
+eodhd = Eodhd.new(api_token: api_token)
+```
+
+### List of Exchanges
+
+```ruby
+eodhd.exchanges
+```
+
+### List of Exchange Symbols
+
+```ruby
+exchange = eodhd.exchanges.first
+
+eodhd.exchange_symbols(exchange: exchange)
+# OR
+eodhd.exchange_symbols(exchange_code: exchange.code)
+```
+
+### Retrieve EOD Data For One Symbol
+
+```ruby
+exchange = eodhd.exchanges.first
+exchange_symbol = eodhd.exchange_symbols(exchange: exchange).first
+
+eodhd.eod_data(exchange: exchange, exchange_symbol: exchange_symbol)
+# OR
+eodhd.eod_data(exchange_code: exchange.code, exchange_symbol: exchange_symbol)
+# OR
+eodhd.eod_data(exchange: exchange, symbol: exchange_symbol.code)
+# OR
+eodhd.eod_data(exchange_code: exchange.code, symbol: exchange_symbol.code)
+```
+
+### Retrieve EOD Data For Multiple Symbols For One Date
+
+```ruby
+exchange = eodhd.exchanges.first
+
+eodhd.eod_bulk_last_day(exchange: exchange, date: Date.today)
+# OR
+eodhd.eod_bulk_last_day(exchange_code: exchange.code, date: Date.today)
+```
+
+### Retrieve Intraday Data
+
+```ruby
+eodhd.intraday(symbol: 'AAPL', exchange_code: 'US', interval: '5m')
+# OR with date range (from and to are Unix timestamps)
+eodhd.intraday(symbol: 'AAPL', exchange_code: 'US', interval: '1h', from: 1696118400, to: 1696550400)
+```
+
+### Retrieve Fundamental Data
+
+```ruby
+fd = eodhd.fundamentals(exchange_code: 'US', symbol: 'AAPL')
+
+fd.general
+fd.general.name
+fd.general.sector
+fd.general.industry
+
+fd.highlights
+fd.highlights.market_capitalization
+fd.highlights.pe_ratio
+fd.highlights.dividend_yield
+fd.highlights.earnings_share
+
+fd.valuation
+fd.valuation.trailing_pe
+fd.valuation.forward_pe
+fd.valuation.price_book_mrq
+
+fd.shares_stats
+fd.shares_stats.shares_outstanding
+fd.shares_stats.shares_float
+
+fd.financials
+fd.financials.income_statement
+fd.financials.income_statement.quarterly
+fd.financials.income_statement.yearly
+fd.financials.balance_sheet.quarterly
+fd.financials.cash_flow.quarterly
+
+fd.earnings
+fd.earnings.history
+fd.earnings.trend
+fd.earnings.annual
+```
+
+#### Use the filter parameter to request only specific sections
+
+```ruby
+eodhd.fundamentals(exchange_code: 'US', symbol: 'AAPL', filter: 'General')
+eodhd.fundamentals(exchange_code: 'US', symbol: 'AAPL', filter: 'Financials::Income_Statement::quarterly')
+```
+
+### WebSockets
+
+#### Streaming requires a callable consumer (a proc, lambda, or any object responding to `call`) to handle incoming data frames
+
+```ruby
+consumer = ->(data){puts data}
+eodhd = Eodhd.new(api_token: api_token, consumer: consumer)
+
+eodhd.us_trade_stream('AAPL,MSFT')
+eodhd.us_quote_stream('AAPL,MSFT')
+eodhd.forex_stream('EURUSD')
+eodhd.crypto_stream('BTC-USD')
+```
+
+#### Or use the general interface
+
+```ruby
+eodhd.stream(asset_class: 'us', symbols: 'AAPL,MSFT')
+```
+
+## License
+
+MIT License. See LICENSE file for details.
+
+## 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/Rakefile

@@ -0,0 +1,28 @@
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.warning = true
+end
+
+task default: :test
+
+namespace :cassettes do
+  CASSETTE_DIR = File.expand_path("test/fixtures/vcr_cassettes", __dir__)
+
+  desc "Delete all VCR cassettes"
+  task :clear do
+    if Dir.exist?(CASSETTE_DIR)
+      FileUtils.rm_rf(Dir[File.join(CASSETTE_DIR, "**", "*")])
+      puts "Cleared cassettes in #{CASSETTE_DIR}"
+    else
+      puts "Cassette dir not found: #{CASSETTE_DIR}"
+    end
+  end
+
+  desc "Show cassette directory path"
+  task :path do
+    puts CASSETTE_DIR
+  end
+end

data/eodhd.gemspec

@@ -0,0 +1,52 @@
+require_relative './lib/Eodhd/VERSION'
+
+class Gem::Specification
+  def dependencies=(gems)
+    gems.each{|gem| add_dependency(*gem)}
+  end
+
+  def development_dependencies=(gems)
+    gems.each{|gem| add_development_dependency(*gem)}
+  end
+end
+
+Gem::Specification.new do |spec|
+  spec.name = 'eodhd'
+  spec.version = Eodhd::VERSION
+
+  spec.summary = "Access the eodhd.com API with Ruby."
+  spec.description = "Access the eodhd.com API with Ruby."
+
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'http://github.com/thoran/eodhd.rb'
+  spec.license = 'MIT'
+
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 2.7'
+
+  spec.files = [
+    'CHANGELOG',
+    'eodhd.gemspec',
+    'Gemfile',
+    Dir['lib/**/*.rb'],
+    'Rakefile',
+    'README.md',
+    Dir['test/**/*.rb']
+  ].flatten
+
+  spec.dependencies = %w{
+    http.rb
+    iodine
+  }
+
+  spec.development_dependencies = %w{
+    rake
+    minitest
+    minitest-mock
+    minitest-spec-context
+    webmock
+    vcr
+    simplecov
+  }
+end

data/lib/Eodhd/Client.rb

@@ -0,0 +1,143 @@
+# Eodhd/Client.rb
+# Eodhd::Client
+
+gem 'http.rb'
+
+require 'http.rb'
+require 'json'
+
+require_relative './DefaultLogger'
+require_relative './Error'
+require_relative '../Hash/x_www_form_urlencode'
+require_relative './Validations'
+
+class Eodhd
+  class Client
+
+    API_HOST = 'eodhd.com'
+
+    class << self
+      def path_prefix
+        '/api'
+      end
+    end # class << self
+
+    include Validations
+
+    # This endpoint always returns json regardless of what fmt is specified.
+    def exchanges_list
+      response = get(path: '/exchanges-list')
+      handle_response(response)
+    end
+
+    def exchange_symbol_list(exchange_code:)
+      validate_arguments(exchange_code: exchange_code)
+      response = get(path: "/exchange-symbol-list/#{exchange_code}")
+      handle_response(response)
+    end
+
+    def eod_data(exchange_id:, symbol:, period:, from: nil, to: nil)
+      validate_arguments(
+        exchange_id: exchange_id,
+        symbol: symbol,
+        period: period,
+        from: from,
+        to: to
+      )
+      args = {period: period, from: from, to: to}.compact
+      response = get(path: "/eod/#{symbol}.#{exchange_id}", args: args)
+      handle_response(response)
+    end
+
+    def eod_bulk_last_day(exchange_id:, date:)
+      validate_arguments(exchange_id: exchange_id, date: date)
+      args = {date: date}
+      response = get(path: "/eod-bulk-last-day/#{exchange_id}", args: args)
+      handle_response(response)
+    end
+
+    def intraday(exchange_code:, symbol:, interval:, from: nil, to: nil)
+      validate_arguments(
+        exchange_code: exchange_code,
+        symbol: symbol,
+        interval: interval,
+        from: from,
+        to: to
+      )
+      args = {interval: interval, from: from, to: to}.compact
+      response = get(path: "/intraday/#{symbol}.#{exchange_code}", args: args)
+      handle_response(response)
+    end
+
+    def fundamentals(exchange_code:, symbol:, filter: nil)
+      validate_arguments(exchange_code: exchange_code, symbol: symbol)
+      args = {filter: filter}.compact
+      response = get(path: "/fundamentals/#{symbol}.#{exchange_code}", args: args)
+      handle_response(response)
+    end
+
+    attr_accessor\
+      :api_token,
+      :logger
+
+    private
+
+    def initialize(api_token: nil, logger: nil, use_default_logger: false)
+      @api_token = api_token
+      @logger = use_default_logger ? DefaultLogger.logger : logger
+    end
+
+    def request_string(path)
+      "https://#{API_HOST}#{self.class.path_prefix}#{path}"
+    end
+
+    def log_args?(args)
+      !args.values.all?(&:nil?)
+    end
+
+    def log_request(verb:, request_string:, args:)
+      log_string = "#{verb} #{request_string}"
+      if log_args?(args)
+        log_string << "?#{args.x_www_form_urlencode}"
+      end
+      @logger.info(log_string)
+    end
+
+    def log_response(code:, message:, body:)
+      log_string = "#{code}\n#{message}\n#{body}"
+      @logger.info(log_string)
+    end
+
+    def log_error(code:, message:, body:)
+      log_string = "#{code}\n#{message}\n#{body}"
+      @logger.error(log_string)
+    end
+
+    def do_request(verb:, path:, args: {})
+      api_token = args[:api_token] || @api_token
+      fmt = args[:fmt] || 'json'
+      args.merge!(api_token: api_token, fmt: fmt)
+      log_request(verb: verb, request_string: request_string(path), args: args) if use_logging?
+      HTTP.send(verb.to_s.downcase, request_string(path), args)
+    end
+
+    def get(path:, args: {})
+      do_request(verb: 'GET', path: path, args: args)
+    end
+
+    def handle_response(response)
+      if response.success?
+        parsed_body = JSON.parse(response.body)
+        log_response(code: response.code, message: response.message, body: response.body) if use_logging?
+        parsed_body
+      else
+        log_error(code: response.code, message: response.message, body: response.body) if use_logging?
+        raise Eodhd::Error.new(code: response.code, message: response.message, body: response.body)
+      end
+    end
+
+    def use_logging?
+      !@logger.nil?
+    end
+  end
+end

data/lib/Eodhd/DefaultLogger.rb

@@ -0,0 +1,30 @@
+# Eodhd/DefaultLogger.rb
+# Eodhd::DefaultLogger
+
+require 'fileutils'
+require 'logger'
+
+class Eodhd
+  class DefaultLogger
+    class << self
+      attr_writer :log_filepath
+
+      def default_log_filepath
+        File.join(%w{~ log eodhd log.txt})
+      end
+
+      def log_filepath
+        File.expand_path(@log_filepath || default_log_filepath)
+      end
+
+      def log_file
+        FileUtils.mkdir_p(File.dirname(log_filepath))
+        File.open(log_filepath, File::WRONLY | File::APPEND | File::CREAT)
+      end
+
+      def logger
+        @logger ||= Logger.new(log_file, 'daily')
+      end
+    end
+  end
+end

data/lib/Eodhd/EodBulkLastDay.rb

@@ -0,0 +1,56 @@
+# Eodhd/EodBulkLastDay.rb
+# Eodhd::EodBulkLastDay
+
+class Eodhd
+  class EodBulkLastDay
+    class << self
+      def all(client: nil, api_token: nil, exchange_code:, date:)
+        load(client: client, api_token: api_token, exchange_code: exchange_code, date:)
+      end
+
+      private
+
+      def load(client: nil, api_token: nil, exchange_code:, date:)
+        client ||= Client.new(api_token: api_token)
+        client.eod_bulk_last_day(exchange_id: exchange_code, date: date).collect do |eod_bulk_last_day|
+          self.new(
+            code: eod_bulk_last_day['code'],
+            exchange_short_name: eod_bulk_last_day['exchange_short_name'],
+            date: eod_bulk_last_day['date'],
+            open: eod_bulk_last_day['open'],
+            high: eod_bulk_last_day['high'],
+            low: eod_bulk_last_day['low'],
+            close: eod_bulk_last_day['close'],
+            adjusted_close: eod_bulk_last_day['adjusted_close'],
+            volume: eod_bulk_last_day['volume']
+          )
+        end
+      end
+    end # class << self
+
+    attr_reader\
+      :code,
+      :exchange_short_name,
+      :date,
+      :open,
+      :high,
+      :low,
+      :close,
+      :adjusted_close,
+      :volume
+
+    private
+
+    def initialize(code:, exchange_short_name:, date:, open:, high:, low:, close:, adjusted_close:, volume:)
+      @code = code
+      @exchange_short_name = exchange_short_name
+      @date = date
+      @open = open
+      @high = high
+      @low = low
+      @close = close
+      @adjusted_close = adjusted_close
+      @volume = volume
+    end
+  end
+end