tokease

词易算力指数平台的 Python SDK。不发请求也能查看每个接口的输入参数和输出字段；配置 API Key 后可以查询 index_basic、index_daily、index_quote、trade_cal，以及无需 Key 的公开行情接口。

安装

发布到 PyPI 之后：

pip install tokease
pip install "tokease[pandas]"

在仓库里开发：

pip install -e python/tokease

查看接口参数

import tokease

tokease.apis()
tokease.apis("query")
tokease.api_params("index_daily")
tokease.api_fields("index_daily")
tokease.describe("index_quote")

api_params 返回的名称与 POST /api/v1/query 的参数白名单一致。未知参数会在本地直接拒绝，不会发给服务端。

查询数据

import tokease

client = tokease.Client(api_key="tokease_xxxxxxxxxxxx_xxxxxxxx")
frame = client.index_daily(
    index_code="Server_Index",
    start_date="20260801",
    end_date="20260831",
    fields=["trade_date", "index_code", "index_value", "change_rate"],
).to_dataframe()

API Key 也可以通过环境变量 TOKEASE_API_KEY 传入。服务地址是 pyproject.toml 里的 Homepage，当前为 https://whale.tokease.cn。

默认会按 has_more 自动翻页。只要单页时传入 paginate=False。

公开接口不需要 API Key：

client = tokease.Client()
client.public_indices()
client.public_index_latest("Server_Index")

发布到 PyPI

版本号始终等于仓库根目录 package.json 的 version，不要在 Python 包里另写一份。PyPI 上每个版本只能上传一次。

发布使用 PyPI API Token，不使用 GitHub 受信发布。在 PyPI 账号设置里创建令牌，范围选 Entire account，再写入本仓库的 Actions secret PYPI_API_TOKEN。之后推送与系统版本一致的标签即可发布。本地 .githooks/pre-push 会先核对，版本不一致时标签推不上去：

git tag v1.13.1
git push origin v1.13.1

也可以在 GitHub Actions 里手动运行 Publish tokease，选择 pypi 或 testpypi。TestPyPI 需要在 test.pypi.org 另建一个 API Token，并换成对应的 secret。