Python SDK

官方 Python 客户端 mairui（当前版本 1.0.0）。 绑定 licence 后即可按函数调用行情、指标、财务等公开接口，无需手工拼接 URL。

一、安装

推荐通过 PyPI 安装：

pip install mairui

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

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

PyPI：https://pypi.org/project/mairui/  |  源码：GitHub

二、本站直接下载

也可从本站下载安装包，下载后本地安装：

pip install ./mairui-1.0.0-py3-none-any.whl
下载 Wheel（.whl） 下载源码包（.zip） 下载 sdist（.tar.gz） SHA256 校验

文件路径：/auth/media/downloads/sdk/mairui/

三、30 秒上手

from mairui import Client

with Client(licence="您的证书UUID") as api:
    stocks = api.stock_list()
    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 调用一致。证书可在 证书获取 页面申请。

四、能力与文档

  • 覆盖官网文档中的公开接口（列表、K 线与指标、实时、财务、F10、股池、指数、北交所、基金、科创等）。
  • 内置连接池、Gzip、有限自动重试；提供 api.map(...) 便于多标的批量拉取。
  • 查询参数与文档一致：st / et（起止时间）、lt（最新条数）。

接口字段说明请查阅 沪深 A 股 API 文档 （同站指数、基金等文档页同样适用）。 接入流程亦可参考 接入方法。