Appearance
快速开始
ZltFinOrmClient 是智量通财经数据库的官方 Python 客户端。装好之后写几行代码，就能把 A股、基金、债券、期货、指数、宏观等数据取到本地，结果直接是表格或者 DataFrame。
你只需要描述想查的数据、时间范围和返回字段，客户端会按统一的查询参数执行并返回结果。
三步跑通第一个查询
第一步：安装
bash
pip install ZltFinOrmClient --index-url https://pypip.zltquant.com/这一行装的是最基本的客户端。想让 AI 助手（Claude、Codex 这些）直接帮你查数据，还要多装两样东西，安装那页有完整步骤，建议照着装全。
第二步：拿到访问凭据
调用数据需要一个 token，形如 fk_ 开头的一串字符。它相当于你的账号密码，决定了你能查哪些数据。
申请方式：联系官方客服（邮箱：kefu@zltquant.com）。 客服会同时告诉你服务地址（endpoint）和 token，并按你需要的数据范围开通权限。
拿到之后妥善保管，不要发到公开的代码仓库或者聊天群里。
第三步：查一条数据
把下面代码里的 endpoint 和 token 换成客服给你的值：
python
from zlt_finorm_client import ZltFinOrmClient
client = ZltFinOrmClient(
endpoint="http://finorm.zltquant.com:7761",
token="fk_你的token",
)
result = client.query(
table="cneqa_bsc_stk_bsc_info", # 股票基本信息表
symbols=["600519.SH", "000858.SZ"], # 贵州茅台、五粮液
fields=["sec_cd", "co_full_nm", "lstg_dt", "iss_prc", "co_web"],
)
for row in result["rows"]:
print(row)跑出来是这样：
text
['000858', '宜宾五粮液股份有限公司', '19980427', '14.77', 'www.wuliangye.com.cn']
['600519', '贵州茅台酒股份有限公司', '20010827', '31.39', 'www.moutaichina.com']想要 pandas 的 DataFrame，加一个参数 format="pandas" 就行（需要先装 pandas）。
取几十万行、并且要自己做数值计算（算因子、跑回测）时，换成 format="npz"——它直接给 numpy 数组，能直接喂给 numba 这类 JIT 编译器，不用先转 DataFrame。只是取数看看或导出的话，format="pandas" 就够了。详见接口参考与 npz 格式说明。
怎么找到想要的数据
文档中的表和字段编码属于客户端内部的数据目录标识，通常不需要记忆或手工推断。你可以直接按中文业务名称查找：
一是翻数据范围，那里按数据库列出了全部 476 张表和每个字段的中文名，Ctrl+F 搜中文就能找到。
二是在代码里问服务端：
python
client.categories() # 有哪些数据分类
client.describe("cneqa_bsc_stk_bsc_info") # 这张表有哪些字段如果使用 AI 助手，直接说“查贵州茅台最近的财务指标”即可，AI 会先根据数据目录确认可用的数据，再组织查询。
让 AI 帮你查
如果你在用 Claude Code、Codex 这类 AI 助手，装上配套的 skill 和 MCP 之后，可以直接用中文提需求：
帮我查贵州茅台最近 5 个交易日的开盘价、收盘价和成交额。
AI 会自己找表、读字段、组装查询、把结果取回来，你不用写代码。安装方法见安装。