update polygon financials to V2

https://polygon.io/docs/get_v2_reference_financials__stocksTicker__anchor

Author: shlomiku

alpaca_trade_api/polygon/rest.py

@@ -1,4 +1,5 @@
 import datetime
+from enum import Enum
 from typing import List
 import dateutil.parser
 import requests
@@ -15,6 +16,24 @@
 Symbols = List[Symbol]
 
 
+class FinancialsReportType(Enum):
+    "https://polygon.io/docs/get_v2_reference_financials__stocksTicker__anchor"
+    Y = "Year"
+    YA = "Year annualized"
+    Q = "Quarter"
+    QA = "Quarter Annualized"
+    T = "Trailing twelve months"
+    TA = "trailing twelve months annualized"
+
+
+class FinancialsSort(Enum):
+    "https://polygon.io/docs/get_v2_reference_financials__stocksTicker__anchor"
+    ReportPeriodAsc = "reportPeriod"
+    ReportPeriodDesc = "-reportPeriod"
+    CalendarDateAsc = "calendarDate"
+    CalendarDateDesc = "-calendarDate"
+
+
 def _is_list_like(o) -> bool:
     """
     returns True if o is either a list, a set or a tuple
@@ -273,6 +292,19 @@ def earnings(self, symbol: str) -> Earnings:
     def financials(self, symbol: str) -> Financials:
         return self._get_symbol(symbol, 'financials', Financials)
 
+    def financials_v2(self, symbol: str,
+                      limit: int,
+                      report_type: FinancialsReportType,
+                      sort: FinancialsSort
+                      ) -> Financials:
+        path = f'/reference/financials/{symbol}'
+        params = {"limit":    limit,
+                  "type": report_type.name,
+                  "sort":  sort.value,
+                  }
+        return Financials(self.get(path, version='v2',
+                                       params=params)['results'])
+
     def news(self, symbol: str) -> NewsList:
         path = '/meta/symbols/{}/news'.format(symbol)
         return NewsList(self.get(path))