【A股分钟级高频数据完全手册 #06】北交所分钟级数据接口：京市股票Pro版最新分时

系列：《A股分钟级高频数据完全手册》｜连载项目 · 纯 GET 取数 · 仅依赖 requests · Pro 版分钟级高频

① 你将得到什么

北交所（京市，代码 .BJ）是容易被忽略但弹性不小的市场。它的 Pro 版分钟数据走 /bj/pro/latest/{code}.BJ/1/n，结构和沪深一致，只是前缀换成 /bj/、后缀 .BJ。本篇把京市 Pro 最新分时拉通，并提示京市流动性/字段与沪深的差异。

本篇产出：用 /bj/pro/latest/{code}.BJ/1/n 拉取北交所股票最近的 N 条 Pro 版 1 分钟分时，解析字段并做统计，纳入多市场分钟数据底座。

读完这篇，你应当能独立把本篇端点数据拉下来、落本地，并跑出一份可用的加工分析表。

② 取数约定

一个端点拉数据，返回里字段名可能中英文混用（不同接口版本、不同数据源习惯不同）。演示用 你的token 占位，代码里 MOCK=True 时回放演示数据，接真实 token 把 MOCK 改成 False 即可，无需改动其他逻辑。

所有请求走 https://api.zhituapi.com + ?token=，纯 GET、仅依赖 requests，不依赖任何付费 SDK。字段口径以接口实际返回为准，本文用 _hit_key 做了大小写/中英文容错；落地前建议先用 print(r[0].keys()) 核对一次你账号下的真实字段名。

落地建议 ：把每天拉到的数据按 代码 + 日期 做主键写入本地 SQLite/CSV，避免重复插入；历史回看靠本地累积，而非反复调接口。本篇示例代码已包含字段容错映射与本地加工函数，你只需把 print 替换为写入语句。

③ 端点分组地图

端点	用途
`/bj/pro/latest/{code}.BJ/1/n`	北交所 Pro 版最新 1 分钟分时：前缀 /bj/、后缀 .BJ

本篇涉及字段（落地建表参考）：代码、名称、时间、开、收、高、低、成交量、成交额。

返回结构为 JSON 数组（或含数组字段的对象），每条记录即一根分钟 bar / 一笔明细；字段映射函数已按上述字段做容错映射，直接复用即可。

④ 核心模板函数（自包含·可跑）

python 复制代码

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("/bj/pro/latest/920000.BJ/1/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", "datetime"),
        "开": _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 = {
    "/bj/pro/latest/920000.BJ/1/5": [{'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '15.20', 'c': '15.35', 'h': '15.40', 'l': '15.18', 'v': '8000', 'a': '122800'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '9.80', 'c': '9.92', 'h': '9.95', 'l': '9.78', 'v': '5200', 'a': '51424'}, {'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '11.15', 'c': '11.26', 'h': '11.29', 'l': '11.13', 'v': '5866.67', 'a': '90053.3'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '7.84', 'c': '7.94', 'h': '7.96', 'l': '7.82', 'v': '4160', 'a': '41139.2'}, {'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '13.17', 'c': '13.3', 'h': '13.35', 'l': '13.16', 'v': '6933.33', 'a': '106427'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '9.15', 'c': '9.26', 'h': '9.29', 'l': '9.13', 'v': '4853.33', 'a': '47995.7'}, {'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '15.2', 'c': '15.35', 'h': '15.4', 'l': '15.18', 'v': '8000', 'a': '122800'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '10.45', 'c': '10.58', 'h': '10.61', 'l': '10.43', 'v': '5546.67', 'a': '54852.3'}, {'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '17.23', 'c': '17.4', 'h': '17.45', 'l': '17.2', 'v': '9066.67', 'a': '139173'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '11.76', 'c': '11.9', 'h': '11.94', 'l': '11.74', 'v': '6240', 'a': '61708.8'}, {'code': '920000.BJ', 'name': '样本京股', 't': '2024-01-10 09:31:00', 'o': '19.25', 'c': '19.44', 'h': '19.51', 'l': '19.23', 'v': '10133.3', 'a': '155547'}, {'code': '830799.BJ', 'name': '样本北证', 't': '2024-01-10 09:31:00', 'o': '13.07', 'c': '13.23', 'h': '13.27', 'l': '13.04', 'v': '6933.33', 'a': '68565.3'}],
}

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("/bj/pro/latest/920000.BJ/1/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_06.py，MOCK=True 直接跑（Python3 + requests 即可，无需其他依赖）。

预期输出：先打印 校验通过（字段容错与取数链路自检），随后 analysis() 打印本篇样本的多列统计、主数值列 Top5 与异常扫描；__main__ 末尾按代码打印样例条数。这三步通了，说明 ①字段能正确取到 ②取数链路（MOCK 回放）可用 ③数据加工能产出可用结论。关掉 MOCK、填入真实 token，把 print 换成 INSERT 即生产脚本------本篇端点数据你已能独立拉下来、落本地并跑出分析表。

⑥ 编号坑

北交所代码后缀是 .BJ、接口前缀是 /bj/，和沪深 (.SZ/.SH、/hs /hz) 完全不同，套用会 404。
京市股票流动性相对沪深低，成交量量级小，单位与阈值不要照搬沪深经验。
部分京市票盘口较薄，1 分钟 bar 可能出现零成交或跳价，清洗时要识别异常。
Pro 权限同样适用于北交所，确认账号已开通 Pro 再批量拉。
字段（o/open、v/vol）与前两市一致，_hit_key 容错复用。
时间/时区/复权规则同沪深，统一处理即可。
MOCK 演示数据虚构，实盘核对真实量级。
额度：纳入多市场后总量增大，规划好并发与限速。

⑦ 小结与下篇预告

北交所 Pro 分钟数据和沪深同构，前缀 /bj/ 与后缀 .BJ 是唯一差异点。下一篇 #07 用京市 Pro 历史分时把区间拉长。

本篇是《A股分钟级高频数据完全手册》第 06/42 篇。建议按系列顺序读：主推篇把体系与地基搭好，后面的单点篇（如 #02 起）都是换端点、加加工。

下一篇预告：【A股分钟级高频数据完全手册 #07】北交所历史分钟K线接口：京市Pro版分时批量

⑧ 免责声明

本文代码仅用于接口调用与本地数据落库的技术演示，所有示例数据均为演示数据（MOCK 开关开启），不构成任何投资建议。股市有风险，入市需谨慎；实盘使用前请在小资金下充分验证接口稳定性与字段口径。