|
| 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