iex-ruby-client 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63df99e38da35a6d4e4dc799e56d762b74ec873a8123b8c2f598edf6e284dc4d
-  data.tar.gz: 7a0c154efd557d72e50c887aeae7f7076afb5b93fffe10f3af403c8d83858e83
+  metadata.gz: 530d80aa85cb4adbeae6839512b1e3f1bea92795c61a0b12f903518dd456d8f7
+  data.tar.gz: f6bdca5ca322dd32e178b0b7f0d7bd8ccad94ee121c2d4d405adc84e6de75ce4
 SHA512:
-  metadata.gz: 70bd058e8728effc81edecb7da6aa843e725a5648f27024bdf7e0b5458fe5906dc834d3b51d64d23df5df00091e11f334bc4a672b7ac815982885261344271e2
-  data.tar.gz: d1e9e823bc91ece071819487941a5b5d7efa4191178695e75c8ce9bdd65ee3f58c30b14354d9fdb5c839e2905b2a8acf7b5c54655377a25710d6a5cd8c26350a
+  metadata.gz: 2b158981fd7e35729989fb6bb50f9f859e2b905f72eb94442db29866db42e825a27c4646b3c1cdc51182f2fc73b9e268385f128619ddf949cfd7171256980be7
+  data.tar.gz: dc6897f3d8d51572a19aa003fd59fda2ed183bdd688307a466e7bcd2aec7a659974466d1d0ea2015895c4388f625a7466d62215e99d930ff06ab1a21b53631ec

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+### 1.1.2 (2020/03/25)
+
+* [#68](https://github.com/dblock/iex-ruby-client/pull/68): Fix ref_data_isin request with wrong isin - [@bguban](https://github.com/bguban).
+* [#67](https://github.com/dblock/iex-ruby-client/pull/67): Add required ruby version to gemspec - [@wdperson](https://github.com/wdperson).
+* [#66](https://github.com/dblock/iex-ruby-client/pull/66): Fix: KeyStats#week_52_change always returns nil - [@brunjo](https://github.com/brunjo).
+* [#65](https://github.com/dblock/iex-ruby-client/pull/65): Add stock_market_list - [@bguban](https://github.com/bguban).
+* [#64](https://github.com/dblock/iex-ruby-client/pull/64): Add ref_data_isin - [@bguban](https://github.com/bguban).
+
 ### 1.1.1 (2020/03/02)
 
 * [#63](https://github.com/dblock/iex-ruby-client/pull/63): Allow direct API calls with support for secret_token - [@bguban](https://github.com/bguban).

data/README.md

@@ -26,6 +26,8 @@ A Ruby client for the [The IEX Cloud API](https://iexcloud.io/docs/api/).
   - [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 List](#get-list)
   - [Other Requests](#other-requests)
 - [Configuration](#configuration)
 - [Errors](#errors)
@@ -372,6 +374,37 @@ crypto.high_dollar #'$3,590'
 
 See [#crypto](https://iexcloud.io/docs/api/#crypto) for detailed documentation or [crypto.rb](lib/iex/resources/crypto.rb) for returned fields.
 
+### ISIN Mapping
+
+Converts ISIN to IEX Cloud symbols.
+
+```ruby
+symbols = client.ref_data_isin(['US0378331005'])
+
+symbols.first.exchange # NAS
+symbols.first.iex_id # IEX_4D48333344362D52
+symbols.first.region # US
+symbols.first.symbol # AAPL
+```
+
+You can use `mapped: true` option to receive symbols grouped by their ISINs.
+
+```ruby
+client.ref_data_isin(['US0378331005', 'US5949181045'], mapped: true) # {'US0378331005' => [...], 'US5949181045' => [...]}
+```
+
+See [#ISIN Mapping](https://iexcloud.io/docs/api/#isin-mapping) for detailed documentation or [isin_mapping.rb](lib/iex/resources/isin_mapping.rb) for returned fields.
+
+### Get List
+
+Returns an array of quotes for the top 10 symbols in a specified list.
+
+```ruby
+client.stock_market_list(:mostactive) # [{symbol: 'AAPL', ...}, {...}]
+```
+
+See [#list](https://iexcloud.io/docs/api/#list) for detailed documentation or [quote.rb](lib/iex/resources/quote.rb) for returned fields.
+
 ### Other Requests
 
 Public endpoints that aren't yet supported by the client can be called using `client.get`, `client.post`, `client.put` 

data/iex-ruby-client.gemspec

@@ -9,6 +9,7 @@ Gem::Specification.new do |s|
   s.email = 'dblock@dblock.org'
   s.platform = Gem::Platform::RUBY
   s.required_rubygems_version = '>= 1.3.6'
+  s.required_ruby_version = '>= 2.3.0'
   s.files = `git ls-files`.split("\n")
   s.test_files = `git ls-files -- spec/*`.split("\n")
   s.require_paths = ['lib']

data/lib/iex/api.rb

@@ -12,6 +12,8 @@ require_relative 'endpoints/price'
 require_relative 'endpoints/quote'
 require_relative 'endpoints/sectors'
 require_relative 'endpoints/crypto'
+require_relative 'endpoints/ref_data'
+require_relative 'endpoints/stock_market'
 
 require_relative 'api/config'
 require_relative 'api/client'

data/lib/iex/api/client.rb

@@ -15,6 +15,8 @@ module IEX
       include Endpoints::Price
       include Endpoints::Quote
       include Endpoints::Sectors
+      include Endpoints::RefData
+      include Endpoints::StockMarket
 
       include Cloud::Connection
       include Cloud::Request

data/lib/iex/endpoints/ref_data.rb

@@ -0,0 +1,17 @@
+module IEX
+  module Endpoints
+    module RefData
+      def ref_data_isin(isins, options = {})
+        response = post('ref-data/isin', { token: publishable_token, isin: isins }.merge(options))
+
+        if response.is_a?(Hash) # mapped option was set
+          response.transform_values do |rows|
+            rows&.map { |row| IEX::Resources::Symbol.new(row) }
+          end
+        else
+          response.map { |row| IEX::Resources::Symbol.new(row) }
+        end
+      end
+    end
+  end
+end

data/lib/iex/endpoints/stock_market.rb

@@ -0,0 +1,11 @@
+module IEX
+  module Endpoints
+    module StockMarket
+      def stock_market_list(list_type, options = {})
+        get("stock/market/list/#{list_type}", { token: publishable_token }.merge(options)).map do |data|
+          IEX::Resources::Quote.new(data)
+        end
+      end
+    end
+  end
+end

data/lib/iex/resources.rb

@@ -13,3 +13,4 @@ require_relative 'resources/ohlc'
 require_relative 'resources/quote'
 require_relative 'resources/sectors'
 require_relative 'resources/crypto'
+require_relative 'resources/symbol'

data/lib/iex/resources/key_stats.rb

@@ -8,7 +8,7 @@ module IEX
       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'
+      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'

data/lib/iex/resources/symbol.rb

@@ -0,0 +1,10 @@
+module IEX
+  module Resources
+    class Symbol < Resource
+      property 'exchange'
+      property 'iex_id', from: 'iexId'
+      property 'region'
+      property 'symbol'
+    end
+  end
+end

data/lib/iex/version.rb

@@ -1,3 +1,3 @@
 module IEX
-  VERSION = '1.1.1'.freeze
+  VERSION = '1.1.2'.freeze
 end

data/spec/fixtures/iex/ref-data/isin.yml

@@ -5,7 +5,7 @@ http_interactions:
     uri: https://cloud.iexapis.com/v1/ref-data/isin
     body:
       encoding: UTF-8
-      string: '{"isin":["US0378331005"],"token":"test-iex-api-secret-token"}'
+      string: '{"isin":["US0378331005"],"token":"test-iex-api-publishable-token"}'
     headers:
       Accept:
       - application/json; charset=utf-8

data/spec/fixtures/iex/ref-data/isin_mapped.yml

@@ -0,0 +1,57 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://cloud.iexapis.com/v1/ref-data/isin
+    body:
+      encoding: UTF-8
+      string: '{"token":"test-iex-api-publishable-token","isin":["US0378331005","US5949181045"],"mapped":true}'
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      Content-Type:
+      - application/json; charset=utf-8
+      User-Agent:
+      - IEX Ruby Client/1.1.2
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 04 Mar 2020 09:45:05 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - ctoken=b93327e2c9b4432f9c7ecb36396dcd4c; Max-Age=43200; Path=/; Expires=Wed,
+        04 Mar 2020 21:45:05 GMT
+      Iexcloud-Messages-Used:
+      - '100'
+      Iexcloud-Premium-Messages-Used:
+      - '0'
+      X-Content-Type-Options:
+      - nosniff
+      Strict-Transport-Security:
+      - max-age=15768000
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Credentials:
+      - 'true'
+      Access-Control-Allow-Methods:
+      - GET, OPTIONS
+      Access-Control-Allow-Headers:
+      - Origin, X-Requested-With, Content-Type, Accept
+    body:
+      encoding: ASCII-8BIT
+      string: '{"US0378331005":[{"symbol":"AAPL","region":"US","exchange":"NAS","iexId":"IEX_4D48333344362D52"},{"symbol":"APC-GY","region":"DE","exchange":"ETR","iexId":"IEX_464D46474C312D52"}],"US5949181045":[{"symbol":"MSFT","region":"US","exchange":"NAS","iexId":"IEX_5038523343322D52"},{"symbol":"MSF-GY","region":"DE","exchange":"ETR","iexId":"IEX_4C42583859482D52"},{"symbol":"MSF-BB","region":"BE","exchange":"BRU","iexId":"IEX_5833345950432D52"}]}'
+    http_version: null
+  recorded_at: Wed, 04 Mar 2020 09:45:05 GMT
+recorded_with: VCR 5.1.0

data/spec/fixtures/iex/ref-data/wrong_isin_mapped.yml

@@ -0,0 +1,57 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://cloud.iexapis.com/v1/ref-data/isin
+    body:
+      encoding: UTF-8
+      string: '{"token":"test-iex-api-publishable-token","isin":["WRONG12345"],"mapped":true}'
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      Content-Type:
+      - application/json; charset=utf-8
+      User-Agent:
+      - IEX Ruby Client/1.1.2
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 25 Mar 2020 10:15:28 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '19'
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - ctoken=9ddb19d57dea471f9855bacdb85a96a5; Max-Age=43200; Path=/; Expires=Wed,
+        25 Mar 2020 22:15:28 GMT
+      Iexcloud-Messages-Used:
+      - '100'
+      Iexcloud-Premium-Messages-Used:
+      - '0'
+      X-Content-Type-Options:
+      - nosniff
+      Strict-Transport-Security:
+      - max-age=15768000
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Credentials:
+      - 'true'
+      Access-Control-Allow-Methods:
+      - GET, OPTIONS
+      Access-Control-Allow-Headers:
+      - Origin, X-Requested-With, Content-Type, Accept
+    body:
+      encoding: UTF-8
+      string: '{"WRONG12345":null}'
+    http_version: null
+  recorded_at: Wed, 25 Mar 2020 10:15:28 GMT
+recorded_with: VCR 5.1.0

data/spec/fixtures/iex/stock_market/list_mostactive.yml

@@ -0,0 +1,76 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cloud.iexapis.com/v1/stock/market/list/mostactive?token=test-iex-api-publishable-token
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json; charset=utf-8
+      Content-Type:
+      - application/json; charset=utf-8
+      User-Agent:
+      - IEX Ruby Client/1.1.2
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 04 Mar 2020 13:00:24 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - ctoken=82c15565434a4dada8483b258390943b; Max-Age=43200; Path=/; Expires=Thu,
+        05 Mar 2020 01:00:24 GMT
+      Iexcloud-Messages-Used:
+      - '20'
+      Iexcloud-Premium-Messages-Used:
+      - '0'
+      X-Content-Type-Options:
+      - nosniff
+      Strict-Transport-Security:
+      - max-age=15768000
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Credentials:
+      - 'true'
+      Access-Control-Allow-Methods:
+      - GET, OPTIONS
+      Access-Control-Allow-Headers:
+      - Origin, X-Requested-With, Content-Type, Accept
+    body:
+      encoding: ASCII-8BIT
+      string: '[{"symbol":"AMD","companyName":"Advanced Micro Devices, Inc.","primaryExchange":"NASDAQ","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":46.75,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269200736,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":47.46,"previousVolume":102324726,"change":-0.71,"changePercent":-0.01496,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":69781992,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":54681605000,"peRatio":152.73,"week52High":59.27,"week52Low":21.04,"ytdChange":-0.062822,"lastTradeTime":1583269200603,"isUSMarketOpen":false},{"symbol":"BAC","companyName":"Bank
+        of America Corp.","primaryExchange":"New York Stock Exchange","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":27.75,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269208334,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":29.37,"previousVolume":147776301,"change":-1.62,"changePercent":-0.05516,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":59385616,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":242216707500,"peRatio":10.03,"week52High":35.72,"week52Low":26.21,"ytdChange":-0.27654,"lastTradeTime":1583269208300,"isUSMarketOpen":false},{"symbol":"INO","companyName":"Inovio
+        Pharmaceuticals, Inc.","primaryExchange":"NASDAQ","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":7.45,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269200743,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":4.39,"previousVolume":16179954,"change":3.06,"changePercent":0.69704,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":18795754,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":755139450,"peRatio":-6.32,"week52High":7.48,"week52Low":1.92,"ytdChange":2.017912,"lastTradeTime":1583269200378,"isUSMarketOpen":false},{"symbol":"GE","companyName":"General
+        Electric Co.","primaryExchange":"New York Stock Exchange","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":10.88,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269204858,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":11.21,"previousVolume":124802207,"change":-0.33,"changePercent":-0.02944,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":71758664,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":95093702400,"peRatio":143.16,"week52High":13.26,"week52Low":7.65,"ytdChange":-0.117453,"lastTradeTime":1583269204815,"isUSMarketOpen":false},{"symbol":"F","companyName":"Ford
+        Motor Co.","primaryExchange":"New York Stock Exchange","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":6.97,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269470045,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":7.2,"previousVolume":96766032,"change":-0.23,"changePercent":-0.03194,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":79183546,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":27636398500,"peRatio":237.88,"week52High":10.56,"week52Low":6.67,"ytdChange":-0.29202500000000003,"lastTradeTime":1583269200123,"isUSMarketOpen":false},{"symbol":"AAPL","companyName":"Apple,
+        Inc.","primaryExchange":"NASDAQ","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":289.32,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269200249,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":298.81,"previousVolume":85349339,"change":-9.49,"changePercent":-0.03176,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":41771302,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":1265913873600,"peRatio":22.68,"week52High":327.85,"week52Low":169.5,"ytdChange":-0.06848399999999999,"lastTradeTime":1583269200389,"isUSMarketOpen":false},{"symbol":"MSFT","companyName":"Microsoft
+        Corp.","primaryExchange":"NASDAQ","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":164.51,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269200720,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":172.79,"previousVolume":71030810,"change":-8.28,"changePercent":-0.04792,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":43623452,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":1251271285500,"peRatio":28.37,"week52High":190.7,"week52Low":108.8,"ytdChange":-0.023700999999999996,"lastTradeTime":1583269200282,"isUSMarketOpen":false},{"symbol":"T","companyName":"AT&T,
+        Inc.","primaryExchange":"New York Stock Exchange","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":36.3,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269431180,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":37.18,"previousVolume":68432790,"change":-0.88,"changePercent":-0.02367,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":39604055,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":260375544000,"peRatio":19.09,"week52High":39.7,"week52Low":29.67,"ytdChange":-0.089548,"lastTradeTime":1583269199998,"isUSMarketOpen":false},{"symbol":"XOM","companyName":"Exxon
+        Mobil Corp.","primaryExchange":"New York Stock Exchange","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":51.3,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269428549,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":53.88,"previousVolume":38127634,"change":-2.58,"changePercent":-0.04788,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":24981447,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":217111347000,"peRatio":15.29,"week52High":83.49,"week52Low":48.01,"ytdChange":-0.324326,"lastTradeTime":1583269199431,"isUSMarketOpen":false},{"symbol":"INTC","companyName":"Intel
+        Corp.","primaryExchange":"NASDAQ","calculationPrice":"close","open":null,"openTime":null,"close":null,"closeTime":null,"high":null,"low":null,"latestPrice":55.97,"latestSource":"Close","latestTime":"March
+        3, 2020","latestUpdate":1583269200750,"latestVolume":null,"iexRealtimePrice":0,"iexRealtimeSize":0,"iexLastUpdated":0,"delayedPrice":null,"delayedPriceTime":null,"oddLotDelayedPrice":null,"oddLotDelayedPriceTime":null,"extendedPrice":null,"extendedChange":null,"extendedChangePercent":null,"extendedPriceTime":null,"previousClose":58.18,"previousVolume":43140304,"change":-2.21,"changePercent":-0.03799,"volume":null,"iexMarketPercent":null,"iexVolume":0,"avgTotalVolume":28110407,"iexBidPrice":0,"iexBidSize":0,"iexAskPrice":0,"iexAskSize":0,"marketCap":239383690000,"peRatio":11.7,"week52High":69.29,"week52Low":42.86,"ytdChange":-0.118036,"lastTradeTime":1583269200602,"isUSMarketOpen":false}]'
+    http_version: null
+  recorded_at: Wed, 04 Mar 2020 13:00:24 GMT
+recorded_with: VCR 5.1.0

data/spec/iex/endpoints/key_stats_spec.rb

@@ -19,6 +19,7 @@ describe IEX::Resources::KeyStats do
       expect(subject.week_52_high_dollar).to eq '$136.04'
       expect(subject.week_52_low).to eq 95.92
       expect(subject.week_52_low_dollar).to eq '$95.92'
+      expect(subject.week_52_change).to eq 0.371641
       expect(subject.week_52_change_dollar).to eq '$0.37'
     end
 

data/spec/iex/endpoints/ref_data_spec.rb

@@ -3,14 +3,38 @@ require 'spec_helper'
 describe IEX::Api::Client do
   include_context 'client'
 
-  describe 'ISIN Mapping', vcr: { cassette_name: 'ref-data/isin' } do
-    subject do
-      client.post('ref-data/isin', isin: ['US0378331005'], token: client.secret_token)
+  describe '#ref_data_isin', vcr: { cassette_name: 'ref-data/isin' } do
+    context 'without options' do
+      subject { client.ref_data_isin(['US0378331005']) }
+
+      it 'converts ISIN to IEX Cloud symbols' do
+        expect(subject.count).to eq(2)
+        expect(subject.first).to eq('exchange' => 'NAS', 'iex_id' => 'IEX_4D48333344362D52', 'region' => 'US', 'symbol' => 'AAPL')
+        expect(subject.last).to eq('exchange' => 'ETR', 'iex_id' => 'IEX_464D46474C312D52', 'region' => 'DE', 'symbol' => 'APC-GY')
+      end
     end
-    it 'retrieves a ticker by ISIN' do
-      expect(subject.count).to eq(2)
-      expect(subject.first).to eq('exchange' => 'NAS', 'iexId' => 'IEX_4D48333344362D52', 'region' => 'US', 'symbol' => 'AAPL')
-      expect(subject.last).to eq('exchange' => 'ETR', 'iexId' => 'IEX_464D46474C312D52', 'region' => 'DE', 'symbol' => 'APC-GY')
+
+    context 'with mapped option', vcr: { cassette_name: 'ref-data/isin_mapped' } do
+      subject { client.ref_data_isin(%w[US0378331005 US5949181045], mapped: true) }
+
+      it 'converts ISINs to IEX Cloud symbols mapped by ISIN' do
+        expect(subject.keys).to contain_exactly('US0378331005', 'US5949181045')
+
+        expect(subject['US0378331005'].first).to eq('exchange' => 'NAS', 'iex_id' => 'IEX_4D48333344362D52', 'region' => 'US', 'symbol' => 'AAPL')
+        expect(subject['US0378331005'].last).to eq('exchange' => 'ETR', 'iex_id' => 'IEX_464D46474C312D52', 'region' => 'DE', 'symbol' => 'APC-GY')
+
+        expect(subject['US5949181045'][0]).to eq('exchange' => 'NAS', 'iex_id' => 'IEX_5038523343322D52', 'region' => 'US', 'symbol' => 'MSFT')
+        expect(subject['US5949181045'][1]).to eq('exchange' => 'ETR', 'iex_id' => 'IEX_4C42583859482D52', 'region' => 'DE', 'symbol' => 'MSF-GY')
+        expect(subject['US5949181045'][2]).to eq('exchange' => 'BRU', 'iex_id' => 'IEX_5833345950432D52', 'region' => 'BE', 'symbol' => 'MSF-BB')
+      end
+
+      context 'with wrong ISIN', vcr: { cassette_name: 'ref-data/wrong_isin_mapped' } do
+        subject { client.ref_data_isin(%w[WRONG12345], mapped: true) }
+
+        it 'returns nil value for given ISIN' do
+          expect(subject).to eq('WRONG12345' => nil)
+        end
+      end
     end
   end
 end

data/spec/iex/endpoints/stock_market_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe IEX::Endpoints::StockMarket do
+  include_context 'client'
+
+  describe '#stock_market_list', vcr: { cassette_name: 'stock_market/list_mostactive' } do
+    subject { client.stock_market_list(:mostactive) }
+
+    it 'retrieves a list of quotes' do
+      expect(subject).to all(be_a(IEX::Resources::Quote))
+      expect(subject.map(&:symbol)).to match_array(%w[AAPL AMD BAC F GE INO INTC MSFT T XOM])
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iex-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors:
 - Daniel Doubrovkine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-02 00:00:00.000000000 Z
+date: 2020-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -178,7 +178,9 @@ files:
 - lib/iex/endpoints/ohlc.rb
 - lib/iex/endpoints/price.rb
 - lib/iex/endpoints/quote.rb
+- lib/iex/endpoints/ref_data.rb
 - lib/iex/endpoints/sectors.rb
+- lib/iex/endpoints/stock_market.rb
 - lib/iex/errors.rb
 - lib/iex/errors/client_error.rb
 - lib/iex/errors/permission_denied_error.rb
@@ -199,6 +201,7 @@ files:
 - lib/iex/resources/quote.rb
 - lib/iex/resources/resource.rb
 - lib/iex/resources/sectors.rb
+- lib/iex/resources/symbol.rb
 - lib/iex/version.rb
 - spec/fixtures/iex/chart/1d.yml
 - spec/fixtures/iex/chart/20190306.yml
@@ -236,8 +239,11 @@ files:
 - spec/fixtures/iex/quote/invalid.yml
 - spec/fixtures/iex/quote/msft.yml
 - spec/fixtures/iex/ref-data/isin.yml
+- spec/fixtures/iex/ref-data/isin_mapped.yml
+- spec/fixtures/iex/ref-data/wrong_isin_mapped.yml
 - spec/fixtures/iex/sectors/invalid.yml
 - spec/fixtures/iex/sectors/sectors-performance.yml
+- spec/fixtures/iex/stock_market/list_mostactive.yml
 - spec/iex/client_spec.rb
 - spec/iex/config_spec.rb
 - spec/iex/endpoints/chart_spec.rb
@@ -255,6 +261,7 @@ files:
 - spec/iex/endpoints/quote_spec.rb
 - spec/iex/endpoints/ref_data_spec.rb
 - spec/iex/endpoints/sectors_spec.rb
+- spec/iex/endpoints/stock_market_spec.rb
 - spec/iex/resources/resource_spec.rb
 - spec/iex/version_spec.rb
 - spec/spec_helper.rb
@@ -272,14 +279,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: IEX Finance API Ruby client with support for retrieving stock quotes.
@@ -320,8 +327,11 @@ test_files:
 - spec/fixtures/iex/quote/invalid.yml
 - spec/fixtures/iex/quote/msft.yml
 - spec/fixtures/iex/ref-data/isin.yml
+- spec/fixtures/iex/ref-data/isin_mapped.yml
+- spec/fixtures/iex/ref-data/wrong_isin_mapped.yml
 - spec/fixtures/iex/sectors/invalid.yml
 - spec/fixtures/iex/sectors/sectors-performance.yml
+- spec/fixtures/iex/stock_market/list_mostactive.yml
 - spec/iex/client_spec.rb
 - spec/iex/config_spec.rb
 - spec/iex/endpoints/chart_spec.rb
@@ -339,6 +349,7 @@ test_files:
 - spec/iex/endpoints/quote_spec.rb
 - spec/iex/endpoints/ref_data_spec.rb
 - spec/iex/endpoints/sectors_spec.rb
+- spec/iex/endpoints/stock_market_spec.rb
 - spec/iex/resources/resource_spec.rb
 - spec/iex/version_spec.rb
 - spec/spec_helper.rb