Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sml2h3/stockman
正在开发中的A股量化数据工具，目前支持tushare
https://github.com/sml2h3/stockman
Last synced: 19 days ago
JSON representation
正在开发中的A股量化数据工具，目前支持tushare
- Host: GitHub
- URL: https://github.com/sml2h3/stockman
- Owner: sml2h3
- License: mit
- Created: 2023-01-28T03:27:40.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-09-18T23:23:06.000Z (about 1 year ago)
- Last Synced: 2024-10-14T19:37:30.648Z (about 1 month ago)
- Language: Python
- Homepage:
- Size: 47.9 KB
- Stars: 25
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Stockman
友好的A股量化数据包，支持tushare等多数据渠道（其他渠道开发中）收集，自带常用和非常用数据指标（开发中）
----
## 安装
```shell
# 1、直接pip安装，国内源在项目更新后需要1-2天同步
pip install stockman
# 2、从源代码安装
git clone https://github.com/sml2h3/stockman.git
cd stockman
python setup.py install
```
## 一、使用方式
### 1、生成配置文件清单
```python
# example_generate_config_pystock.py
import stockman
stock = stockman.Stock()
stock.generate_config()
```
上述代码将会在项目当前目录生成 sample.yaml 配置文件， 请根据实际情况进行填写
```yaml
DBCONFIG: # MYSQL数据库配置
host: 127.0.0.1 # MYSQL数据库主机地址
dbname: stock_db # MYSQL数据库名称，需要自己创建该名称数据库
username: root # MYSQL数据库用户名
password: stock_db # MYSQL数据库密码
port: 3306 # MYSQL数据库端口
charset: utf8 # MYSQL数据库默认字符集
prefix: stockman_ # MYSQL数据库表前缀
APIS: # 数据渠道配置
Tushare: # Tushare 数据渠道
Params: # Tushare 数据渠道配置
token: '' # Tushare 数据渠道TOKEN，请于Tushare个人中心获取
Permissions: # Tushare 数据功能权限配置
stock_list: true # 是否使用Tushare渠道进行股票列表数据权限获取
stock_daily: true # 是否使用Tushare渠道进行股票日线数据权限获取
stock_trade_cal: true # 是否使用Tushare渠道进行股票交易日历数据获取
```
### 2、自动安装数据表
```python
# example_install_pystock.py
import stockman
with open("sample.yaml", "r") as f:
res = f.read()
stock = stockman.Stock(res)
stock.install()
```
上述代码将会根据配置文件 sample.yaml 的数据库部分配置，生成各项数据表
### 3、设置接口调度频率限制
本功能主要用于开源API或者未来主动采集数据时拉取数据的速度限制，如tushare的日线数据接口调用限制为 100次/60秒
```python
# example_set_func_times_limit_pystock.py
import stockman
with open("sample.yaml", "r") as f:
res = f.read()
stock = stockman.Stock(res)
stock.set_times_limit(feature="tushare.stock_daily_sub", limit_time=(100, 60))
```
`set_times_limit` 方法接收 `feature` 与 `limit_time` 两个参数，其中 `feature` 参数的组成结构为 `{api_name}.{func_name}` , `limit_time`
参数为一个包含两个值的元组，依次为 次数 、 时间（单位为秒），指代的频率为 `次数/时间（单位为秒）`
目前feature支持调节频率的方法为
| 接口名称 | api_name | func_name | 默认值 |
|---------------|----------|-----------------|--------|
| Tushare日线数据接口 | tushare | stock_daily_sub | 100/60 |
### 4、初始化数据
```python
# example_init_data_pystock.py
import stockman
with open("sample.yaml", "r") as f:
res = f.read()
stock = stockman.Stock(res)
stock.init()
```
上述代码将会自动依次根据配置文件 sample.yaml 中的数据渠道部分中的权限配置去导入历史数据，目前包含有交易日历、股票列表、历史日K线数据等。
### 5、主动更新数据
```python
# example_update_pystock.py
import stockman
with open("sample.yaml", "r") as f:
res = f.read()
stock = stockman.Stock(res)
# 更新日K线数据
def update_daily_k_data():
stock.update_daily_k_data()
# 更新股票列表数据
def update_stock_list_data():
stock.update_stock_list_data()
if __name__ == '__main__':
update_daily_k_data()
update_stock_list_data()
```