rquote 0.3.3__py3-none-any.whl → 0.3.5__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,286 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: rquote
3
- Version: 0.3.3
4
- Summary: Mostly day quotes of cn/hk/us/fund/future markets, side with quote list fetch
5
- Requires-Python: >=3.6.1
6
- Description-Content-Type: text/markdown
7
- Requires-Dist: build>=0.9.0
8
- Requires-Dist: httpx>=0.20.0
9
- Requires-Dist: pandas>=1.0.0
10
- Requires-Dist: setuptools>=42
11
- Requires-Dist: twine>=3.8.0
12
-
13
- # rquote
14
-
15
- `rquote` 是一个提供 A股/港股/美股/ETF基金/期货 历史数据获取的Python库
16
-
17
- ## 主要功能
18
-
19
- ### 历史价格数据获取
20
-
21
- #### `get_price(i, sdate='', edate='', freq='day', days=320, fq='qfq', dd=None)`
22
-
23
- 获取股票、基金、期货的历史价格数据
24
-
25
- **参数:**
26
- - `i`: 股票代码,使用新浪/腾讯的id形式
27
- - `sdate`: 开始日期 (可选)
28
- - `edate`: 结束日期 (可选)
29
- - `freq`: 频率,默认'day' (日线)
30
- - `days`: 获取天数,默认320天
31
- - `fq`: 复权方式,默认'qfq' (前复权)
32
- - `dd`: 本地缓存字典 (可选)
33
-
34
- **代码格式说明:**
35
- - A股: `sh000001`表示上证指数,`sz000001`表示深市000001股票`平安银行`
36
- - ETF: `sh510050`表示上证50指数ETF
37
- - 港股: `hk00700`表示港股腾讯
38
- - 期货: 需加`fu`前缀,如`fuAP2110`,`fuBTC`表示比特币
39
- - 美股: 需加对应交易所后缀,如`usBABA.N`,`usC.N`,`usAAPL.OQ`等
40
- - 比特币:使用`fuBTC`代码
41
-
42
- **示例:**
43
- ```python
44
- from rquote import get_price
45
-
46
- # 获取上证指数数据
47
- sid, nm, df = get_price('sh000001')
48
- print(df.head()) # 数据为pandas dataframe
49
-
50
- # 获取指定日期范围的数据
51
- sid, nm, df = get_price('sz000001', sdate='2024-01-01', edate='2024-02-01')
52
-
53
- # 获取比特币数据
54
- sid, nm, df = get_price('fuBTC')
55
- ```
56
-
57
- **返回数据格式:**
58
- | date | open | close | high | low | vol |
59
- |------------|---------|---------|---------|---------|------------|
60
- | 2024-02-06 | 2680.48 | 2789.49 | 2802.93 | 2669.67 | 502849313 |
61
- | 2024-02-07 | 2791.51 | 2829.70 | 2829.70 | 2770.53 | 547117439 |
62
- | 2024-02-08 | 2832.49 | 2865.90 | 2867.47 | 2827.90 | 531108893 |
63
- | 2024-02-19 | 2886.59 | 2910.54 | 2910.54 | 2867.71 | 458967704 |
64
- | 2024-02-20 | 2902.88 | 2922.73 | 2927.31 | 2887.47 | 350138735 |
65
-
66
- #### `get_price_longer(i, l=2, dd={})`
67
-
68
- 获取更长时间的历史数据,默认获取2年数据
69
-
70
- ```python
71
- from rquote import get_price_longer
72
-
73
- # 获取2年的历史数据
74
- sid, nm, df = get_price_longer('sh000001', l=3) # 获取3年数据
75
- ```
76
-
77
- ### 股票列表获取
78
-
79
- #### `get_cn_stock_list(money_min=2e8)`
80
-
81
- 获取A股股票列表,按成交额排序,默认筛选成交额大于2亿的股票
82
-
83
- ```python
84
- from rquote import get_cn_stock_list
85
-
86
- # 获取成交额大于5亿的股票列表
87
- stocks = get_cn_stock_list(money_min=5e8)
88
- # 返回格式: [{code, name, pe_ttm, volume, turnover/亿, ...}, ...]
89
- # 如 {"code":"sh600519","hsl":"0.28","lb":"0.94","ltsz":"17946.80","name":"贵州茅台","pe_ttm":"20.16","pn":"6.95","speed":"0.02","state":"","stock_type":"GP-A","turnover":"499068","volume":"34816.00","zd":"2.66","zdf":"0.19","zdf_d10":"-5.16","zdf_d20":"-9.58","zdf_d5":"0.12","zdf_d60":"-9.22","zdf_w52":"-3.22","zdf_y":"-6.26","zf":"1.47","zljlr":"16268.84","zllc":"263511.99","zllc_d5":"1295957.54","zllr":"279780.83","zllr_d5":"1264966.39","zsz":"17946.80","zxj":"1428.66"}
90
- ```
91
-
92
- #### `get_hk_stocks_500()`
93
-
94
- 获取港股前500只股票列表
95
-
96
- ```python
97
- from rquote import get_hk_stocks_500
98
-
99
- stocks = get_hk_stocks_500()
100
- # 返回格式: [[code, name, price, turnover, ...], ...]
101
- # 如 ['00700', '腾讯控股', '505.50', '1.51', '7.50', '505.50', '505.50', '20622275.00', '10364144211.54', '504.50', '498.00', '505.50', '496.00', '0.22']
102
- ```
103
-
104
- #### `get_hk_stocks_hsi()`
105
-
106
- 获取恒生指数成分股列表
107
-
108
- ```python
109
- from rquote import get_hk_stocks_hsi
110
-
111
- hsi_stocks = get_hk_stocks_hsi()
112
- ```
113
-
114
- #### `get_hk_stocks_ggt()`
115
-
116
- 获取港股通股票列表
117
-
118
- ```python
119
- from rquote import get_hk_stocks_ggt
120
-
121
- ggt_stocks = get_hk_stocks_ggt()
122
- ```
123
-
124
- #### `get_us_stocks(k=100)`
125
-
126
- 获取美股最大市值的k支股票列表
127
-
128
- ```python
129
- from rquote import get_us_stocks_biggest
130
-
131
- us_stocks = get_us_stocks_biggest(k=100) # 获取前100只
132
- # 返回格式: [{name, symbol, market, mktcap, pe, ...}, ...]
133
- # 如 {"name":"Microsoft Corp.","cname":"微软公司","category":"软件","symbol":"MSFT","price":"480.24","diff":"2.20","chg":"0.46","preclose":"478.04","open":"478.00","high":"481.00","low":"474.46","amplitude":"1.37%","volume":"17526452","mktcap":"3569404793144","pe":"36.94153771","market":"NASDAQ","category_id":"14"}
134
- ```
135
-
136
- ### 基金和期货
137
-
138
- #### `get_cn_fund_list()`
139
-
140
- 获取A股ETF基金列表,按成交额排序
141
-
142
- ```python
143
- from rquote import get_cn_fund_list
144
-
145
- funds = get_cn_fund_list()
146
- # 返回格式: [code, name, change, amount, price]
147
- ```
148
-
149
- #### `get_cn_future_list()`
150
-
151
- 获取国内期货合约列表
152
-
153
- ```python
154
- from rquote import get_cn_future_list
155
-
156
- futures = get_cn_future_list()
157
- # 返回格式: ['fuSC2109', 'fuRB2110', 'fuHC2110', ...]
158
- ```
159
-
160
- ### 板块和概念
161
-
162
- #### `get_all_industries()`
163
-
164
- 获取所有行业板块列表
165
-
166
- ```python
167
- from rquote import get_all_industries
168
-
169
- industries = get_all_industries()
170
- # 返回格式: [code, name, change, amount, price]
171
- ```
172
-
173
- #### `get_all_concepts()`
174
-
175
- 获取所有概念板块列表
176
-
177
- ```python
178
- from rquote import get_all_concepts
179
-
180
- concepts = get_all_concepts()
181
- # 返回格式: [code, name, change, amount, price]
182
- ```
183
-
184
- #### `get_stock_concepts(i)`
185
-
186
- 获取指定股票所属的概念板块
187
-
188
- ```python
189
- from rquote import get_stock_concepts
190
-
191
- # 获取平安银行的概念板块
192
- concepts = get_stock_concepts('sz000001')
193
- # 返回概念代码列表,如 ['BK0420', 'BK0900', ...]
194
- ```
195
-
196
- #### `get_concept_stocks(bkid, dc=None)`
197
-
198
- 获取指定概念板块的股票列表
199
-
200
- ```python
201
- from rquote import get_concept_stocks
202
-
203
- # 获取概念板块BK0420的股票
204
- stocks = get_concept_stocks('BK0420')
205
- # 返回格式: [code, name, change, amount, mktcap]
206
- ```
207
-
208
- #### `get_bk_stocks(bkid)`
209
-
210
- 获取指定板块的股票列表
211
-
212
- ```python
213
- from rquote import get_bk_stocks
214
-
215
- # 获取板块股票
216
- stocks = get_bk_stocks('BK0420')
217
- ```
218
-
219
- #### `get_industry_stocks(bkid)`
220
-
221
- 获取指定行业板块的股票列表
222
-
223
- ```python
224
- from rquote import get_industry_stocks
225
-
226
- # 获取行业板块股票
227
- stocks = get_industry_stocks('BK0420')
228
- ```
229
-
230
- ### 实时行情
231
-
232
- #### `get_tick(tgts=[])`
233
-
234
- 获取实时行情数据
235
-
236
- ```python
237
- from rquote import get_tick
238
-
239
- # 获取美股实时行情
240
- tick_data = get_tick(['AAPL', 'GOOGL'])
241
- # 返回格式: [{'name': 'Apple Inc', 'price': '150.25', 'price_change_rate': '1.2%', ...}]
242
- ```
243
-
244
- ### 可视化工具
245
-
246
- #### `PlotUtils.plot_candle(i, sdate='', edate='', dsh=False, vol=True)`
247
-
248
- 绘制K线图
249
-
250
- ```python
251
- from rquote import PlotUtils
252
-
253
- # 绘制平安银行的K线图
254
- data, layout = PlotUtils.plot_candle('sz000001', sdate='2024-01-01', edate='2024-02-01')
255
-
256
- # 使用plotly显示
257
- import plotly.graph_objs as go
258
- fig = go.Figure(data=data, layout=layout)
259
- fig.show()
260
- ```
261
-
262
- ### 工具类
263
-
264
- #### `WebUtils`
265
-
266
- 网络请求工具类
267
-
268
- #### `BasicFactors`
269
-
270
- 基础因子计算工具类
271
-
272
- ## 安装
273
-
274
- ```bash
275
- pip install rquote
276
- ```
277
-
278
- ## 注意事项
279
-
280
- 1. 数据来源于新浪财经、腾讯财经、东方财富等公开数据源
281
- 2. 建议合理控制请求频率,避免被限制访问
282
- 3. 期货代码需要加`fu`前缀,如`fuAP2110`
283
- 4. 美股代码需要加对应后缀,如`usAAPL.OQ` (OQ->NASDAQ, N->NYSE, AM->ETF)
284
-
285
-
286
-
@@ -1,8 +0,0 @@
1
- rquote/__init__.py,sha256=PB620yEq2QZyfDweKY_8qMEsZMKhskGfhmfDkch_0j0,462
2
- rquote/main.py,sha256=6o-eBvjUoUKLLPRxL6gkXbOje8y3tBlgjrVKz68GD-8,19982
3
- rquote/plots.py,sha256=N8uvD6ju9tow0DllPQiXiM7EoPC2bK8X7QF6NQainKs,2342
4
- rquote/utils.py,sha256=4Neb9_R-EKAd6s1Qj4O_vs9jXWyvroxEEhdqH35vxVE,6808
5
- rquote-0.3.3.dist-info/METADATA,sha256=FNkt0vuPh7Zxs5D_VepHEtvEx6g49i0FnAZ6veSE5aM,7301
6
- rquote-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
7
- rquote-0.3.3.dist-info/top_level.txt,sha256=CehAiaZx7Fo8HGoV2zd5GhILUW1jQEN8YS-cWMlrK9Y,7
8
- rquote-0.3.3.dist-info/RECORD,,
File without changes