【Python量化实战 #01】Python股票API入门：pip install mairui 10分钟拉取A股行情

如果你正在用 Python 做量化、选股或行情监控，却还在手写 URL、拼 licence、处理超时重试——可以先停一下。麦蕊智数官方 Python SDK mairui 已经上线，一行 pip install mairui 就能把「股票 API / 行情接口」接到你的脚本里。

本系列为「Python量化实战」第 1 篇（#01），目标只有一个：让你在 10 分钟内完成安装、绑定证书，并成功拉到第一份 A 股数据。后续将持续更新历史 K 线、实时行情、技术指标、财报与更多实战主题。

为什么选择 mairui Python SDK？

• 官方维护：对接 api.mairuiapi.com，与官网文档字段一致。
• 少写样板代码：绑定一次 licence，方法自动拼到路径末段。
• 工程友好：连接池、Gzip、有限重试、api.map 批量并发。
• 多入口获取：PyPI、GitHub，以及本站 SDK 页直接下载安装包。

安装：三种常用方式

方式 A（推荐）

pip install mairui

若国内镜像尚未同步，可临时走官方源：

pip install mairui -i https://pypi.org/simple --trusted-host pypi.org --trusted-host files.pythonhosted.org

方式 B：本站下载（适合内网/离线）——打开 https://www.mairuiapi.com/sdk 下载 .whl 后执行：

pip install ./mairui-1.0.0-py3-none-any.whl

PyPI：https://pypi.org/project/mairui/
源码：https://github.com/MaiRuiApi/mairui

准备 licence 证书

所有接口都需要有效证书。没有证书可先 免费领取； 也可以用官网 API Playground 在浏览器里先试调通，再写 Python。

第一行有效代码

from mairui import Client

LICENCE = "你的证书UUID"

with Client(licence=LICENCE) as api:
    stocks = api.stock_list()
    print(type(stocks), len(stocks) if hasattr(stocks, "__len__") else stocks)
    if stocks:
        print(stocks[0])

stock_list() 会返回沪深股票列表（JSON 数组），这是后面做代码映射、批量拉 K 线的基础表。

再补一个「看得见涨跌」的实时例子：

with Client(licence=LICENCE) as api:
    tick = api.stock_real_time("000001")
    print(tick)

查询参数约定（全系列通用）

• st / et：起止时间，如 20240101 或带时分秒
• lt：只要最新 N 条（从尾部截取）

不传则按证书权限返回服务端可用完整数据。详细字段说明见 沪深基础数据 API 文档。

常见问题

Q：提示找不到包？
换官方源，或改用本站 .whl 安装。

Q：返回鉴权/限额错误？
检查 licence 是否粘贴完整、是否过期、当日免费额度是否用尽；付费证书可在官网升级。

Q：想少写代码先看 JSON？
用 Playground 调通后再把 URL 迁到 SDK。

下一篇预告

第 2 篇（#02）将讲：如何用 stock_history 拉取日线/分钟线，整理成回测可用的 DataFrame，并注意除权与频率选择。

关键词延伸：Python 股票 API、A股行情接口、量化数据接入、pip install mairui、麦蕊智数。

麦蕊智数 MyData 团队 · Python量化实战 #01