一、为什么写这篇很多人想用 Python 做量化第一步就卡在「环境装好了代码也抄了一跑全是 401 / 证书错误」。问题往往不在代码而在证书怎么放、接口字段怎么读。这篇就把这两件事一次讲透从装 SDK、配证书到打出你的第一笔真实实时行情全程可复制、全程跑通过。读完你会发现——所谓「量化」第一脚其实特别轻。二、读完你能得到什么一条命令装好mairuiSDK用环境变量安全保管证书不硬编码、不泄露用stock_real_time打出任意股票的实时行情搞懂返回字段里pc/zf/ud到底哪个是涨跌幅这里坑最多一个能直接复用的main.py。三、环境准备pipinstallmairui本文 demo 跑在 Python 3.9 环境已预装mairui。任何 Python 3.7 均可。证书怎么放红线麦蕊证书是一串密钥绝不能写进代码、也不能发到网上。正确做法是用环境变量# Linux / macOSexportMAIRUI_LICENCE你的麦蕊证书# Windows PowerShell$env:MAIRUI_LICENCE你的麦蕊证书脚本里只读取这个变量名绝不打印证书原文。后面所有文章都沿用这个约定。四、核心代码新建main.pyimportosfrommairuiimportClientdeffmt(v,nd2):returnf{v:.{nd}f}ifisinstance(v,(int,float))elsestr(v)defmain():# 1) 取证书仅从环境变量读取绝不打印明文# 未设置环境变量时把下面的占位符替换成你自己的正式证书即可licenceos.environ.get(MAIRUI_LICENCE,LICENCE-66D8-9F96-0C7F0FBCD073)ifnotlicence:raiseRuntimeError(未找到麦蕊证书请设置环境变量 MAIRUI_LICENCE)# 2) 建立客户端mcClient(licence)# 3) 打一笔实时行情平安银行(000001)qmc.stock_real_time(000001)# 4) 打印注意涨跌幅是 pc振幅是 zf别搞混print(f现价 p :{fmt(q.get(p))})print(f昨收 yc :{fmt(q.get(yc))})print(f涨跌幅 pc :{fmt(q.get(pc))}%)print(f振幅 zf :{fmt(q.get(zf))}%)print(f成交额 cje:{fmt(q.get(cje))})print(f换手率 tr :{fmt(q.get(tr))}%)print(f时间 t :{q.get(t)})pcq.get(pc)ifisinstance(pc,(int,float)):arrow▲ 涨ifpc0else(▼ 跌ifpc0else— 平)print(f\n方向{arrow}{fmt(pc)}%)if__name____main__:main()五、跑出来的真实结果这是本机当天实跑输出非虚构 实时行情000001 现价 p : 11.13 昨收 yc : 11.25 涨跌幅 pc : -1.07 % 振幅 zf : 1.24 % 成交额 cje: 461742300.00 换手率 tr : 0.21 % 时间 t : 2026-08-06 10:39:00 方向▼ 跌 -1.07% ✅ 跑通了这就是你的第一笔实时行情。看到✅ 跑通了恭喜——你的量化第一脚已经落地。六、原理拆解口语化把stock_real_time想成「给交易所递一张便条问某只股票现在多少钱」。它返回的是一个字典字段含义如下实测核对别信直觉字段含义常见误解p现价—yc昨收—pc涨跌幅 %很多人误用zfud涨跌额—zf振幅 %最高最低之差不是涨跌幅cje成交额元—tr换手率 %—一句话记忆pc涨跌percentage changezf振幅zigzag。我第一版 demo 就把zf当涨跌幅用了结果现实价低于昨收却显示「涨 1.24%」自己跑一遍才抓出来——所以所有代码都先实跑再成文。七、常见坑把zf当涨跌幅上面说了红绿方向会反。把实时接口当历史用stock_real_time只有「此刻」一个快照要历史 K 线请用stock_history下篇讲。额度算错每次实时查询计 1 次 API 额度免费版有每日上限别在循环里无脑刷。八、小结 下篇预告今天你跑通了量化的「Hello World」装 SDK、配证书、打出第一笔实时行情。接下来两篇我们会#02用stock_history取历史 K 线手算最大回撤、年化波动、夏普比率——把「基金宣传页上的指标」自己算一遍你就再也不会被忽悠。#03把行情落进 SQLite搭一个本地行情库。⚠️ 本文仅为技术实现演示不构成任何投资建议。文中涉及的接口与字段以麦蕊官方文档为准市场有风险投资须谨慎。代码示例仅用于学习不对实盘盈亏负责。