使用AKTools本地部署AKShare财经数据接口库

使用AKTools部署AKShare财经数据接口库，AKShare的介绍见：基于 Python 的财经数据接口库：AKShare-CSDN博客

AKTools 是一款用于快速搭建 AKShare HTTP API 的工具，通过 AKTools 可以利用一行命令来启动 HTTP 服务，从而让原本专属服务于 Python 用户的开源财经数据接口库 AKShare 的使用突破编程语言的限制。无论您使用的是 C/C++、Java、Go、Rust、Ruby、PHP、JavaScript、R、Matlab、Stata 等编程语言或软件都可以快速、轻松获取财经数据，助力您更好地展开研究和开发工作。

官网：GitHub - akfamily/aktools: AKTools is an elegant and simple HTTP API library for AKShare, built for AKSharers!

手册：AKTools 官方文档

快速部署使用

安装AKTools

pip install aktools

升级AKTools

pip install aktools -U

启动AKTools服务

安装好后，执行下面命令启动服务：

python -m aktools

如果要让其它机器也能访问，需要绑定ip到0.0.0.0，使用命令：

python -m aktools --host 0.0.0.0

启动后显示：

python -m aktools --host 0.0.0.0
请访问：http://0.0.0.0:8080/version 来获取最新的库版本信息，确保使用最新版本的 AKShare 和 AKTools
当前的 AKTools 版本为：0.0.89，AKShare 版本为：1.15.73
点击打开 HTTP API 主页：http://0.0.0.0:8080/
点击打开接口导览：http://0.0.0.0:8080/docs
INFO:     Started server process [2004]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)
INFO:     172.25.176.1:60070 - "GET / HTTP/1.1" 200 OK
INFO:     172.25.176.1:60070 - "GET /favicon.ico HTTP/1.1" 200 OK
INFO:     172.25.176.1:61788 - "GET /docs HTTP/1.1" 200 OK
INFO:     172.25.176.1:61788 - "GET /openapi.json HTTP/1.1" 200 OK
INFO:     172.25.176.1:61788 - "GET /api/public/stock_zh_a_hist HTTP/1.1" 200 OK
INFO:     172.25.176.1:61905 - "GET /api/public/600001 HTTP/1.1" 404 Not Found
INFO:     172.25.176.1:61918 - "GET /api/public/600001 HTTP/1.1" 404 Not Found
INFO:     172.25.176.1:61922 - "GET /api/public/stock_zh_a_hist HTTP/1.1" 200 OK

这样其它机器也可以通过使用ip地址来访问这台AKTools的服务了。比如这台机器的ip地址是172.25.183.186，那么就可以通过这个网址来访问：

http://172.25.183.186:8080/

主要，要根据服务器的ip地址修改网址链接，以上只是一个例子。

使用AKTools

无参数调用千股千评

比如原来使用ak.stock_comment_em() 来获取 东方财富网-数据中心-特色数据-千股千评 的数据，现在使用AKTolls，直接访问这个地址即可：

http://172.25.183.186:8080/api/public/stock_comment_em

本机访问

http://127.0.0.1:8080/api/public/stock_comment_em

输出信息如下：

