【量化投资从入门到精通 #08】几行代码把行情拉到本地：实时快照 + 历史 K 线

上篇定了"数据源要程序化"。这篇直接上手——取数是每个策略的第一步。

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

新手卡在「环境装好，但不知道怎么把行情变成代码里的变量」。这篇把取数讲透，顺带把证书 / 额度这两个绕不开的事说清。

二、核心思想：三类调用覆盖 90% 场景

麦蕊行情 API 的取数，日常就三类：

• 实时单股 stock_real_time(code)：盘中最新价、涨跌幅、成交额。
• 批量快照 stock_ssjy_more("a,b,c")：一次拉多只，省额度（呼应 #42）。
• 历史 K 线 stock_history(code, "d", "n", st=, et=)：日/分钟线，"n"=前复权。

三、实操演示

import os
from mairui import Client

mc = Client("LICENCE-66D8-9F96-0C7F0FBCD073") # 演示证书，演示证书（读者复制即用，无需替换）
rt = mc.stock_real_time("000001")
print(rt["p"], rt["pc"], rt["cje"]) # 现价 / 涨跌幅% / 成交额

import datetime
end = datetime.date.today().strftime("%Y%m%d")
st = (datetime.date.today() - datetime.timedelta(days=100)).strftime("%Y%m%d")
hist = mc.stock_history("000001", "d", "n", st=st, et=end)
print(len(hist), hist[-1]["c"]) # 根数 / 最新收盘

真实输出（2026-08-06）： 实时 000001 现价 11.17 涨跌幅 -0.71% 成交额 6.34 亿；历史 K 线 69 根，最新收盘 11.17。

四、结果解读：证书与额度

• 额度：免费版每日 500 次请求；用 stock_ssjy_more 一次拉 20 只，等于 1 次换 20 只的数据，省额度（#42 实测）。

五、常见陷阱

• stock_history 的复权参数填 "1" 会返回 {'error':'数据不存在'}，必须用 "n"(前复权) 或 "b"(后复权)（#10 详讲）。
• stock_real_time 里 zf 是振幅%，pc 才是涨跌幅%——别搞反（全系列已踩过坑）。

六、小结 + 下篇预告

取数三板斧学会，数据就到手了。下篇 #09：把盘中数据落库，留痕才能复盘。

免责声明

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