Merge pull request #47 from EodHistoricalData/dev

added new funcs

Author: Nawado

eodhd/APIs/FinancialNewsAPI.py

@@ -42,4 +42,22 @@ def financial_news(self, api_token: str, s = None, t = None, from_date = None, t
         if to_date is not None:
             query_string += '&to=' + str(to_date)
 
-        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)
+    
+    def get_sentiment(self, api_token: str, s: str, from_date: str = None, to_date: str = None):
+
+        endpoint = 'sentiments'
+
+        query_string = ''
+
+        if s is None:
+            raise ValueError("s argument is empty. You need to add s to args")
+        
+        query_string += '&s=' + str(s)
+        
+        if from_date is not None:
+            query_string += '&from=' + str(from_date)
+        if to_date is not None:
+            query_string += '&to=' + str(to_date)
+
+        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string)

eodhd/APIs/HistoricalMarketCapitalizationAPI.py

@@ -0,0 +1,18 @@
+from .BaseAPI import BaseAPI
+
+class HistoricalMarketCapitalization(BaseAPI):
+
+    def get_historical_market_capitalization_data(self, api_token: str, ticker, from_date: str = None, to_date: str = None):
+        
+        endpoint = 'historical-market-cap'
+        uri = f'{ticker}'
+
+        query_string = ''
+
+        if from_date is not None:
+            query_string += '&from=' + str(from_date)
+        if to_date is not None:
+            query_string += '&to=' + str(to_date)
+
+        
+        return self._rest_get_method(api_key = api_token, endpoint = endpoint, querystring = query_string, uri = uri)

eodhd/APIs/__init__.py

@@ -19,4 +19,5 @@
 from .OptionsDataAPI import OptionsDataAPI
 from .IntradayDataAPI import IntradayDataAPI
 from .EodHistoricalStockMarketDataAPI import EodHistoricalStockMarketDataAPI
-from .StockMarketTickDataAPI import StockMarketTickDataAPI
+from .StockMarketTickDataAPI import StockMarketTickDataAPI
+from .HistoricalMarketCapitalizationAPI import HistoricalMarketCapitalization

eodhd/__init__.py

@@ -8,4 +8,4 @@
 
 
 # Version of eodhd package
-__version__ = "1.0.27"
+__version__ = "1.0.28"

eodhd/apiclient.py

@@ -37,6 +37,7 @@
 from eodhd.APIs import IntradayDataAPI
 from eodhd.APIs import EodHistoricalStockMarketDataAPI
 from eodhd.APIs import StockMarketTickDataAPI
+from eodhd.APIs import HistoricalMarketCapitalization
 
 # minimal traceback
 sys.tracebacklimit = 1
@@ -898,8 +899,8 @@ def get_stock_market_tick_data(
     ):
         """
         Available args:
-            symbol - , for example, AAPL.US, consists of two parts: {SYMBOL_NAME}.{EXCHANGE_ID}.
-                This API works only for US exchanges for the moment,
+            symbol - for example, AAPL.US, consists of two parts: {SYMBOL_NAME}.{EXCHANGE_ID}. 
+                This API works only for US exchanges for the moment, 
                 then you can use 'AAPL' or 'AAPL.US' to get the data as well for other US tickers.
             from_timestamp and to_timestamp - use these parameters to filter data by datetime.
                 Parameters should be passed in UNIX time with UTC timezone,
@@ -915,7 +916,53 @@ def get_stock_market_tick_data(
             from_timestamp=from_timestamp,
             limit=limit
         )
+    
+    def get_sentiment(
+        self,
+        s,
+        from_date=None,
+        to_date=None
+    ):
+        """
+        Available args:
+            s [REQUIRED] -  parameter to your URL and you will be able to get data for multiple tickers at one request, 
+                            all tickers should be separated with a comma.
+            from_date and to_date [NOT REQUIRED] - the format is ‘YYYY-MM-DD’. 
+                            If you need data from Jan 5, 2022 to Feb 10, 2022, you should use from=2022-01-05 and to=2022-02-10.
+            For more information visit: https://eodhd.com/financial-apis/sentimental-data-financial-api/
+            List of supported exchanges: https://eodhd.com/financial-apis/exchanges-api-list-of-tickers-and-trading-hours/
+        """
+
+        api_call = FinancialNewsAPI()
+        return api_call.get_sentiment(
+            api_token=self._api_key,
+            s=s,
+            from_date=from_date,
+            to_date=to_date
+        )
 
+    def get_historical_market_capitalization_data(
+        self,
+        ticker,
+        from_date=None,
+        to_date=None
+    ):
+        """
+        Available args:
+            ticker [REQUIRED] -  is the ticker code and it consists of two parts: {SYMBOL_NAME}.{EXCHANGE_ID}, 
+                        you can use a US ticker code with or without the exchange part (AAPL or AAPL.US)
+            from_date and to_date [NOT REQUIRED] - the format is ‘YYYY-MM-DD’. 
+                            If you need data from Jan 5, 2022 to Feb 10, 2022, you should use from=2022-01-05 and to=2022-02-10.
+            For more information visit: https://eodhd.com/financial-apis/historical-market-capitalization-api/
+        """
+
+        api_call = HistoricalMarketCapitalization()
+        return api_call.get_historical_market_capitalization_data(
+            api_token=self._api_key,
+            ticker=ticker,
+            from_date=from_date,
+            to_date=to_date
+        )
 
 class ScannerClient:
     """Scanner class"""

example_api.py

@@ -133,5 +133,12 @@ def main() -> None:
     resp = api.get_stock_market_tick_data(from_timestamp = '1627896900', to_timestamp = '1630575300', symbol = 'AAPL', limit = 1)
     print(resp)
 
+    resp = api.get_sentiment(s = 'btc-usd.cc', from_date = '2023-01-01', to_date = '2023-01-15')
+    print(resp)
+
+    resp = api.get_historical_market_capitalization_data(ticker = 'AAPL.US', from_date = '2023-01-01', to_date = '2023-01-15')
+    print(resp)
+
+
 if __name__ == "__main__":
     main()

setup.py

@@ -16,7 +16,7 @@
 # This call to setup() does all the work
 setup(
     name="eodhd",
-    version="1.0.27",
+    version="1.0.28",
     description="Official EODHD API Python Library",
     long_description=long_description,
     long_description_content_type="text/markdown",