Merge pull request #159 from timkpaine/isin

add isin lookup

README.md

@@ -468,6 +468,8 @@ Currently, the following methods are implemented:
 - [exchangesDF](https://iexcloud.io/docs/api/#u-s-exchanges)
 - [holidays](https://iexcloud.io/docs/api/#u-s-holidays-and-trading-dates)
 - [holidaysDF](https://iexcloud.io/docs/api/#u-s-holidays-and-trading-dates)
+- [isinLookup](https://iexcloud.io/docs/api/#isin-mapping)
+- [isinLookupDF](https://iexcloud.io/docs/api/#isin-mapping)
 
 ### Other Reference
 - corporateActions

pyEX/client.py

@@ -251,6 +251,8 @@
     cryptoSymbols,
     cryptoSymbolsDF,
     cryptoSymbolsList,
+    isinLookup,
+    isinLookupDF,
     corporateActions,
     corporateActionsDF,
     refDividends,
@@ -819,6 +821,8 @@
     ("fxSymbolsList", fxSymbolsList),
     ("optionsSymbolsList", optionsSymbolsList),
     ("cryptoSymbolsList", cryptoSymbolsList),
+    ("isinLookup", isinLookup),
+    ("isinLookupDF", isinLookupDF),
     ("corporateActions", corporateActions),
     ("corporateActionsDF", corporateActionsDF),
     ("refDividends", refDividends),

pyEX/refdata/__init__.py

@@ -23,6 +23,8 @@
     fxSymbolsList,
     optionsSymbolsList,
     cryptoSymbolsList,
+    isinLookup,
+    isinLookupDF,
 )
 from .refdata import (
     corporateActions,

pyEX/refdata/symbols.py

@@ -276,3 +276,25 @@ def optionsSymbolsList(token="", version=""):
 @wraps(cryptoSymbols)
 def cryptoSymbolsList(token="", version=""):
     return [x["symbol"] for x in cryptoSymbols(token, version, filter="symbol")]
+
+
+def isinLookup(isin, token="", version=""):
+    """This call returns an array of symbols that IEX Cloud supports for API calls.
+
+    https://iexcloud.io/docs/api/#isin-mapping
+    8am, 9am, 12pm, 1pm UTC daily
+
+    Args:
+        isin (str): isin to lookup
+        token (str): Access token
+        version (str): API version
+
+    Returns:
+        dict or DataFrame or list: result
+    """
+    return _getJson("ref-data/isin?isin={}".format(isin), token, version)
+
+
+@wraps(isinLookup)
+def isinLookupDF(isin, token="", version=""):
+    return pd.DataFrame(isinLookup(isin=isin, token=token, version=version))