iex-ruby-client 1.3.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8a4a5e3e694cd4af9310002178f918ed6b6802711860e29780e2bde8f494805
-  data.tar.gz: 415aa05993daba620a4aea9a32aa52d73a8e0b3bdc39fd96296fb655703b2921
+  metadata.gz: 842d8fd485aebd159c318088ca1137348555a4a2106e4e4089da3e13ecc596eb
+  data.tar.gz: dc2046dd1efbd5c0593134fa99daf5a280f62c629c2779d785f5f34f41896c6a
 SHA512:
-  metadata.gz: 43680c128f3354b4f64f485c51ddfed0f94c9a3f25b6be1c16f93a7a3a97534a0e1fa990a85394d92c1aca220410ceea1a9e9f0d061abce8c7e697ef91a022e3
-  data.tar.gz: 3f497b0bdcc8b295b1f370d3185e6768fea91cbafdde5acdf637d8a16b918d0e5fc229eb5bb702eca8d5848388b5803e797cf8c21feb156c895f3c8e1d5d2dd8
+  metadata.gz: 543f9a5bea937226e974b430654c53d4fab1f4cbb79d025784888f6a4924aeb2c59bcceb2214257a78544274c217f555594cc100a9820dae2b8f90d72ef9b1ae
+  data.tar.gz: 205d65bf85cfd152e4cddb8f6344658cea65a12201aceba42a43a52a524efcbf02e9695ddfa543c99b5fc90f402b096e490fe6341697fbb07e7de5a5a7961c72

data/.gitignore

@@ -4,3 +4,4 @@ Gemfile.lock
 .DS_Store
 .bundle
 .idea
