Python SDK 正式发布：pip install mairui 一键接入麦蕊 API

尊敬的用户，您好：

为降低量化与程序化业务的接入成本，麦蕊智数现正式发布官方 Python SDK：mairui（版本 1.0.0）。您可通过 pip 一键安装，或从本站直接下载安装包本地安装，用简洁的函数调用访问 api.mairuiapi.com 上的公开数据接口，无需再手工拼接 URL。

一、安装方式

方式 A：PyPI 安装（推荐）

pip install mairui

若国内镜像尚未同步、提示找不到包，可临时指定官方源：

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

方式 B：本站直接下载

亦可从官网下载包后本地安装（适合内网、离线或镜像延迟场景）：

• Wheel 包：mairui-1.0.0-py3-none-any.whl
• 源码 zip：mairui-1.0.0-source.zip
• sdist：mairui-1.0.0.tar.gz
• 校验文件：SHA256SUMS.txt

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

完整说明、按钮式下载与示例，请访问 SDK 专页： https://www.mairuiapi.com/sdk

安装完成后即可导入：

from mairui import Client

相关链接：

• 本站 SDK 说明与下载：https://www.mairuiapi.com/sdk
• PyPI：https://pypi.org/project/mairui/
• 源码仓库：https://github.com/MaiRuiApi/mairui
• 接口文档：https://www.mairuiapi.com/hsdata
• 在线试调（API Playground）：https://www.mairuiapi.com/playground

二、30 秒上手

from mairui import Client

with Client(licence="您的证书UUID") as api:
    # 股票列表
    stocks = api.stock_list()

    # 历史日线（可选 st / et / lt）
    bars = api.stock_history("000001.SZ", "d", "n", st="20240101", et="20241231")

    # 实时行情
    tick = api.stock_real_time("000001")

    # 财务报表
    bal = api.stock_balance("000001.SZ")

只需绑定一次 licence，后续方法会自动拼接到请求路径末段；鉴权与限流规则与直接 HTTP 调用完全一致，证书权限与配额不变。尚无证书可先 免费领取，再用 API Playground 在线试调。

三、能力概要

• 覆盖官网文档中对外公开的接口能力（股票列表、K 线与技术指标、实时行情、财务、F10、股池、指数、北交所、基金、科创等）。
• 内置连接池、Gzip、有限自动重试，适合批量拉取与回测灌数。
• 提供 api.map(...) 线程池批量调用，便于多标的并发请求。
• 查询参数与文档一致：st / et（起止时间）、lt（最新条数）。

方法与文档接口的完整对照，请见源码仓库 README，或本站 Python SDK 说明页。

四、您需要做什么？

1. 准备有效的 licence 证书（可在官网 免费领取 或购买）。
2. 通过 pip install mairui，或从 本站 SDK 页 下载安装包完成安装。
3. 参考上文示例、SDK 专页或 GitHub README 完成联调；详细接口字段说明仍以 API 文档 为准。

如有集成疑问，欢迎通过官网客服或工单联系我们。

感谢您对麦蕊智数的支持与信任！

麦蕊智数 MyData 团队
2026 年 7 月 20 日