【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #25】北交所财务技术指标难搞？12个接口，报表+MACD全拿

系列：别再到处找免费股票数据API了：官方204个接口，32篇一次讲透｜连载项目 · 纯 GET 取数 · 仅依赖 requests 适用：做量化 / 选股 / 复盘，但还在手动导 CSV、网页复制、自写爬虫的读者。本篇给北交所财务与技术指标的 12 个端点的分组地图、北交所报表与技术指标的代码，全部只依赖 requests，所有示例均为演示数据，不构成投资建议。

1. 你将得到什么

读完这一篇，你能拿走四样东西：

一张分组地图：12 个端点按用途分组，知道什么数据该敲哪个门；
一行取数的代码：主要端点一次返回，不用循环拼装；
北交所报表缺项与技术指标序列短的坑；
三个真实踩坑点，都是第一次用几乎一定会踩的。

代码全部自包含，复制进 .py 直接能跑，不依赖 numpy / pandas。

2. 本篇取数约定

全部接口都是 GET + query 参数，token 放在查询串里（?token=xxx）；
统一基址 https://api.zhituapi.com；
代码块里的 你的token 是占位符，换成你的 token 即可；
所有接口路径均取自官方已验证文档，跨篇零重复。

3. 12 个端点分 2 组

先建立地图。北交所财务与技术指标一共 12 个端点，按用途分：

组	端点	用途	更新频率
财务	`/bj/fin/balance`	资产负债表	每季度
财务	`/bj/fin/income`	利润表	每季度
财务	`/bj/fin/cashflow`	现金流量表	每季度
财务	`/bj/fin/ratios`	财务指标	每季度
财务	`/bj/fin/capital`	股本结构	每季度
财务	`/bj/fin/topholder`	十大股东	季度
财务	`/bj/fin/flowholder`	流通股东	季度
财务	`/bj/fin/hm`	股东户数	季度
技术指标	`/bj/history/macd`	MACD	每日盘后
技术指标	`/bj/history/ma`	MA	每日盘后
技术指标	`/bj/history/boll`	BOLL	每日盘后
技术指标	`/bj/history/kdj`	KDJ	每日盘后

4. 核心模板函数

import requests, time
from urllib.parse import quote

BASE = "https://api.zhituapi.com"
TOKEN = "你的token"

# ---------- 1. 字段容错与类型归一 ----------
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


# ---------- 2. 统一请求：重试 + 退避 ----------
def _get(path, params=None, timeout=10, retries=2, backoff=0.6, default=None):
    """返回 JSON；失败重试 retries 次仍失败则返回 {'_error': 原因}"""
    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}

def fetch_bj_fin_balance(): return _get("/bj/fin/balance", default=[])
def fetch_bj_fin_income(): return _get("/bj/fin/income", default=[])
def fetch_bj_fin_cashflow(): return _get("/bj/fin/cashflow", default=[])
def fetch_bj_fin_ratios(): return _get("/bj/fin/ratios", default=[])
def fetch_bj_fin_capital(): return _get("/bj/fin/capital", default=[])
def fetch_bj_fin_topholder(): return _get("/bj/fin/topholder", default=[])
def fetch_bj_fin_flowholder(): return _get("/bj/fin/flowholder", default=[])
def fetch_bj_fin_hm(): return _get("/bj/fin/hm", default=[])
def fetch_bj_history_macd(): return _get("/bj/history/macd", default=[])
def fetch_bj_history_ma(): return _get("/bj/history/ma", default=[])
def fetch_bj_history_boll(): return _get("/bj/history/boll", default=[])
def fetch_bj_history_kdj(): return _get("/bj/history/kdj", default=[])

# ---------- 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
    enc = "/x/%s" % quote("示例")
    assert "示例" not in enc and "%" in enc
    print("校验通过")


if __name__ == "__main__":
    run_check()
    print("-" * 62)
    for name, path in [
                               ("资产负债表", "/bj/fin/balance"),
                       ("利润表", "/bj/fin/income"),
                       ("现金流量表", "/bj/fin/cashflow"),
                       ("财务指标", "/bj/fin/ratios"),
                       ("股本结构", "/bj/fin/capital"),
                       ("十大股东", "/bj/fin/topholder"),
                       ("流通股东", "/bj/fin/flowholder"),
                       ("股东户数", "/bj/fin/hm"),
                       ("MACD", "/bj/history/macd"),
                       ("MA", "/bj/history/ma"),
                       ("BOLL", "/bj/history/boll"),
                       ("KDJ", "/bj/history/kdj")
    ]:
        data = _get(path, default=[])
        if isinstance(data, dict) and "_error" in data:
            print("%-12s %-40s -> %s" % (name, path, data["_error"][:60]))
        else:
            print("%-12s %-40s -> %d 条" % (name, path, len(data)))

5. 跑通示例

把上面的代码复制到本地，填入你的 token 即可直接运行：它会请求对应接口、拉取真实数据，并输出各端点的条数（各字段含义见前文各小节）。

6. 坑与注意事项

坑 1：报表可能缺项。 北交所财务报表 /bj/fin/* 与沪深同源但可能缺项，取数前确认。

坑 2：序列短。 北交所技术指标 /bj/history/{macd,...} 序列短，参数范围要小。

坑 3：流动性低噪音大。 北交所流动性低，技术指标信号噪音大，别直接套沪深策略。

7. 小结与下篇预告

本篇把北交所财务与技术指标类 12 个端点分成 2 组，给出报表与 MACD 的代码，并用 run_check 验证字段容错。

下一篇：《【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #26】科创板实时行情难找？3个接口，股票列表+五档盘口全拉》：用本篇同组接口，把下一类数据一次取全。

8. 免责声明

本文仅演示北交所财务与技术指标数据的取数方法，所有代码示例均为演示数据，未含任何真实行情数值，不构成投资建议，亦不承诺收益。