系列：《Python 量化取数指南》｜连载项目 · 纯 GET 取数 · 仅依赖 requests
数据：由智兔数服提供。更多接口见 智兔数服技术博客。

1. 你将得到什么

• 一张 8 类数据 × 端点 × 坑点 的选型矩阵（本系列全部干货汇总）
• 一份 10 条通用避坑清单（跨所有篇）
• 一个可运行的小脚本：把全系列端点汇总成 dict 打印，方便你直接抄

2. 本篇取数约定

• 全部端点沿用前 15 篇；本篇只做「汇总 + 对照」，不引入新端点
• 请求：GET https://api.zhituapi.com<path>?token=<你的智兔token>
• 字段解析统一用 _hit_key（见第 3 篇）

3. 核心模板（全系列复用，略，见第 3 篇 _get）

本篇不重复贴 _get 封装，直接复用第 3 篇；下面是选型矩阵与汇总。

4. 跑通示例：全系列端点汇总打印

ENDPOINTS = {
    "免费快照":   ["/hz/list/hszs", "/himk/syl", "/hs/sectors/", "/kzz/list"],
    "北向资金":   ["/ht/nbzj/ah", "/ht/nbzj/sgpm/all", "/ht/nbzj/hgtc", "/ht/nbzj/sgtc"],
    "行情":       ["/hs/real/ssjy/", "/hz/history/fsjy/{code}.{m}/{lvl}", "/hs/history/transaction/{code}"],
    "历史K线":    ["/hz/history/fsjy/{code}.{m}/{lvl}", "/hz/history/ma/{code}.{m}/{lvl}"],
    "实时":       ["/hs/real/ssjy/", "/hs/real/five/{code}", "/hs/real/time/{code}", "/jh/hq/etflist"],
    "财务":       ["/hs/fin/balance/{code}", "/hs/fin/income/{code}", "/hs/fin/cashflow/{code}", "/hs/fin/ratios/{code}", "/hs/gs/cwzb/{code}"],
    "基金持仓":   ["/hs/gs/jjcg/{code}", "/jh/zh/gpcc/{code}", "/jh/zh/zccc/{code}"],
    "港股通":     ["/ht/nbzj/hgtc", "/ht/nbzj/sgtc", "/hicw/jlr", "/hicw/lr", "/hicw/yl"],
    "可转债":     ["/kzz/list", "/kzz/spot", "/kzz/comparison"],
    "ETF":        ["/jh/hq/etflist", "/jh/hq/loflist"],
    "北交所/指数":["/bj/list/all", "/bj/history/ma/{code}/d/n", "/hz/list/hszs", "/hz/history/fsjy/{code}.{m}/{lvl}"],
}

def show_map():
    for k, v in ENDPOINTS.items():
        print(f"  {k}: {len(v)} 个端点")

if __name__ == "__main__":
    show_map()

5. 选型矩阵（8 类数据）

6. 通用避坑清单（10 条）

1. 先打原始结构：print(type(data), data) 再写解析，字段名三套并存（close/sp/收盘）。
2. _hit_key 兜底：所有取值走候选键，别硬编码单一字段名。
3. 代码带市场后缀：.SH/.SZ/.BJ/.HK 缺一不可，错则 404。
4. 复权必做：历史 K 线默认未复权，回测前复权（第 14 篇）。
5. 限流留余量：循环加 sleep，免费证书尤甚，别打满。
6. token 不进版本库：用环境变量/配置，泄露即失效。
7. 休市非空：实时端点休市返回收盘快照，别当实时。
8. 单位先核对：财务/港股常万元/元/港元混，先 print 确认。
9. 落库按 date 主键：INSERT OR REPLACE 防重复（第 13 篇）。
10. 灾备要降级：多源注册表 + 短超时 + 告警（第 15 篇）。

7. 小结与下一篇预告

小结：本系列 16 篇覆盖了「取数底座 → 8 类数据 → 工程化（落库/清洗/灾备）」全链路；记住「先打结构、_hit_key 兜底、后缀别错、复权必做、限流留余量」这五条，绝大部分坑都能避开。

系列到此完结：感谢追更，所有示例均复用同一套 _get 底座，复制即可跑；生产前用小流量探端点稳定性与字段权限。更多接口与示例见 智兔数服技术博客。

8. 免责声明

本文仅演示公开数据接口的用法，所有代码示例均为演示数据，不构成任何投资建议；实际返回字段以接口文档与你的证书权限为准。数据由 智兔数服 提供，更多接口示例见 技术博客。

免费领取证书 / 查看完整接口文档，可前往 智兔数服官网。