Added get_events and tests to client library.

RV1:
- added get_events function to client library
- added tests.

RV2:
- changed get_ticker_events to get_ticker_history

RV3:
- changed history to events and modifed classes to meet new requirements.

Author: antdjohns

polygon/rest/models/tickers.py

@@ -185,3 +185,35 @@ class TickerTypes:
     @staticmethod
     def from_dict(d):
         return TickerTypes(**d)
+
+
+@modelclass
+class TickerChange:
+    ticker: str
+
+    @staticmethod
+    def from_dict(d):
+        return TickerChange(**d)
+
+
+@modelclass
+class TickerChangeEvent:
+    type: str
+    date: str
+    ticker_change: TickerChange
+
+    @staticmethod
+    def from_dict(d):
+        return TickerChangeEvent(**d)
+
+
+@modelclass
+class TickerChangeResults:
+    name: str
+    figi: str
+    cik: str
+    events: Optional[List[TickerChangeEvent]] = None
+
+    @staticmethod
+    def from_dict(d):
+        return TickerChangeResults(**d)

polygon/rest/reference.py

@@ -4,6 +4,7 @@
     MarketHoliday,
     MarketStatus,
     Ticker,
+    TickerChangeResults,
     TickerDetails,
     TickerNews,
     TickerTypes,
@@ -143,6 +144,30 @@ def get_ticker_details(
             result_key="results",
         )
 
+    def get_ticker_events(
+        self,
+        ticker: Optional[str] = None,
+        params: Optional[Dict[str, Any]] = None,
+        raw: bool = False,
+    ) -> Union[TickerChangeResults, HTTPResponse]:
+
+        """
+        Get event history of ticker given particular point in time.
+        :param ticker: The ticker symbol of the asset.
+        :param params: Additional query parameters
+        :param raw: Return raw object instead of results object.
+        :return: Ticker Event VX
+        """
+        url = f"/vX/reference/tickers/{ticker}/events"
+
+        return self._get(
+            path=url,
+            params=params,
+            deserializer=TickerChangeResults.from_dict,
+            result_key="results",
+            raw=raw,
+        )
+
     def list_ticker_news(
         self,
         ticker: Optional[str] = None,

test_rest/mocks/vX/reference/tickers/META/events.json

@@ -0,0 +1,25 @@
+{
+  "results":  {
+    "name": "Meta Platforms, Inc. Class A Common Stock",
+    "figi": "BBG000MM2P62",
+    "cik": "0001326801",
+    "events": [
+      {
+        "ticker_change": {
+          "ticker": "META"
+        },
+        "type": "ticker_change",
+        "date": "2022-06-11"
+      },
+      {
+        "ticker_change": {
+          "ticker": "FB"
+        },
+        "type": "ticker_change",
+        "date": "2012-05-18"
+      }
+    ]
+  },
+  "status": "OK",
+  "request_id": "8c911ff1-5ca8-41e8-9bbf-e625141caacc"
+}

test_rest/test_tickers.py

@@ -3,6 +3,8 @@
     TickerDetails,
     TickerNews,
     TickerTypes,
+    TickerChangeEvent,
+    TickerChangeResults,
     Publisher,
     Branding,
     CompanyAddress,
@@ -230,3 +232,25 @@ def test_get_ticker_types(self):
         ]
 
         self.assertEqual(types, expected)
+
+    def test_get_ticker_events_ticker_change(self):
+        events = self.c.get_ticker_events(ticker="META")
+        expected = TickerChangeResults(
+            name="Meta Platforms, Inc. Class A Common Stock",
+            figi="BBG000MM2P62",
+            cik="0001326801",
+            events=[
+                {
+                    "ticker_change": {"ticker": "META"},
+                    "type": "ticker_change",
+                    "date": "2022-06-11",
+                },
+                {
+                    "ticker_change": {"ticker": "FB"},
+                    "type": "ticker_change",
+                    "date": "2012-05-18",
+                },
+            ],
+        )
+
+        self.assertEqual(expected, events)