【A股分钟级高频数据完全手册 #08】股票日、分时数据接口对比：普通分时与Pro版差异实测
系列：《A股分钟级高频数据完全手册》｜连载项目 · 纯 GET 取数 · 仅依赖 requests · Pro 版分钟级高频
① 你将得到什么
很多新手分不清普通分时和 Pro 版分时：普通分时 /hs/latest/{code}.SZ/d/n 免费/低门槛但数据较粗、条数有限；Pro 版更细（到 1 分钟 bar）、覆盖更全但需 Pro 权限。本篇用同一个标的把两者拉下来对比字段、粒度、量级，帮你按场景选型。
本篇产出：分别用普通分时 /hs/latest/{code}.SZ/d/n 与 Pro 版最新分时拉取同一标的，对比字段粒度与量级，给出选型建议。
读完这篇，你应当能独立把本篇端点数据拉下来、落本地，并跑出一份可用的加工分析表。
② 取数约定
一个端点拉数据，返回里字段名可能中英文混用（不同接口版本、不同数据源习惯不同）。演示用 你的token 占位，代码里 MOCK=True 时回放演示数据，接真实 token 把 MOCK 改成 False 即可，无需改动其他逻辑。
所有请求走 https://api.zhituapi.com + ?token=，纯 GET、仅依赖 requests，不依赖任何付费 SDK。字段口径以接口实际返回为准，本文用 _hit_key 做了大小写/中英文容错；落地前建议先用 print(r[0].keys()) 核对一次你账号下的真实字段名。
落地建议：把每天拉到的数据按 代码 + 日期 做主键写入本地 SQLite/CSV，避免重复插入；历史回看靠本地累积，而非反复调接口。本篇示例代码已包含字段容错映射与本地加工函数，你只需把 print 替换为写入语句。
③ 端点分组地图
| 端点 | 用途 |
|---|---|
/hs/latest/{code}.SZ/d/n | 普通最新分时/日线（按 d 周期）：低门槛、粒度较粗 |
/hs/pro/latest/{code}.SZ/1/n | Pro 版最新 1 分钟分时：更细、需 Pro 权限 |
本篇涉及字段（落地建表参考）：代码、名称、时间、开、收、高、低、成交量、成交额。
返回结构为 JSON 数组（或含数组字段的对象），每条记录即一根分钟 bar / 一笔明细；字段映射函数已按上述字段做容错映射，直接复用即可。
④ 核心模板函数（自包含·可跑）
import requests, time, copy
from urllib.parse import quote
BASE = "https://api.zhituapi.com"
# 将 "你的token" 替换成您自己的 token。
TOKEN = "你的token"
# ---------- 字段容错与类型归一 ----------
def _hit_key(d, *cands, default=None):
"""字段容错：接口偶发大小写/中英文混用时，按顺序取第一个非空值"""
if not isinstance(d, dict):
return default
for c in cands:
if c in d and d[c] not in (None, "", "-", "null"):
return d[c]
low = {str(k).lower(): v for k, v in d.items()}
for c in cands:
v = low.get(str(c).lower())
if v not in (None, "", "-", "null"):
return v
return default
def _to_float(v, default=None):
try:
if v in (None, "", "-", "null", "None"):
return default
return float(v)
except (TypeError, ValueError):
return default
# ---------- 统一请求：token 鉴权 + 重试退避（MOCK 开关） ----------
MOCK = True
DEMO_DATA = {}
def _get(path, params=None, timeout=10, retries=2, backoff=0.6, default=None):
"""返回 JSON；MOCK=True 时回放 DEMO_DATA；否则真实 GET 并带 token 鉴权、重试 retries 次"""
if MOCK:
return copy.deepcopy(DEMO_DATA.get(path, {} if default is None else default))
q = {"token": TOKEN}
if params:
q.update(params)
last = ""
for i in range(retries + 1):
try:
r = requests.get(BASE + path, params=q, timeout=timeout)
if r.status_code == 200:
try:
return r.json()
except ValueError:
return default
last = "HTTP %s %s" % (r.status_code, (r.text or "").strip()[:80])
except Exception as e:
last = "%s: %s" % (type(e).__name__, e)
if i < retries:
time.sleep(backoff * (i + 1))
return {"_error": last}
# ---------- 3. 取数封装 ----------
def fetch_rows():
return _get("/hs/latest/000001.SZ/d/5", default=[])
# ---------- 4. 数据加工 ----------
def process(rows):
out = []
for r in rows or []:
out.append({
"代码": _hit_key(r, "code", "dm"),
"名称": _hit_key(r, "name", "mc"),
"时间": _hit_key(r, "t", "time", "date"),
"开": _hit_key(r, "o", "open"),
"收": _hit_key(r, "c", "close"),
"高": _hit_key(r, "h", "high"),
"低": _hit_key(r, "l", "low"),
"成交量": _hit_key(r, "v", "vol", "volume"),
"成交额": _hit_key(r, "a", "amount")
})
return out
# ---------- 5. 本地加工分析（演示：多列描述统计 + 主列 Top5 + 异常） ----------
def analysis(data):
if not data:
print("无可分析数据，请检查字段映射")
return
num_cols = [k for k in data[0].keys() if _to_float(data[0][k]) is not None]
for col in num_cols:
vs = [(_to_float(d.get(col)) or 0.0) for d in data]
if not vs:
continue
print("列[%s] n=%d 均值=%2f 最大=%2f 最小=%2f" % (col, len(vs), sum(vs)/len(vs), max(vs), min(vs)))
col = "成交量"
vs = [(_to_float(d.get(col)) or 0.0) for d in data]
vs.sort(reverse=True)
print("【主数值列 %s】Top5：" % col)
for v in vs[:5]:
print(" %s=%2f" % (col, v))
anom = [v for v in vs if v < 0 or v > (sum(vs)/len(vs)) * 2]
print("异常扫描：%d 条（负值或超 2 倍均值）" % len(anom))
# ---------- 6. 校验 ----------
DEMO_DATA = {
"/hs/latest/000001.SZ/d/5": [{'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '10.18', 'c': '10.25', 'h': '10.30', 'l': '10.15', 'v': '1200000', 'a': '122400000'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '1680.0', 'c': '1688.5', 'h': '1692.0', 'l': '1678.5', 'v': '350000', 'a': '589975000'}, {'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '7.47', 'c': '7.52', 'h': '7.55', 'l': '7.44', 'v': '880000', 'a': '8.976e+07'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '1344', 'c': '1350.8', 'h': '1353.6', 'l': '1342.8', 'v': '280000', 'a': '4.7198e+08'}, {'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '8.82', 'c': '8.88', 'h': '8.93', 'l': '8.8', 'v': '1.04e+06', 'a': '1.0608e+08'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '1568', 'c': '1575.93', 'h': '1579.2', 'l': '1566.6', 'v': '326667', 'a': '5.50643e+08'}, {'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '10.18', 'c': '10.25', 'h': '10.3', 'l': '10.15', 'v': '1.2e+06', 'a': '1.224e+08'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '1792', 'c': '1801.07', 'h': '1804.8', 'l': '1790.4', 'v': '373333', 'a': '6.29307e+08'}, {'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '11.54', 'c': '11.62', 'h': '11.67', 'l': '11.5', 'v': '1.36e+06', 'a': '1.3872e+08'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '2016', 'c': '2026.2', 'h': '2030.4', 'l': '2014.2', 'v': '420000', 'a': '7.0797e+08'}, {'code': '000001.SZ', 'name': '平安银行', 't': '2024-01-10', 'o': '12.89', 'c': '12.98', 'h': '13.05', 'l': '12.86', 'v': '1.52e+06', 'a': '1.5504e+08'}, {'code': '600519.SH', 'name': '贵州茅台', 't': '2024-01-10', 'o': '2240', 'c': '2251.33', 'h': '2256', 'l': '2238', 'v': '466667', 'a': '7.86633e+08'}],
}
def run_check():
assert _hit_key({"Code": "000001", "Name": "平安银行"}, "code", "dm") == "000001"
assert _to_float("-") is None and _to_float("12.5") == 12.5
rows = fetch_rows()
assert isinstance(rows, list) and len(rows) >= 2
data = process(rows)
assert len(data) == len(rows)
assert _hit_key(rows[0], "code", "dm") not in (None, "", "-")
print("校验通过")
if __name__ == "__main__":
run_check()
print("-" * 62)
data = _get("/hs/latest/000001.SZ/d/5", default=[])
if isinstance(data, dict) and "_error" in data:
print("接口异常: %s" % data["_error"][:60])
else:
rows = data if isinstance(data, list) else []
print("样例条数: %d" % len(rows))
代码讲解：① SCAFFOLD 提供字段容错 _hit_key 与带 token 鉴权、重试退避的请求 _get，MOCK 开关让你无需 token 就能验证逻辑；② 取数封装把端点参数化，process() 把接口返回的混乱字段统一映射成中文列；③ analysis() 在本地做多列描述统计 / 主列 Top5 / 异常扫描，不消耗接口额度；④ run_check() 用断言自检，可放进 CI 持续校验。
⑤ 跑通示例（演示数据）
把上面代码保存为 hf_08.py，MOCK=True 直接跑（Python3 + requests 即可，无需其他依赖）。
预期输出：先打印 校验通过（字段容错与取数链路自检），随后 analysis() 打印本篇样本的多列统计、主数值列 Top5 与异常扫描；__main__ 末尾按代码打印样例条数。这三步通了，说明 ①字段能正确取到 ②取数链路（MOCK 回放）可用 ③数据加工能产出可用结论。关掉 MOCK、填入真实 token，把 print 换成 INSERT 即生产脚本——本篇端点数据你已能独立拉下来、落本地并跑出分析表。
⑥ 编号坑
- 路径第 3 段 d 表示日/日级粒度，不是分钟；要分钟必须走 Pro 版（周期标记 1）。
- 普通分时免费但条数/粒度受限，做分钟级因子必须上 Pro 版。
- 普通接口字段可能更少（无逐笔/盘口），别指望它能替代 Pro。
- 两者 code 后缀规则一致（.SZ/.SH/.BJ），但前缀不同（普通 /hs/latest，Pro /hs/pro/latest）。
- 选型：低频日级监控用普通，高频因子/回测用 Pro，混合用最省额度。
- 字段容错复用 _hit_key，落地前 print(keys) 核对两套字段差异。
- MOCK 演示数据两套均为虚构，实盘核对真实粒度差异。
- 权限：Pro 端点用普通 token 会报权限错误，先开通再批量。
⑦ 小结与下篇预告
普通分时胜在免费低门槛、Pro 胜在细粒度，按频率需求选型最省额度。下一篇 #09 用普通历史分时把免费数据源的批量拉取讲透。
本篇是《A股分钟级高频数据完全手册》第 08/42 篇。建议按系列顺序读：主推篇把体系与地基搭好，后面的单点篇（如 #02 起）都是换端点、加加工。
下一篇预告：【A股分钟级高频数据完全手册 #09】A股历史分时交易数据接口：普通分时怎么批量下
⑧ 免责声明
本文代码仅用于接口调用与本地数据落库的技术演示，所有示例数据均为演示数据（MOCK 开关开启），不构成任何投资建议。股市有风险，入市需谨慎；实盘使用前请在小资金下充分验证接口稳定性与字段口径。
