Merge pull request #61 from EodHistoricalData/v1.3.2

V1.3.2 - up-to date version of EODHD python library

Author: Enlavan

README.md

@@ -1,4 +1,5 @@
 # Official EODHD APIs Python Library
+
 [Full documentation](https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples/)
 
 This is the official Python library developed by [EODHD](https://eodhd.com) for accessing various financial data via API in your code. If you have any feedback or questions, you can reach out to our support team, available 24/7 via live chat on [our website](https://eodhd.com).
@@ -9,7 +10,6 @@ To access our APIs, you need to register on our site (it’s free) and obtain an
 
 * End of the Day Historical Stock Market Data
 * Live (Delayed) Stock Prices and Macroeconomic Data
-* Bonds Fundamentals
 * Intraday Historical Data
 * Historical Dividends
 * Historical Splits
@@ -28,22 +28,70 @@ To access our APIs, you need to register on our site (it’s free) and obtain an
 
 All functions are described in our [documentation](https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples/).
 
+---
+
+## Additional supported data (latest updates)
+
+The library also includes newer endpoints and Marketplace datasets:
+
+### Financial News (extended)
+
+* **News Sentiment** (daily sentiment data for tickers)
+* **News Word Weights** (weighted keywords from financial news for a ticker over a date range)
+
+### Live v2 US Stocks
+
+* **Extended Quotes (Delayed, exchange-compliant)** via `/us-quote-delayed`
+  Batch tickers supported, optional pagination, JSON/CSV output.
+
+### CBOE Indices Data
+
+* **CBOE Indices List** via `/cboe/indices`
+* **CBOE Index Feed (index + full constituents)** via `/cboe/index`
+  Uses deep-object filters: `filter[index_code]`, `filter[feed_type]`, `filter[date]`.
+
+### Identifier Resolution
+
+* **ID Mapping API** (`CUSIP / ISIN / FIGI / LEI / CIK ↔ Symbol`) via `/id-mapping`
+  Uses deep-object filters (e.g. `filter[symbol]`, `filter[isin]`) and supports pagination.
+
+### Marketplace datasets (UnicornBay)
+
+* **S&P Global / Indices List** via `/mp/unicornbay/spglobal/list`
+* **Index Components (+ optional historical changes)** via `/mp/unicornbay/spglobal/comp/{symbol}`
+
+### Marketplace datasets (US Stock Options Data API)
+
+* **Underlying symbols list** via `/mp/unicornbay/options/underlying-symbols`
+* **Options contracts** via `/mp/unicornbay/options/contracts`
+* **Options EOD data** via `/mp/unicornbay/options/eod`
+  Supports filters, sorting, pagination, field selection, and compact mode (where applicable).
+
+### Technical Indicators (enhanced)
+
+* Includes full function coverage from the current Technical Indicator API, including **BETA** and **DX (alias)**, plus support for:
+
+  * `fmt=json|csv`
+  * `filter` (e.g. `filter=last_ema`) where supported by the endpoint
+
+---
 
 ## Installation
 
 In short:
 
+```bash
 python3 -m pip install eodhd -U
+```
 
 If you have any difficulties, go to our full [documentation](https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples/) with step by step instructions.
 
 ## Sample code and examples
 
 The files below contain examples of available functions:
 
-* example_api.py: describes the functions that can be used in the APIClient class.
-* example_scanner.py: describes the functions that can be used in the ScannerClient class.
-* example_websockets.py: describes the functions that can be used in the WebSocketClient class.
-
+* `example_api.py`: describes the functions that can be used in the `APIClient` class (including new endpoints: Options, CBOE, ID Mapping, Live v2 Extended Quotes, News Word Weights, etc.).
+* `example_scanner.py`: describes the functions that can be used in the `ScannerClient` class.
+* `example_websockets.py`: describes the functions that can be used in the `WebSocketClient` class.
 
 New features will be added to the example files. The most relevant functions can be viewed directly in the code files.

eodhd/APIs/BaseAPI.py

@@ -1,3 +1,5 @@
+# APIs/BaseAPI.py
+
 from json.decoder import JSONDecodeError
 import sys
 from requests import get as requests_get
@@ -6,16 +8,16 @@
 from requests.exceptions import HTTPError as requests_HTTPError
 from rich.console import Console
 
+
 class BaseAPI:
 
     def __init__(self) -> None:
         self._api_url = "https://eodhd.com/api"
         self.console = Console()
 
-
     def _rest_get_method(self, api_key: str, endpoint: str = "", uri: str = "", querystring: str = ""):
         """Generic REST GET"""
-        
+
         if endpoint.strip() == "":
             raise ValueError("endpoint is empty!")
 

eodhd/APIs/BondsFundamentalsAPI.py

@@ -1,10 +1,13 @@
+# APIs/BulkEodSplitsDividendsAPI.py
+
 from .BaseAPI import BaseAPI
 
+
 class BulkEodSplitsDividendsDataAPI(BaseAPI):
 
-    def get_eod_splits_dividends_data(self, api_token: str, country = 'US', type = None, date = None,
-                                   symbols = None, filter = None):
-        
+    def get_eod_splits_dividends_data(self, api_token: str, country='US', type=None, date=None,
+                                      symbols=None, filter=None):
+
         endpoint = 'eod-bulk-last-day'
         uri = f'{country}'
 
@@ -19,5 +22,4 @@ def get_eod_splits_dividends_data(self, api_token: str, country = 'US', type = N
         if filter is not None:
             query_string += '&filter=' + str(filter)
 
-        
-        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string, uri = uri)
+        return self._rest_get_method(api_key=api_token, endpoint=endpoint, querystring=query_string, uri=uri)

eodhd/APIs/BulkEodSplitsDividendsAPI.py

@@ -0,0 +1,108 @@
+#APIs/CBOEIndexFeedAPI.py
+
+from .BaseAPI import BaseAPI
+
+
+class CBOEIndexFeedAPI(BaseAPI):
+    """
+    Wrapper for the CBOE Index Feed endpoint:
+
+        GET /api/cboe/index
+
+    Required (deep object style):
+        filter[index_code]
+        filter[feed_type]
+        filter[date]   (YYYY-MM-DD)
+
+    Optional:
+        fmt (json/xml)
+    """
+
+    def get_cboe_index_data(
+        self,
+        api_token: str,
+        index_code: str,
+        feed_type: str,
+        date: str,
+        fmt: str = None,
+    ):
+        """
+        Parameters
+        ----------
+        api_token : str
+            Your EODHD API token.
+        index_code : str
+            CBOE index code, e.g. "BDE30P"
+        feed_type : str
+            Feed type, e.g. "snapshot_official_closing"
+        date : str
+            Trading date in YYYY-MM-DD format, e.g. "2017-02-01"
+        fmt : str, optional
+            "json" or "xml". If omitted, API default applies (usually json).
+
+        Returns
+        -------
+        dict
+            JSON response with keys like meta, data (array), etc.
+        """
+        if not index_code or not isinstance(index_code, str):
+            raise ValueError("Parameter 'index_code' is required and must be a non-empty string (e.g. 'BDE30P').")
+
+        if not feed_type or not isinstance(feed_type, str):
+            raise ValueError("Parameter 'feed_type' is required and must be a non-empty string (e.g. 'snapshot_official_closing').")
+
+        if not date or not isinstance(date, str):
+            raise ValueError("Parameter 'date' is required and must be a non-empty string in 'YYYY-MM-DD' format (e.g. '2017-02-01').")
+
+        if fmt is not None:
+            fmt = str(fmt).lower()
+            if fmt not in ("json", "xml"):
+                raise ValueError("fmt must be 'json' or 'xml'.")
+
+        endpoint = "cboe/index"
+        query_string = (
+            f"&filter[index_code]={index_code}"
+            f"&filter[feed_type]={feed_type}"
+            f"&filter[date]={date}"
+        )
+
+        if fmt is not None:
+            query_string += f"&fmt={fmt}"
+
+        return self._rest_get_method(
+            api_key=api_token,
+            endpoint=endpoint,
+            querystring=query_string,
+        )
+
+    def get_cboe_indices_list(self, api_token: str, fmt: str = None):
+        """
+        Parameters
+        ----------
+        api_token : str
+            Your EODHD API token.
+        fmt : str, optional
+            "json" or "xml" (default is json on API side)
+
+        Returns
+        -------
+        dict
+            JSON response: { "meta": {...}, "data": [...], "links": {"next": ...} }
+        """
+        if fmt is not None:
+            fmt = str(fmt).lower()
+            if fmt not in ("json", "xml"):
+                raise ValueError("fmt must be 'json' or 'xml'.")
+
+        endpoint = "cboe/indices"
+        query_string = ""
+
+        if fmt is not None:
+            query_string += f"&fmt={fmt}"
+
+        return self._rest_get_method(
+            api_key=api_token,
+            endpoint=endpoint,
+            querystring=query_string,
+        )
+

eodhd/APIs/CBOEIndexFeedAPI.py

@@ -1,14 +1,15 @@
+# APIs/EarningTrendsAPI.py
+
 from .BaseAPI import BaseAPI
 
+
 class EarningTrendsAPI(BaseAPI):
 
     def get_earning_trends_data(self, api_token: str, symbols):
-        
         endpoint = 'calendar/trends'
 
         query_string = ''
 
         query_string += '&symbols=' + str(symbols)
 
-        
-        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string)
+        return self._rest_get_method(api_key=api_token, endpoint=endpoint, querystring=query_string)

