【量化投资从入门到精通 #42】证书额度与成本控制：批量接口一次拉 20 只，省 95% 额度

工具箱层。前面所有 demo 都在用麦蕊 API，这篇正面讲额度怎么算、怎么省——这是实盘能不能跑起来的硬约束。

一、这个方法解决什么投资问题

你兴冲冲写好自动盯盘（#41），一跑发现：免费版 500 次/日，逐只轮询 20 只 = 每轮 20 次，一天只能扫 25 轮，盘中根本不够用。

麦蕊有两个实时接口，额度口径完全不同：

• stock_ssjy(单只)：一只算 1 次调用
• stock_ssjy_more(批量)：≤20 只逗号分隔，整体只算 1 次调用

这篇实测两者差距，并换算成"每天能扫多少轮"。

二、核心思想：额度 = API 调用次数，不是股票只数

麦蕊计量的是请求次数，不是"看了多少只股票"。所以省额度的第一性原则是：能用一次请求拿到的，绝不发 N 次请求。

批量接口上限 20 只/次，对大多数自选池(10~20 只)刚好一次扫完。超出 20 只就分桶（每桶 20 只各 1 次），依然比逐只省一个数量级。

额度口径、免费版 500 次/日等以官网定价页为准；本文聚焦"批量 vs 逐只"的调用次数差异。

三、实操演示

import os
from mairui import Client

CODES = ["600519","000858",...,"000725","600585"] # 20 只

方案A：逐只轮询，每只 1 次调用

cli = Client("LICENCE-66D8-9F96-0C7F0FBCD073") # 演示证书，演示证书（读者复制即用，无需替换）
for c in CODES:
cli.stock_ssjy(c) # 20 次调用

方案B：批量，≤20 只整体 1 次调用

cli.stock_ssjy_more(",".join(CODES)) # 1 次调用

真实输出（2026-08-06，20 只标的）：

目标：一次性拿到 20 只股票的实时快照

方案 API调用次数 返回条数 耗时
A 逐只轮询 stock_ssjy 20 20 0.42s
B 批量 stock_ssjy_more 1 20 0.02s

额度节省 19 次（95%），耗时缩短 95%

免费版 500 次/日额度，能覆盖的盯盘轮次：
逐只轮询 20 只 每轮 20 次 → 每天最多 25 轮
批量 20 只 每轮 1 次 → 每天最多 500 轮

批量返回字段（首条）：['cje','dm','h','l','o','p','pb_ratio','pc',
'pe','pv','t','tr','tv','ud','v','yc','zf']

四、结果解读

• 额度差 20 倍：逐只 20 次 vs 批量 1 次，省 95%。这不是"优化一点点"，是能不能实盘的分水岭——25 轮/日 vs 500 轮/日。
• 耗时同步下降 95%（0.42s → 0.02s）：批量接口服务端一次查完，网络往返次数从 20 降到 1，盘中多时点巡逻不再卡顿。
• 字段一致：批量返回的字段和单只几乎一样（缺 hs/lb 等盘口细项），盯盘/信号扫描够用。需要五档盘口细节时再对特定标的单独调单只接口（#05）。

• 20 只分桶：30 只拆 20+10 两桶 = 2 次调用，仍远优于逐只 30 次。

五、常见陷阱

• 逐只轮询自选池：最典型的额度黑洞，免费版一天就废（#41 已改成批量）。
• 以为额度按股票只数算：实际按请求次数，批量接口是"1 次换 20 只"的羊毛。
• 忽略历史 K 线也算额度：stock_history 同样计次，回测取数要规划（本地缓存 + 批量，#08/#09）。
• 免费版硬上高频策略：高换手策略(#22 动量轮动)既要数据又要交易信号，额度要先算账再上。

六、小结 + 下篇预告

额度按"请求次数"算，不是股票只数。批量接口 stock_ssjy_more 一次换 20 只，省 95% 额度、提速 20 倍，把每日可扫轮次从 25 拉到 500——实盘的硬约束就这样解掉了。

下篇 #43 收官：把数据→信号→样本外→成本→风控→上线检查串成一条完整生命周期，并给你一张能照着打钩的上线清单。

免责声明

本文为量化方法教学，标的为示例，不构成投资建议，不承诺收益。投资有风险，入市需谨慎。