[{"序号": 1,"代码": "000001","名称": "平安银行","最新价": null,"涨跌幅": null,"换手率": 0,"市盈率": 4.21,"主力成本": 11.4905800646,"机构参与度": 0.5175816,"综合得分": 70.24115075,"上升": -335,"目前排名": 425,"关注指数": 85.6,"交易日": "2025-01-15T00:00:00.000"},{"序号": 2,"代码": "000002","名称": "万  科Ａ","最新价": null,"涨跌幅": null,"换手率": 0,"市盈率": -3.42,"主力成本": 6.8563898546,"机构参与度": 0.4192784,"综合得分": 54.83373013,"上升": -410,"目前排名": 4338,"关注指数": 75.6,"交易日": "2025-01-15T00:00:00.000"},{"序号": 3,"代码": "000004","名称": "国华网安","最新价": null,"涨跌幅": null,"换手率": 0,"市盈率": -37.19,"主力成本": 13.5006343582,"机构参与度": 0.173278,"综合得分": 49.38011126,"上升": 74,"目前排名": 5057,"关注指数": 71.2,"交易日": "2025-01-15T00:00:00.000"},

里面的综合得分、机构参与度、关注指数等数据，都可以提供决策帮助。

参数调用

对于带参数的接口，此处分为两种情况。此处以 ak.stock_zh_a_hist() 接口为例，如果直接访问：http://127.0.0.1:8080/api/public/stock_zh_a_hist 则可以获取带默认参数的数据，如果需要为该接口指定参数，比如获取 symbol="600000" 的股票，则只需要访问：http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000 即可。注意此处的 ?symbol=600000 中都不带 " 号，如果需要同时指定多个参数，则只需要访问：http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000&period=weekly 即可。

调用浦发银行的默认日数据

网址：

http://172.25.183.186:8080/api/public/stock_zh_a_hist?symbol=600000

输出信息：

[{"日期": "1999-11-10T00:00:00.000","股票代码": "600000","开盘": 29.5,"收盘": 27.75,"最高": 29.8,"最低": 27,"成交量": 1740850,"成交额": 4859102000,"振幅": 28,"涨跌幅": 177.5,"涨跌额": 17.75,"换手率": 54.4},{"日期": "1999-11-11T00:00:00.000","股票代码": "600000","开盘": 27.58,"收盘": 27.71,"最高": 28.38,"最低": 27.53,"成交量": 294034,"成交额": 821582000,"振幅": 3.06,"涨跌幅": -0.14,"涨跌额": -0.04,"换手率": 9.19},{"日期": "2025-01-15T00:00:00.000","股票代码": "600000","开盘": 10.16,"收盘": 10.21,"最高": 10.39,"最低": 10.13,"成交量": 384608,"成交额": 394080520,"振幅": 2.56,"涨跌幅": 0.49,"涨跌额": 0.05,"换手率": 0.13},{"日期": "2025-01-16T00:00:00.000","股票代码": "600000","开盘": 10.29,"收盘": 10.26,"最高": 10.31,"最低": 10.13,"成交量": 111000,"成交额": 113188998,"振幅": 1.76,"涨跌幅": 0.49,"涨跌额": 0.05,"换手率": 0.04}
]

调用调用浦发银行的数据周线

网址：

http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000&period=weekly

输出：

    {"日期": "2025-01-03T00:00:00.000","股票代码": "600000","开盘": 10.34,"收盘": 10.06,"最高": 10.56,"最低": 10.02,"成交量": 2658623,"成交额": 2736531849,"振幅": 5.21,"涨跌幅": -2.9,"涨跌额": -0.3,"换手率": 0.91},{"日期": "2025-01-10T00:00:00.000","股票代码": "600000","开盘": 10.13,"收盘": 10.13,"最高": 10.37,"最低": 9.81,"成交量": 2394593,"成交额": 2437980129,"振幅": 5.57,"涨跌幅": 0.7,"涨跌额": 0.07,"换手率": 0.82},{"日期": "2025-01-16T00:00:00.000","股票代码": "600000","开盘": 10.06,"收盘": 10.24,"最高": 10.39,"最低": 9.85,"成交量": 1315183,"成交额": 1331291096,"振幅": 5.33,"涨跌幅": 1.09,"涨跌额": 0.11,"换手率": 0.45}
]

可以看到是从1999-11-12开始的周线信息。

Docker部署：AKTools-Docker 版本

下载镜像

# docker pull registry.cn-shanghai.aliyuncs.com/akfamily/aktools:[AKShare 的版本号]
docker pull registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.15.73

启动镜像

高性能模式

高性能模式为镜像启动后的默认模式，其主要是启动 Gunicorn 作为 WSGI 服务器，提高网络处理的性能，更多资料请参考

常规方式运行：

docker run -p 8080:8080 registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.15.73

后台运行：

docker run -d -p 8080:8080 registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.15.73

普通模式

常规方式运行：

docker run -p 8080:8080 registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.8.95 python -m aktools --host 0.0.0.0 --port 8080

后台运行：

docker run -d -p 8080:8080 registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.8.95 python -m aktools --host 0.0.0.0 --port 8080

本机访问

http://127.0.0.1:8080/api/public/stock_zh_a_hist

升级镜像

最简单的办法就是启动AKtolls后，查看提示的最新版本号，然后再次docker run的时候直接用最新版本的镜像。

也可以进入镜像，升级AKTools软件：

docker run -it ak_tools:1.15.73 /bin/bash

# 升级 AKShare 到最新版：
pip install akshare -U

退出镜像：exit

找到容器 ID：docker ps -a

docker ps -a
CONTAINER ID   IMAGE                                                       COMMAND                   CREATED          STATUS          PORTS                    NAMES
f352c80dd47f   registry.cn-shanghai.aliyuncs.com/akfamily/aktools:1.8.95   "python -m aktools -…"   12 minutes ago   Up 12 minutes   0.0.0.0:8080->8080/tcp   nifty_margulis

提交修改：

docker commit -m "update akshare to latest" f352c80dd47f ak_tools:1.15.74

这样就将AKTools的镜像升级到1.15.74了（当然目前2025.1.16日最新版本是1.15.73，这是举个例子）

最后利用构建好的新镜像启动新容器：docker run -p 8080:8080 ak_tools:1.15.74