eodhd/APIs/EarningTrendsAPI.py

@@ -1,10 +1,13 @@
+# APIs/EconomicEventsDataAPI.py
+
 from .BaseAPI import BaseAPI
 
+
 class EconomicEventsDataAPI(BaseAPI):
 
     def get_economic_events_data(self, api_token: str, date_from: str = None, date_to: str = None,
                                  country: str = None, comparison: str = None, offset: int = None, limit: int = None):
-        
+
         endpoint = 'economic-events'
 
         query_string = ''
@@ -21,5 +24,5 @@ def get_economic_events_data(self, api_token: str, date_from: str = None, date_t
             query_string += "&offset=" + str(offset)
         if limit is not None:
             query_string += "&limit=" + str(limit)
-        
-        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string)
+
+        return self._rest_get_method(api_key=api_token, endpoint=endpoint, querystring=query_string)

eodhd/APIs/EconomicEventsDataAPI.py

@@ -1,30 +1,32 @@
+# APIs/EodHistoricalStockMarketDataAPI.py
+
 from .BaseAPI import BaseAPI
 
+
 class EodHistoricalStockMarketDataAPI(BaseAPI):
 
-    def get_eod_historical_stock_market_data(self, api_token: str, symbol: str, period: str, 
-                                     from_date: str = None, to_date: str = None, order = None):
+    def get_eod_historical_stock_market_data(self, api_token: str, symbol: str, period: str,
+                                             from_date: str = None, to_date: str = None, order=None):
 
         possible_periods = ['d', 'w', 'm']
-        
+
         endpoint = 'eod'
 
         if symbol.strip() == "" or symbol is None:
             raise ValueError("Ticker is empty. You need to add ticker to args")
         if period not in possible_periods:
             raise ValueError("Interval must be in ['d', 'w', 'm'] values")
-        
+
         uri = f'{symbol}'
         query_string = ''
 
         query_string += '&period=' + str(period)
-        
-        if from_date is not None: 
+
+        if from_date is not None:
             query_string += '&from=' + str(from_date)
-        if to_date is not None: 
+        if to_date is not None:
             query_string += '&to=' + str(to_date)
-        if order is not None: 
+        if order is not None:
             query_string += '&order=' + str(order)
 
-        
-        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string, uri = uri)
+        return self._rest_get_method(api_key=api_token, endpoint=endpoint, querystring=query_string, uri=uri)