|
| 1 | +from typing import Dict |
| 2 | + |
1 | 3 | import requests |
2 | 4 |
|
| 5 | +from polygon.rest import models |
| 6 | +from polygon.rest.models import unmarshal |
| 7 | + |
3 | 8 |
|
4 | 9 | class RESTClient: |
| 10 | + """ This is a custom generated class """ |
5 | 11 | DEFAULT_HOST = "api.polygon.io" |
6 | 12 |
|
7 | | - def __init__(self, auth_key): |
| 13 | + def __init__(self, auth_key: str): |
8 | 14 | self.auth_key = auth_key |
9 | 15 | self.url = "https://" + self.DEFAULT_HOST |
10 | 16 |
|
11 | 17 | self._session = requests.Session() |
12 | 18 | self._session.params["apiKey"] = self.auth_key |
13 | 19 |
|
| 20 | + def _handle_response(self, response_type: str, endpoint: str, params: Dict[str, str]) -> models.Definition: |
| 21 | + resp: requests.Response = self._session.get(endpoint, params=params) |
| 22 | + if resp.status_code == 200: |
| 23 | + return unmarshal.unmarshal_json(response_type, resp.json()) |
| 24 | + else: |
| 25 | + resp.raise_for_status() |
| 26 | + |
14 | 27 | def tickers(self, **query_params): |
15 | 28 | endpoint = f"{self.url}/v2/reference/tickers" |
16 | | - return self._session.get(endpoint, params=query_params).json() |
| 29 | + return self._handle_response("TickersApiResponse", endpoint, query_params) |
17 | 30 |
|
18 | 31 | def ticker_types(self, **query_params): |
19 | 32 | endpoint = f"{self.url}/v2/reference/types" |
20 | | - return self._session.get(endpoint, params=query_params).json() |
| 33 | + return self._handle_response("TickerTypesApiResponse", endpoint, query_params) |
21 | 34 |
|
22 | 35 | def ticker_details(self, symbol, **query_params): |
23 | 36 | endpoint = f"{self.url}/v1/meta/symbols/{symbol}/company" |
24 | | - return self._session.get(endpoint, params=query_params).json() |
| 37 | + return self._handle_response("TickerDetailsApiResponse", endpoint, query_params) |
25 | 38 |
|
26 | 39 | def ticker_news(self, symbol, **query_params): |
27 | 40 | endpoint = f"{self.url}/v1/meta/symbols/{symbol}/news" |
28 | | - return self._session.get(endpoint, params=query_params).json() |
| 41 | + return self._handle_response("TickerNewsApiResponse", endpoint, query_params) |
29 | 42 |
|
30 | 43 | def markets(self, **query_params): |
31 | 44 | endpoint = f"{self.url}/v2/reference/markets" |
32 | | - return self._session.get(endpoint, params=query_params).json() |
| 45 | + return self._handle_response("MarketsApiResponse", endpoint, query_params) |
33 | 46 |
|
34 | 47 | def locales(self, **query_params): |
35 | 48 | endpoint = f"{self.url}/v2/reference/locales" |
36 | | - return self._session.get(endpoint, params=query_params).json() |
| 49 | + return self._handle_response("LocalesApiResponse", endpoint, query_params) |
37 | 50 |
|
38 | 51 | def stock_splits(self, symbol, **query_params): |
39 | 52 | endpoint = f"{self.url}/v2/reference/splits/{symbol}" |
40 | | - return self._session.get(endpoint, params=query_params).json() |
| 53 | + return self._handle_response("StockSplitsApiResponse", endpoint, query_params) |
41 | 54 |
|
42 | 55 | def stock_dividends(self, symbol, **query_params): |
43 | 56 | endpoint = f"{self.url}/v2/reference/dividends/{symbol}" |
44 | | - return self._session.get(endpoint, params=query_params).json() |
| 57 | + return self._handle_response("StockDividendsApiResponse", endpoint, query_params) |
45 | 58 |
|
46 | 59 | def stock_financials(self, symbol, **query_params): |
47 | 60 | endpoint = f"{self.url}/v2/reference/financials/{symbol}" |
48 | | - return self._session.get(endpoint, params=query_params).json() |
| 61 | + return self._handle_response("StockFinancialsApiResponse", endpoint, query_params) |
49 | 62 |
|
50 | 63 | def market_status(self, **query_params): |
51 | 64 | endpoint = f"{self.url}/v1/marketstatus/now" |
52 | | - return self._session.get(endpoint, params=query_params).json() |
| 65 | + return self._handle_response("MarketStatusApiResponse", endpoint, query_params) |
53 | 66 |
|
54 | 67 | def market_holidays(self, **query_params): |
55 | 68 | endpoint = f"{self.url}/v1/marketstatus/upcoming" |
56 | | - return self._session.get(endpoint, params=query_params).json() |
| 69 | + return self._handle_response("MarketHolidaysApiResponse", endpoint, query_params) |
57 | 70 |
|
58 | 71 | def exchanges(self, **query_params): |
59 | 72 | endpoint = f"{self.url}/v1/meta/exchanges" |
60 | | - return self._session.get(endpoint, params=query_params).json() |
| 73 | + return self._handle_response("ExchangesApiResponse", endpoint, query_params) |
61 | 74 |
|
62 | 75 | def historic_trades(self, symbol, date, **query_params): |
63 | 76 | endpoint = f"{self.url}/v1/historic/trades/{symbol}/{date}" |
64 | | - return self._session.get(endpoint, params=query_params).json() |
| 77 | + return self._handle_response("HistoricTradesApiResponse", endpoint, query_params) |
65 | 78 |
|
66 | | - def v2_historic_trades(self, ticker, date, **query_params): |
| 79 | + def historic_trades_v2(self, ticker, date, **query_params): |
67 | 80 | endpoint = f"{self.url}/v2/ticks/stocks/trades/{ticker}/{date}" |
68 | | - return self._session.get(endpoint, params=query_params).json() |
| 81 | + return self._handle_response("HistoricTradesV2ApiResponse", endpoint, query_params) |
69 | 82 |
|
70 | 83 | def historic_quotes(self, symbol, date, **query_params): |
71 | 84 | endpoint = f"{self.url}/v1/historic/quotes/{symbol}/{date}" |
72 | | - return self._session.get(endpoint, params=query_params).json() |
| 85 | + return self._handle_response("HistoricQuotesApiResponse", endpoint, query_params) |
73 | 86 |
|
74 | | - def v2_historic_nbbo_quotes(self, ticker, date, **query_params): |
| 87 | + def historic_n___bbo_quotes_v2(self, ticker, date, **query_params): |
75 | 88 | endpoint = f"{self.url}/v2/ticks/stocks/nbbo/{ticker}/{date}" |
76 | | - return self._session.get(endpoint, params=query_params).json() |
| 89 | + return self._handle_response("HistoricNBboQuotesV2ApiResponse", endpoint, query_params) |
77 | 90 |
|
78 | 91 | def last_trade_for_a_symbol(self, symbol, **query_params): |
79 | 92 | endpoint = f"{self.url}/v1/last/stocks/{symbol}" |
80 | | - return self._session.get(endpoint, params=query_params).json() |
| 93 | + return self._handle_response("LastTradeForASymbolApiResponse", endpoint, query_params) |
81 | 94 |
|
82 | 95 | def last_quote_for_a_symbol(self, symbol, **query_params): |
83 | 96 | endpoint = f"{self.url}/v1/last_quote/stocks/{symbol}" |
84 | | - return self._session.get(endpoint, params=query_params).json() |
| 97 | + return self._handle_response("LastQuoteForASymbolApiResponse", endpoint, query_params) |
85 | 98 |
|
86 | 99 | def daily_open_close(self, symbol, date, **query_params): |
87 | 100 | endpoint = f"{self.url}/v1/open-close/{symbol}/{date}" |
88 | | - return self._session.get(endpoint, params=query_params).json() |
| 101 | + return self._handle_response("DailyOpenCloseApiResponse", endpoint, query_params) |
89 | 102 |
|
90 | 103 | def condition_mappings(self, ticktype, **query_params): |
91 | 104 | endpoint = f"{self.url}/v1/meta/conditions/{ticktype}" |
92 | | - return self._session.get(endpoint, params=query_params).json() |
| 105 | + return self._handle_response("ConditionMappingsApiResponse", endpoint, query_params) |
93 | 106 |
|
94 | 107 | def snapshot_all_tickers(self, **query_params): |
95 | 108 | endpoint = f"{self.url}/v2/snapshot/locale/us/markets/stocks/tickers" |
96 | | - return self._session.get(endpoint, params=query_params).json() |
| 109 | + return self._handle_response("SnapshotAllTickersApiResponse", endpoint, query_params) |
97 | 110 |
|
98 | 111 | def snapshot_single_ticker(self, ticker, **query_params): |
99 | 112 | endpoint = f"{self.url}/v2/snapshot/locale/us/markets/stocks/tickers/{ticker}" |
100 | | - return self._session.get(endpoint, params=query_params).json() |
| 113 | + return self._handle_response("SnapshotSingleTickerApiResponse", endpoint, query_params) |
101 | 114 |
|
102 | 115 | def snapshot_gainers_losers(self, direction, **query_params): |
103 | 116 | endpoint = f"{self.url}/v2/snapshot/locale/us/markets/stocks/{direction}" |
104 | | - return self._session.get(endpoint, params=query_params).json() |
| 117 | + return self._handle_response("SnapshotGainersLosersApiResponse", endpoint, query_params) |
105 | 118 |
|
106 | 119 | def previous_close(self, ticker, **query_params): |
107 | 120 | endpoint = f"{self.url}/v2/aggs/ticker/{ticker}/prev" |
108 | | - return self._session.get(endpoint, params=query_params).json() |
| 121 | + return self._handle_response("PreviousCloseApiResponse", endpoint, query_params) |
109 | 122 |
|
110 | 123 | def aggregates(self, ticker, multiplier, timespan, from_, to, **query_params): |
111 | 124 | endpoint = f"{self.url}/v2/aggs/ticker/{ticker}/range/{multiplier}/{timespan}/{from_}/{to}" |
112 | | - return self._session.get(endpoint, params=query_params).json() |
| 125 | + return self._handle_response("AggregatesApiResponse", endpoint, query_params) |
113 | 126 |
|
114 | 127 | def grouped_daily(self, locale, market, date, **query_params): |
115 | 128 | endpoint = f"{self.url}/v2/aggs/grouped/locale/{locale}/market/{market}/{date}" |
116 | | - return self._session.get(endpoint, params=query_params).json() |
| 129 | + return self._handle_response("GroupedDailyApiResponse", endpoint, query_params) |
117 | 130 |
|
118 | 131 | def historic_forex_ticks(self, from_, to, date, **query_params): |
119 | 132 | endpoint = f"{self.url}/v1/historic/forex/{from_}/{to}/{date}" |
120 | | - return self._session.get(endpoint, params=query_params).json() |
| 133 | + return self._handle_response("HistoricForexTicksApiResponse", endpoint, query_params) |
121 | 134 |
|
122 | 135 | def real_time_currency_conversion(self, from_, to, **query_params): |
123 | 136 | endpoint = f"{self.url}/v1/conversion/{from_}/{to}" |
124 | | - return self._session.get(endpoint, params=query_params).json() |
| 137 | + return self._handle_response("RealTimeCurrencyConversionApiResponse", endpoint, query_params) |
125 | 138 |
|
126 | 139 | def last_quote_for_a_currency_pair(self, from_, to, **query_params): |
127 | 140 | endpoint = f"{self.url}/v1/last_quote/currencies/{from_}/{to}" |
128 | | - return self._session.get(endpoint, params=query_params).json() |
| 141 | + return self._handle_response("LastQuoteForACurrencyPairApiResponse", endpoint, query_params) |
129 | 142 |
|
130 | 143 | def snapshot_all_tickers(self, **query_params): |
131 | 144 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/forex/tickers" |
132 | | - return self._session.get(endpoint, params=query_params).json() |
| 145 | + return self._handle_response("SnapshotAllTickersApiResponse", endpoint, query_params) |
133 | 146 |
|
134 | 147 | def snapshot_gainers_losers(self, direction, **query_params): |
135 | 148 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/forex/{direction}" |
136 | | - return self._session.get(endpoint, params=query_params).json() |
| 149 | + return self._handle_response("SnapshotGainersLosersApiResponse", endpoint, query_params) |
137 | 150 |
|
138 | 151 | def crypto_exchanges(self, **query_params): |
139 | 152 | endpoint = f"{self.url}/v1/meta/crypto-exchanges" |
140 | | - return self._session.get(endpoint, params=query_params).json() |
| 153 | + return self._handle_response("CryptoExchangesApiResponse", endpoint, query_params) |
141 | 154 |
|
142 | 155 | def last_trade_for_a_crypto_pair(self, from_, to, **query_params): |
143 | 156 | endpoint = f"{self.url}/v1/last/crypto/{from_}/{to}" |
144 | | - return self._session.get(endpoint, params=query_params).json() |
| 157 | + return self._handle_response("LastTradeForACryptoPairApiResponse", endpoint, query_params) |
145 | 158 |
|
146 | 159 | def daily_open_close(self, from_, to, date, **query_params): |
147 | 160 | endpoint = f"{self.url}/v1/open-close/crypto/{from_}/{to}/{date}" |
148 | | - return self._session.get(endpoint, params=query_params).json() |
| 161 | + return self._handle_response("DailyOpenCloseApiResponse", endpoint, query_params) |
149 | 162 |
|
150 | 163 | def historic_crypto_trades(self, from_, to, date, **query_params): |
151 | 164 | endpoint = f"{self.url}/v1/historic/crypto/{from_}/{to}/{date}" |
152 | | - return self._session.get(endpoint, params=query_params).json() |
| 165 | + return self._handle_response("HistoricCryptoTradesApiResponse", endpoint, query_params) |
153 | 166 |
|
154 | 167 | def snapshot_all_tickers(self, **query_params): |
155 | 168 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/crypto/tickers" |
156 | | - return self._session.get(endpoint, params=query_params).json() |
| 169 | + return self._handle_response("SnapshotAllTickersApiResponse", endpoint, query_params) |
157 | 170 |
|
158 | 171 | def snapshot_single_ticker(self, ticker, **query_params): |
159 | 172 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}" |
160 | | - return self._session.get(endpoint, params=query_params).json() |
| 173 | + return self._handle_response("SnapshotSingleTickerApiResponse", endpoint, query_params) |
161 | 174 |
|
162 | | - def snapshot_single_ticker_full_book_l2(self, ticker, **query_params): |
| 175 | + def snapshot_single_ticker_full_book(self, ticker, **query_params): |
163 | 176 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}/book" |
164 | | - return self._session.get(endpoint, params=query_params).json() |
| 177 | + return self._handle_response("SnapshotSingleTickerFullBookApiResponse", endpoint, query_params) |
165 | 178 |
|
166 | 179 | def snapshot_gainers_losers(self, direction, **query_params): |
167 | 180 | endpoint = f"{self.url}/v2/snapshot/locale/global/markets/crypto/{direction}" |
168 | | - return self._session.get(endpoint, params=query_params).json() |
| 181 | + return self._handle_response("SnapshotGainersLosersApiResponse", endpoint, query_params) |
0 commit comments