+.irbrc

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+### 1.6.0 (2021/10/17)
+* [#110](https://github.com/dblock/iex-ruby-client/pull/110): Drop `money_helper` dependency and utilize `money` gem directly - [@agrberg](https://github.com/agrberg).
+
+### 1.5.0 (2021/08/15)
+* [#105](https://github.com/dblock/iex-ruby-client/pull/105): Added support for fetching latest foreign exchange rates - [@mathu97](https://github.com/mathu97).
+* [#106](https://github.com/dblock/iex-ruby-client/pull/106): Added support for fetching a single key stat with `key_stat(symbol, stat)` endpoint - [@agrberg](https://github.com/agrberg).
+* [#107](https://github.com/dblock/iex-ruby-client/pull/107): Added `./script/console` for ease of local development - [@agrberg](https://github.com/agrberg).
+
+### 1.4.1 (2021/05/15)
+* [#103](https://github.com/dblock/iex-ruby-client/pull/103): Added support for fetching symbols for an exchange - [@mathu97](https://github.com/mathu97).
+* [#99](https://github.com/dblock/iex-ruby-client/pull/99): Added `image` and `paywalled` to news - [@reddavis](https://github.com/reddavis).
+* [#100](https://github.com/dblock/iex-ruby-client/pull/100): Added `language` to news - [@reddavis](https://github.com/reddavis).
+
+### 1.4.0 (2020/11/19)
+* [#90](https://github.com/dblock/iex-ruby-client/pull/90): Added documentation for advanced stats and removed `avg_30_Volume` from advanced stats since it is found in key stats - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+* [#91](https://github.com/dblock/iex-ruby-client/pull/91): Added support for Balance Sheet API endpoint - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+* [#92](https://github.com/dblock/iex-ruby-client/pull/92): Added support for Cash Flow Statements API endpoint - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+* [#93](https://github.com/dblock/iex-ruby-client/pull/93): Added `fiscal_date` and `currency` to income statements - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+* [#94](https://github.com/dblock/iex-ruby-client/pull/94): Added `historical_prices` API endpoint - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+* [#95](https://github.com/dblock/iex-ruby-client/pull/95): Added all KeyStat properties to AdvancedStats since they are already returned in the API call - [@tylerhaugen-stanley](https://github.com/tylerhaugen-stanley).
+
 ### 1.3.0 (2020/10/31)
 
 * [#82](https://github.com/dblock/iex-ruby-client/pull/82): Added `config.referer` to set HTTP `Referer` header. This enables IEX's "Manage domains" domain locking for tokens - [@agrberg](https://github.com/agrberg).

data/README.md

@@ -15,19 +15,25 @@ A Ruby client for the [The IEX Cloud API](https://iexcloud.io/docs/api/).
   - [Get a Quote](#get-a-quote)
   - [Get a OHLC (Open, High, Low, Close) price](#get-a-ohlc-open-high-low-close-price)
   - [Get a Market OHLC (Open, High, Low, Close) prices](#get-a-market-ohlc-open-high-low-close-prices)
+  - [Get Historical Prices](#get-historical-prices)
   - [Get Company Information](#get-company-information)
   - [Get a Company Logo](#get-a-company-logo)
   - [Get Recent News](#get-recent-news)
   - [Get Chart](#get-chart)
   - [Get Key Stats](#get-key-stats)
+  - [Get Advanced Stats](#get-advanced-stats)
   - [Get Dividends](#get-dividends)
   - [Get Earnings](#get-earnings)
   - [Get Income Statement](#get-income-statement)
+  - [Get Balance Sheet](#get-balance-sheet)
+  - [Get Cash Flow Statement](#get-cash-flow-statement)
   - [Get Sector Performance](#get-sector-performance)
   - [Get Largest Trades](#get-largest-trades)
   - [Get a Quote for Crypto Currencies](#get-a-quote-for-crypto-currencies)
   - [ISIN Mapping](#isin-mapping)
   - [Get Symbols](#get-symbols)
+  - [Get Symbols for an Exchange](#get-symbols-for-an-exchange)
+  - [Get Latest Foreign Exchange Rates](#get-latest-foreign-exchange-rates)
   - [Get List](#get-list)
   - [Other Requests](#other-requests)
 - [Configuration](#configuration)
@@ -130,6 +136,60 @@ market['SPY'].high #
 market['SPY'].low #
 ```
 
+### Get Historical Prices
+
+Fetches a list of historical prices.
+
+There are currently a few limitations of this endpoint compared to the official IEX one.
+
+Options for `range` include:
+`max, ytd, 5y, 2y, 1y, 6m, 3m, 1m, 5d, date`
+
+NOTE: If you use the `date` value for the `range` parameter:
+
+- The options _must_ include a date entry, `{date: ...}`
+- The date value _must_ be either a Date object, or a string formatted as `YYYYMMDD`. Anything else will result in an `IEX::Errors::ClientError`.
+- The options _must_ include `chartByDay: 'true'` or an `ArgumentError` will be raised.
+- See below for examples.
+
+`Query params` supported include:
+`chartByDay`
+
+This is a complicated endpoint as there is a lot of granularity over the time period of data returned. See below for a variety of ways to request data, NOTE: this is _NOT_ as exhaustive list.
+
+```ruby
+historical_prices = client.historical_prices('MSFT') # One month of data
+historical_prices = client.historical_prices('MSFT', {range: 'max'}) # All data up to 15 years
+historical_prices = client.historical_prices('MSFT', {range: 'ytd'}) # Year to date data
+historical_prices = client.historical_prices('MSFT', {range: '5y'}) # 5 years of data
+historical_prices = client.historical_prices('MSFT', {range: '6m'}) # 6 months of data
+historical_prices = client.historical_prices('MSFT', {range: '5d'}) # 5 days of data
+historical_prices = client.historical_prices('MSFT', {range: 'date', date: '20200930', chartByDay: 'true'}) # One day of data
+historical_prices = client.historical_prices('MSFT', {range: 'date', date: Date.parse('2020-09-30'), chartByDay: 'true'}) # One day of data
+...
+```
+
+Once you have the data over the preferred time period, you can access the following fields
+
+```ruby
+historical_prices = client.historical_prices('MSFT') # One month of data
+
+historical_price = historical_prices.first
+historical_price.date # 2020-10-07
+historical_price.open #207.06
+historical_price.open_dollar # '$207.06'
+historical_price.close # 209.83
+historical_price.close_dollar # '$209.83'
+historical_price.high # 210.11
+historical_price.high_dollar # '$210.11'
+historical_price.low # 206.72
+historical_price.low_dollar # '$206.72'
+historical_price.volume # 25681054
+...
+```
+
+There are a lot of options here so I would recommend viewing the official IEX documentation [#historical-prices](https://iexcloud.io/docs/api/#historical-prices) or [historical_prices.rb](lib/iex/resources/historical_prices.rb) for returned fields.
+
 ### Get Company Information
 
 Fetches company information for a symbol.
@@ -263,8 +323,58 @@ key_stats.pe_ratio # 29.47
 key_stats.beta # 1.4135449089973444
 ```
 
+You can also fetch a single stat for a symbol. **Note** that IEX uses `lowerCamelCase` for the names of the stats.
+
+```ruby
+client.key_stat('VTI', 'dividendYield') # 0.01271760965303361
+```
+
 See [#key-stats](https://iexcloud.io/docs/api/#key-stats) for detailed documentation or [key_stats.rb](lib/iex/resources/key_stats.rb) for returned fields.
 
+### Get Advanced Stats
+
+Fetches company's advanced stats for a symbol, this will include all key stats as well.
+
+```ruby
+advanced_stats = client.advanced_stats('MSFT')
+
+advanced_stats.total_cash # 66301000000
+advanced_stats.total_cash_dollars # "$66,301,000,000"
+advanced_stats.current_debt # 20748000000
+advanced_stats.current_debt_dollars # "$2,074,8000,000"
+advanced_stats.revenue # 265809000000
+advanced_stats.revenue_dollars # "$265,809,000,000"
+advanced_stats.gross_profit # 101983000000
+advanced_stats.gross_profit_dollar # "$101,983,000,000"
+advanced_stats.total_revenue # 265809000000
+advanced_stats.total_revenue_dollar # "$265,809,000,000"
+advanced_stats.ebitda # 80342000000
+advanced_stats.ebitda_dollar # "$80,342,000,000"
+advanced_stats.revenue_per_share # 0.02
+advanced_stats.revenue_per_share_dollar # "$0.02"
+advanced_stats.revenue_per_employee # 2013704.55
+advanced_stats.revenue_per_employee_dollar # "$2,013,704.55"
+advanced_stats.debt_to_equity # 1.07
+advanced_stats.profit_margin # 22.396157
+advanced_stats.enterprise_value # 1022460690000
+advanced_stats.enterprise_value_dollar # "$1,022,460,690,000"
+advanced_stats.enterprise_value_to_revenue # 3.85
+advanced_stats.price_to_sales # 3.49
+advanced_stats.price_to_sales_dollar # "$3.49"
+advanced_stats.price_to_book # 8.805916432564608
+advanced_stats.forward_pe_ratio # 18.14
+advanced_stats.pe_high # 22.61
+advanced_stats.pe_low # 11.98
+advanced_stats.peg_ratio # 2.19
+advanced_stats.week_52_high_date # "2019-11-19"
+advanced_stats.week_52_low_date # "2019-01-03
+advanced_stats.beta # 1.4661365583766115
+advanced_stats.put_call_ratio # 0.6780362005229779
+...
+```
+
+See [#advanced-stats](https://iexcloud.io/docs/api/#advanced-stats) for detailed documentation or [advanced_stats.rb](lib/iex/resources/advanced_stats.rb) for returned fields.
+
 ### Get Dividends
 
 Fetches dividends for a symbol.
@@ -304,12 +414,16 @@ See [#earnings](https://iexcloud.io/docs/api/#earnings) for detailed documentati
 
 ### Get Income Statement
 
-Fetches income statement for a symbol.
+Fetches income statements for a symbol.
 
 ```ruby
-income = client.income('MSFT')
+income_statements = client.income('MSFT')
 
+# Multiple income statements are returned with 1 API call.
+income = income_statements.first
 income.report_date # '2019-03-31'
+income.fiscal_date # '2019-03-31'
+income.currency # 'USD'
 income.total_revenue # 30_505_000_000
 income.total_revenue_dollar # '$30,505,000,000'
 income.cost_of_revenue # 10_170_000_000
@@ -321,6 +435,48 @@ income.gross_profit_dollar # '$20,335,000,000'
 
 See [#income-statement](https://iexcloud.io/docs/api/#income-statement) for detailed documentation or [income.rb](lib/iex/resources/income.rb) for returned fields.
 
+### Get Balance Sheet
+
+Fetches balance sheets for a symbol.
+
+```ruby
+balance_sheets = client.balance_sheet('MSFT')
+
+# Multiple balance sheets are returned with 1 API call.
+balance_sheet = balance_sheets.first
+balance_sheet.report_date # '2017-03-31'
+balance_sheet.fiscal_date # '2017-03-31'
+balance_sheet.currency # 'USD'
+balance_sheet.current_cash # 25_913_000_000
+balance_sheet.current_cash_dollar # '$25,913,000,000'
+balance_sheet.short_term_investments # 40_388_000_000
+balance_sheet.short_term_investments_dollar # '$40,388,000,000'
+...
+```
+
+See [#balance-sheet](https://iexcloud.io/docs/api/#balance-sheet) for detailed documentation or [balance_sheet.rb](lib/iex/resources/balance_sheet.rb) for returned fields.
+
+### Get Cash Flow Statement
+
+Fetches cash flow statements for a symbol.
+
+```ruby
+cash_flow_statements = client.cash_flow('MSFT')
+
+# Multiple cash flow statements are returned with 1 API call.
+cash_flow = cash_flow_statements.first
+cash_flow.report_date # '2018-09-30'
+cash_flow.fiscal_date # '2018-09-30'
+cash_flow.currency # 'USD'
+cash_flow.net_income # 14_125_000_000
+cash_flow.net_income_dollar # '$14,125,000,000'
+cash_flow.depreciation # 2_754_000_000
+cash_flow.depreciation_dollar # '$2,754,000,000'
+...
+```
+
+See [#cash-flow](https://iexcloud.io/docs/api/#cash-flow) for detailed documentation or [cash_flow.rb](lib/iex/resources/cash_flow.rb) for returned fields.
+
 ### Get Sector Performance
 
 Fetches latest sector's performance.
@@ -396,7 +552,6 @@ The API also lets you convert multiple ISINs to IEX Cloud symbols.
 symbols = client.ref_data_isin(['US0378331005', 'US0378331006'])
 ```
 
-
 You can use `mapped: true` option to receive symbols grouped by their ISINs.
 
 ```ruby
@@ -407,7 +562,7 @@ See [#ISIN Mapping](https://iexcloud.io/docs/api/#isin-mapping) for detailed doc
 
 ### Get Symbols
 
-Returns an array of symbols
+Returns an array of symbols.
 
 ```ruby
 symbols = client.ref_data_symbols()
@@ -421,6 +576,37 @@ symbol.symbol # A
 
 See [#symbols](https://iexcloud.io/docs/api/#symbols) for detailed documentation or [symbols.rb](lib/iex/resources/symbols.rb) for returned fields.
 
+### Get Symbols for an Exchange
+
+Returns an array of symbols for a given exchange.
+
+```ruby
+symbols = client.ref_data_symbols_for_exchange('TSX')
+
+symbol = symbols.first
+symbol.exchange # TSX
+symbol.iex_id # IEX_4656374258322D52
+symbol.region # CA
+symbol.symbol # A-CV
+```
+
+See [#international-symbols](https://iexcloud.io/docs/api/#international-symbols) for returned fields.
+
+### Get Latest Foreign Exchange Rates
+
+Returns an array of foreign exchange rates for a given list of symbols.
+
+```ruby
+rates = client.fx_latest(['USDCAD', 'USDGBP', 'USDJPY'])
+
+rate = rates.first
+rate.symbol # USDCAD
+rate.rate # 1.25674
+rate.timestamp # <Date: 2021-07-23 ((2459419j,0s,0n),+0s,2299161j)>
+```
+
+See [#latest-currency-rates](https://iexcloud.io/docs/api/#latest-currency-rates) for returned fields.
+
 ### Get List
 
 Returns an array of quotes for the top 10 symbols in a specified list.
@@ -460,18 +646,18 @@ client = IEX::Api::Client.new(
 
 The following settings are supported.
 
-setting             | description
---------------------|------------
-user_agent          | User-agent, defaults to _IEX Ruby Client/version_.
-proxy               | Optional HTTP proxy.
-ca_path             | Optional SSL certificates path.
-ca_file             | Optional SSL certificates file.
-logger              | Optional `Logger` instance or logger configuration to log HTTP requests.
-timeout             | Optional open/read timeout in seconds.
-open_timeout        | Optional connection open timeout in seconds.
-publishable_token   | IEX Cloud API publishable token.
-endpoint            | Defaults to `https://cloud.iexapis.com/v1`.
-referer             | Optional string for HTTP `Referer` header, enables token domain management.
+| setting           | description                                                                 |
+| ----------------- | --------------------------------------------------------------------------- |
+| user_agent        | User-agent, defaults to _IEX Ruby Client/version_.                          |
+| proxy             | Optional HTTP proxy.                                                        |
+| ca_path           | Optional SSL certificates path.                                             |
+| ca_file           | Optional SSL certificates file.                                             |
+| logger            | Optional `Logger` instance or logger configuration to log HTTP requests.    |
+| timeout           | Optional open/read timeout in seconds.                                      |
+| open_timeout      | Optional connection open timeout in seconds.                                |
+| publishable_token | IEX Cloud API publishable token.                                            |
+| endpoint          | Defaults to `https://cloud.iexapis.com/v1`.                                 |
+| referer           | Optional string for HTTP `Referer` header, enables token domain management. |
 
 ### Logging
 

data/RELEASING.md

@@ -11,15 +11,15 @@ bundle install
 rake
 ```
 
-Check that the last build succeeded in [Travis CI](https://travis-ci.org/dblock/iex-ruby-client) for all supported platforms.
+Check that the last build succeeded in [Travis CI](https://travis-ci.com/github/dblock/iex-ruby-client) for all supported platforms.
 
 Change "Next" in [CHANGELOG.md](CHANGELOG.md) to the current date.
 
 ```
-### 0.2.2 (7/10/2015)
+### 0.2.2 (2015/10/07)
 ```
 
-Remove the line with "Your contribution here.", since there will be no more contributions to this release.
+Remove the line with "* Your contribution here.", since there will be no more contributions to this release.
 
 Commit your changes.
 

data/UPGRADING.md

@@ -1,6 +1,14 @@
 Upgrading iex-ruby-client
 =========================
 
+### Upgrading to >= 1.6.0
+
+[#110](https://github.com/dblock/iex-ruby-client/pull/110) drops the dependency on `money_helper` in favor of using the `money` library directly.
+
+Previously the `money_helper` library set `Money.locale_backend = :currency` globally. The default is `I18n` which looks up the thousands separator and decimal marker. Depending on your project you may need to set this value if you use `Money#format` without the `thousands_separator` or `decimal_mark` options. You are less likely to require this in a Rails project.
+
+This represents a change in the `money` library's method of handling defaults and is similar to the deprecation warning the library provides until you set `Money.rounding_mode=`.
+
 ### Upgrading to >= 1.0.0
 
 On June 1, 2019, IEX API has been sunset for all non-IEX data. IEX Cloud, a non-Exchange platform, continues to provide access to third-party data sources and requires a token. When upgrading to 1.0.0, create an account and get a `publishable token` from [IEX Cloud Console](https://iexcloud.io).

data/iex-ruby-client.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |s|
   s.add_dependency 'faraday', '>= 0.17'
   s.add_dependency 'faraday_middleware'
   s.add_dependency 'hashie'
-  s.add_dependency 'money_helper'
+  s.add_dependency 'money', '~> 6.0'
   s.add_development_dependency 'rake', '~> 10'
   s.add_development_dependency 'rspec'
   s.add_development_dependency 'rubocop', '0.72.0'

data/lib/iex/api/client.rb

@@ -5,12 +5,17 @@ module IEX
 
     class Client
       include Endpoints::AdvancedStats
+      include Endpoints::BalanceSheet
+      include Endpoints::CashFlow
       include Endpoints::Chart
       include Endpoints::Company
       include Endpoints::Crypto
       include Endpoints::Dividends
       include Endpoints::Earnings
+      include Endpoints::FX
+      include Endpoints::HistoricalPrices
       include Endpoints::Income
+      include Endpoints::KeyStat
       include Endpoints::KeyStats
       include Endpoints::LargestTrades
       include Endpoints::Logo

data/lib/iex/api.rb

@@ -1,11 +1,16 @@
 require_relative 'endpoints/advanced_stats'
+require_relative 'endpoints/balance_sheet'
+require_relative 'endpoints/cash_flow'
 require_relative 'endpoints/chart'
 require_relative 'endpoints/company'
 require_relative 'endpoints/dividends'
 require_relative 'endpoints/earnings'
+require_relative 'endpoints/fx'
+require_relative 'endpoints/historial_prices'
 require_relative 'endpoints/income'
 require_relative 'endpoints/largest_trades'
 require_relative 'endpoints/logo'
+require_relative 'endpoints/key_stat'
 require_relative 'endpoints/key_stats'
 require_relative 'endpoints/news'
 require_relative 'endpoints/ohlc'

data/lib/iex/endpoints/balance_sheet.rb

@@ -0,0 +1,13 @@
+module IEX
+  module Endpoints
+    module BalanceSheet
+      def balance_sheet(symbol, options = {})
+        (get("stock/#{symbol}/balance-sheet", { token: publishable_token }.merge(options))['balancesheet'] || []).map do |data|
+          IEX::Resources::BalanceSheet.new(data)
+        end
+      rescue Faraday::ResourceNotFound => e
+        raise IEX::Errors::SymbolNotFoundError.new(symbol, e.response[:body])
+      end
+    end
+  end
+end

data/lib/iex/endpoints/cash_flow.rb

@@ -0,0 +1,13 @@
+module IEX
+  module Endpoints
+    module CashFlow
+      def cash_flow(symbol, options = {})
+        (get("stock/#{symbol}/cash-flow", { token: publishable_token }.merge(options))['cashflow'] || []).map do |data|
+          IEX::Resources::CashFlow.new(data)
+        end
+      rescue Faraday::ResourceNotFound => e
+        raise IEX::Errors::SymbolNotFoundError.new(symbol, e.response[:body])
+      end
+    end
+  end
+end

data/lib/iex/endpoints/fx.rb

@@ -0,0 +1,13 @@
+module IEX
+  module Endpoints
+    module FX
+      def fx_latest(symbols, options = {})
+        symbols = Array(symbols)
+        response = get('fx/latest', { token: publishable_token, symbols: symbols.join(',') }.merge(options))
+        response.map { |row| IEX::Resources::CurrencyRate.new(row) }
+      rescue Faraday::ResourceNotFound => e
+        raise IEX::Errors::InvalidSymbolsList.new(symbols, e.response[:body])
+      end
+    end
+  end
+end

data/lib/iex/endpoints/historial_prices.rb

@@ -0,0 +1,30 @@
+module IEX
+  module Endpoints
+    module HistoricalPrices
+      def historical_prices(symbol, options = {})
+        if options[:range] == 'date'
+          raise ArgumentError unless options[:date]
+          raise ArgumentError unless options[:chartByDay]
+        end
+
+        options = options.dup
+        # Historical prices IEX endpoint expects dates passed in a specific format - YYYYMMDD
+        options[:date] = options[:date].strftime('%Y%m%d') if options[:date].is_a?(Date)
+
+        path = "stock/#{symbol}/chart"
+        path += "/#{options[:range]}" if options.key?(:range)
+        path += "/#{options[:date]}" if options[:range] == 'date'
+
+        # We only want options to include query params at this point, remove :range and :date
+        options.delete(:range)
+        options.delete(:date)
+
+        (get(path, { token: publishable_token }.merge(options)) || []).map do |data|
+          IEX::Resources::HistorialPrices.new(data)
+        end
+      rescue Faraday::ResourceNotFound => e
+        raise IEX::Errors::SymbolNotFoundError.new(symbol, e.response[:body])
+      end
+    end
+  end
+end

data/lib/iex/endpoints/key_stat.rb

@@ -0,0 +1,14 @@
+module IEX
+  module Endpoints
+    module KeyStat
+      def key_stat(symbol, stat, options = {})
+        result = get("stock/#{symbol}/stats/#{stat}", { token: publishable_token }.merge(options))
+        raise IEX::Errors::StatNotFoundError.new(stat, result) if result.is_a?(Hash)
+
+        result
+      rescue Faraday::ResourceNotFound => e
+        raise IEX::Errors::SymbolNotFoundError.new(symbol, e.response[:body])
+      end
+    end
+  end
+end

data/lib/iex/endpoints/ref_data.rb

@@ -17,6 +17,11 @@ module IEX
         response = get('ref-data/symbols', { token: publishable_token }.merge(options))
         response.map { |row| IEX::Resources::Symbols.new(row) }
       end
+
+      def ref_data_symbols_for_exchange(exchange, options = {})
+        response = get("ref-data/exchange/#{exchange}/symbols", { token: publishable_token }.merge(options))
+        response.map { |row| IEX::Resources::Symbols.new(row) }
+      end
     end
   end
 end

data/lib/iex/errors/invalid_symbols_list.rb

@@ -0,0 +1,14 @@
+module IEX
+  module Errors
+    class InvalidSymbolsList < StandardError
+      attr_reader :symbols
+      attr_reader :response
+
+      def initialize(symbols, response)
+        @response = response
+        @symbols = symbols
+        super "Invalid symbol list: #{symbols.join(',')}"
+      end
+    end
+  end
+end

data/lib/iex/errors/stat_not_found_error.rb

@@ -0,0 +1,13 @@
+module IEX
+  module Errors
+    class StatNotFoundError < StandardError
+      attr_reader :response, :stat
+
+      def initialize(stat, response)
+        @response = response
+        @stat = stat
+        super "Stat #{stat} Not Found"
+      end
+    end
+  end
+end

data/lib/iex/errors.rb

@@ -1,3 +1,5 @@
-require_relative 'errors/symbol_not_found_error'
 require_relative 'errors/client_error'
+require_relative 'errors/invalid_symbols_list'
 require_relative 'errors/permission_denied_error'
+require_relative 'errors/stat_not_found_error'
+require_relative 'errors/symbol_not_found_error'

data/lib/iex/resources/advanced_stats.rb

@@ -28,11 +28,53 @@ module IEX
       property 'forward_pe_ratio', from: 'forwardPERatio'
       property 'pe_high', from: 'peHigh'
       property 'pe_low', from: 'peLow'
-      property 'avg_30_volume', from: 'avg30Volume'
       property 'peg_ratio', from: 'pegRatio'
       property 'week_52_high_date', from: 'week52highDate'
       property 'week_52_low_date', from: 'week52lowDate'
       property 'beta'
+      property 'put_call_ratio', from: 'putCallRatio'
+      property 'company_name', from: 'companyName'
+      property 'market_cap', from: 'marketcap'
+      property 'market_cap_dollar', from: 'marketcap', with: ->(v) { Resource.to_dollar(amount: v) }
+      property 'week_52_high', from: 'week52high'
+      property 'week_52_high_dollar', from: 'week52high', with: ->(v) { Resource.to_dollar(amount: v, ignore_cents: false) }
+      property 'week_52_low', from: 'week52low'
+      property 'week_52_low_dollar', from: 'week52low', with: ->(v) { Resource.to_dollar(amount: v, ignore_cents: false) }
+      property 'week_52_change', from: 'week52change'
+      property 'week_52_change_dollar', from: 'week52change', with: ->(v) { Resource.to_dollar(amount: v, ignore_cents: false) }
+      property 'dividend_yield', from: 'dividendYield'
+      property 'ex_dividend_date', from: 'exDividendDate'
+      property 'shares_outstanding', from: 'sharesOutstanding'
+      property 'float'
+      property 'ttm_eps', from: 'ttmEPS'
+      property 'day_200_moving_avg', from: 'day200MovingAvg'
+      property 'day_50_moving_avg', from: 'day50MovingAvg'
+      property 'year_5_change_percent', from: 'year5ChangePercent'
+      property 'year_5_change_percent_s', from: 'year5ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'year_2_change_percent', from: 'year2ChangePercent'
+      property 'year_2_change_percent_s', from: 'year2ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'year_1_change_percent', from: 'year1ChangePercent'
+      property 'year_1_change_percent_s', from: 'year1ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'ytd_change_percent', from: 'ytdChangePercent'
+      property 'ytd_change_percent_s', from: 'ytdChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'month_6_change_percent', from: 'month6ChangePercent'
+      property 'month_6_change_percent_s', from: 'month6ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'month_3_change_percent', from: 'month3ChangePercent'
+      property 'month_3_change_percent_s', from: 'month3ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'month_1_change_percent', from: 'month1ChangePercent'
+      property 'month_1_change_percent_s', from: 'month1ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'day_5_change_percent', from: 'day5ChangePercent'
+      property 'day_5_change_percent_s', from: 'day5ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'employees'
+      property 'avg_10_volume', from: 'avg10Volume'
+      property 'avg_30_volume', from: 'avg30Volume'
+      property 'ttm_dividend_rate', from: 'ttmDividendRate'
+      property 'max_change_percent', from: 'maxChangePercent'
+      property 'day_30_change_percent', from: 'day30ChangePercent'
+      property 'day_30_change_percent_s', from: 'day30ChangePercent', with: ->(v) { Resource.float_to_percentage(v) }
+      property 'next_dividend_date', from: 'nextDividendDate'
+      property 'next_earnings_date', from: 'nextEarningsDate'
+      property 'pe_ratio', from: 'peRatio'
 
       def initialize(data = {})
         super