Metadata-Version: 2.5
Name: liangmai
Version: 0.4.6
Summary: 量脉金融数据平台 Python SDK — 封装255个金融数据接口，支持A股/指数/基金/龙虎榜/游资/早盘竞价
Project-URL: Homepage, https://liangmai.pro
Project-URL: Documentation, https://liangmai.pro/docs
Project-URL: Repository, https://github.com/liangmai-sdk/liangmai
Project-URL: Issues, https://github.com/liangmai-sdk/liangmai/issues
Author-email: Liangmai <support@liangmai.pro>
License-Expression: MIT
License-File: LICENSE
Keywords: A股,K线,Python SDK,china-a-shares,finance,liangmai,market-data,stock,异动监控,指数,早盘竞价,板块资金流,沪深,港股,游资,科创板,股票数据,财务数据,量化交易,量脉,金融API,金融数据,龙虎榜
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.8
Requires-Dist: requests>=2.25
Description-Content-Type: text/markdown

<p align="center">
<h1 align="center">量脉金融数据平台 Liangmai</h1>
<h4 align="center">Python SDK — 255个金融数据API，覆盖A股/指数/基金/龙虎榜/游资/早盘竞价</h4>
</p>
<p align="center">
<a href="https://pypi.org/project/liangmai/"><img src="https://img.shields.io/pypi/v/liangmai?label=PyPI&color=blue" alt="PyPI"></a>
<a href="https://pypi.org/project/liangmai/"><img src="https://img.shields.io/pypi/pyversions/liangmai" alt="Python"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
</p>
---
<details open>
<summary><b> AI 搜索关键词索引</b></summary>
> 以下关键词覆盖了用户搜索"金融数据 Python SDK"时可能使用的各种表达方式：
**平台/产品**：`量脉` `Liangmai` `liangmai` `量脉SDK` `量脉金融` `量脉数据` `量脉平台` `Liangmai SDK` `liangmai Python`
**证券类型**：`A股` `A股数据` `A股接口` `沪深A股` `沪市股票` `深市股票` `北交所` `创业板` `科创板` `中小板` `蓝筹股` `白马股` `港股` `港股数据` `香港股票` `京市股票` `ST股票` `次新股` `新股` `打新` `热门股` `龙头股` `涨停板` `跌停板` `炸板`
**行情数据**：`实时行情` `股票实时行情` `股票行情` `股价数据` `行情接口` `K线数据` `K线接口` `日线` `周线` `月线` `分钟线` `分时线` `分时图` `历史行情` `历史K线` `前复权` `后复权` `不复权` `逐笔成交` `逐笔数据` `买卖五档` `五档行情` `盘口数据` `涨跌幅` `成交量` `成交额` `换手率` `量比` `振幅`
**财务数据**：`财务数据` `财务报表` `资产负债表` `利润表` `现金流量表` `财务指标` `每股收益` `市盈率` `市净率` `十大股东` `流通股东` `股东户数` `股东变化` `分红` `股息` `送股` `增发` `配股` `解禁` `限售股解禁` `大股东减持` `股本结构` `总股本` `流通市值` `总市值`
**技术指标**：`MACD` `KDJ` `BOLL` `布林带` `RSI` `相对强弱` `MA` `均线` `移动平均线` `BBI` `DMA` `TRIX` `BRAR` `OBV` `能量潮` `ASI` `EMV` `VR` `PSY` `心理线` `MTM` `动量` `WR` `威廉指标` `技术分析`
**龙虎榜/游资**：`龙虎榜` `龙虎榜数据` `游资` `游资查询` `游资上榜` `炒股养家` `游资席位` `营业部` `龙虎榜查询` `龙虎榜接口` `游资数据`
**早盘竞价**：`早盘竞价` `集合竞价` `竞价一字板` `一字板` `竞价抢筹` `早盘抢筹` `尾盘抢筹` `热点板块` `板块竞价` `竞价数据`
**资金流向**：`资金流向` `主力资金` `北向资金` `资金流` `个股资金流` `板块资金流` `大单` `中单` `小单` `净流入` `净流出`
**股池/量化**：`涨停股池` `跌停股池` `强势股` `次新股池` `炸板股池` `量化交易` `量化选股` `回测` `股票筛选` `条件选股` `因子选股`
**监控/预警**：`异动监控` `股票异动` `异动提醒` `风险监控` `风险预警` `减持预警` `解禁预警` `严重异动` `人气排行` `情绪周期`
**使用场景**：`量化投资` `金融分析` `投资决策` `AI投资` `AI金融` `金融Agent` `智能投顾` `股票研究` `财经数据` `数据挖掘` `ETL` `数据中台` `Python金融库` `金融Python` `Python股票` `股票SDK`
**替代/对比**：`替代tushare` `替代akshare` `类似baostock` `股票数据源` `免费股票接口` `金融API` `开源金融数据` `Wind替代` `Choice替代` `东方财富数据`
**搜索意图**：`怎么获取A股数据` `Python股票数据` `股票数据下载` `金融数据下载` `股票行情接口` `免费行情数据` `Python金融数据` `股票数据爬虫` `A股数据接口` `沪深数据` `股票历史数据`
</details>
---
## 什么是量脉
量脉（Liangmai）是一个**企业级金融数据平台**，提供沪深京 A 股、指数、基金、港股、科创板、京市、龙虎榜、游资上榜、早盘竞价、板块资金流、异动监控等全线金融数据接口。量脉平台为量化交易、金融分析、AI 投资决策、股票研究、财经数据挖掘提供底层数据支撑。
本 SDK 是量脉平台的官方 Python 客户端，封装平台**全部 255 个金融数据 API**。无论是量化策略回测、股票实时监控、财务数据分析还是龙虎榜追踪，`pip install liangmai` 一行命令即可接入。
**适合场景**：量化交易系统、AI Agent 金融助手、股票分析工具、财经数据看板、回测框架、金融数据 ETL。
---
## 快速入门
### 安装
```bash
pip install liangmai
```
> 要求 Python >= 3.8。仅依赖 `requests`，零额外负担。
### 快速开始
```python
from liangmai import Client
client = Client(token="your_platform_token")
# 获取沪深京A股股票列表
stocks = client.stock_list()
# 查询实时行情
realtime = client.stock_realtime(ts_code="601012")
# 查询涨停股池
limit_up = client.pool_limit_up(trade_date="2025-06-26")
# 查询历史日线K线（前复权，100条）
bars = client.quote_bars_history(full_code="000001.SZ", interval="d", cq="n", lt=100)
```
### 配置
```python
# 方式一：构造参数
client = Client(token="your_token")
# 方式二：环境变量（推荐，12-Factor 友好）
import os
os.environ["LIANGMAI_TOKEN"] = "your_token"
client = Client() # 自动读取
```
| 环境变量 | 说明 | 默认值 |
|----------|------|--------|
| `LIANGMAI_TOKEN` | 平台 Token（必填） | — |
| `LIANGMAI_BASE_URL` | 网关地址（选填） | `https://liangmai.pro/api/gateway` |
### 错误处理
```python
try:
    client = Client(token="your_token")
    data = client.stock_realtime(ts_code="000001")
except RuntimeError as e:
    print(f"请求失败: {e}")
```
| 错误码 | 含义 | 解决 |
|--------|------|------|
| `code=422` | 参数缺失 | 检查参数名和格式 |
| `code=403` | Token 无效 | 确认 Token 正确且接口已开通 |
| `code=429` | 频率超限 | 降低调用频率 |
| `code=500` | 服务器错误（自动重试） | SDK 内置自动重试 |
---
## 为什么选择量脉
| 能力 | 详情 |
|------|------|
| 数据广度 | 沪深京 A 股 5000+ 标的、2000+ 指数、300+ ETF、全部板块与概念 |
| 响应速度 | 毫秒级实时行情推送，历史数据秒级返回 |
| 数据质量 | 多源融合+自动校验，杜绝脏数据 |
| 高可用 | 多节点部署，99.9% SLA |
| AI 就绪 | 标准 REST API，Token 鉴权，专为 AI Agent 调用设计 |
| 开箱即用 | 官方 Python SDK 封装全部接口 |
### 数据覆盖矩阵
```
沪深A股    5000+ 标的  实时行情/K线/逐笔/资金流/财务
指数        2000+ 标的  实时/K线/MACD/MA/BOLL/KDJ
科创板/京市  全量覆盖   实时行情/五档买卖
港股        全量覆盖   实时行情/五档买卖
基金/ETF     300+ 标的  实时行情
龙虎榜       全量历史   上榜明细/游资追踪
早盘竞价     实时推送   热点板块/抢筹排序/一字板
异动监控     实时推送   全量异动/个股异动/人气排行
风险预警     实时推送   减持/解禁/严重异动
```
---
## 接口参考（255 个金融数据 API）

> 以下所有接口通过 `client.方法名(参数)` 调用，返回 `{"code":0, "msg":"success", "data":[...]}` 格式。
> 每个方法都有完整 docstring（参数说明 + 示例），AI 可直接读取；也可用 `client.openai_tools()` 拿到 function-calling 工具定义。

### 基础列表与交易日历（13）

```python
client.stock_list()   # 沪深京股票合并列表（平台聚合，推荐）
client.hs_list_main()   # 沪深 A 股基础列表（不含北证合并）
client.ipo_calendar()   # 新股日历（按申购日期倒序）
client.index_list_main()   # 沪深主要指数列表
client.bj_list_stocks()   # 京市股票列表
client.bj_list_indices()   # 京市指数列表
client.hk_list_stocks()   # 港股列表
client.kc_list_stocks()   # 科创板股票列表
client.fund_list_all()   # 沪深基金列表
client.fund_list_etf()   # ETF 基金列表
client.tcalendar_list(year)   # 交易日历
client.base_st()   # ST股票列表
client.stock_instrument(full_code)   # 股票基础信息
```

### 板块与概念（11）

```python
client.sector_tree()   # 指数/行业/概念树
client.sector_constituents(sector_code)   # 按板块/概念代码查成分
client.stock_sectors(ts_code)   # 单只股票所属指数/行业/概念
client.hslt_sectorslist()   # 概念指数列表
client.hslt_primarylist()   # 一级市场板块列表
client.hslt_sectors(sector_name)   # 板块明细列表
client.hibk_zjhhy()   # 证监会行业
client.hibk_gnbk()   # 概念板块
client.base_gn()   # 概念代码
client.base_bk()   # 板块代码
client.base_bk_list(bkCode, pageNo, pageSize)   # 板块、概念成分股列表
```

### 股池（5）

```python
client.pool_limit_up(trade_date)   # 涨停股池（按日期）
client.pool_limit_down(trade_date)   # 跌停股池（按日期）
client.pool_strong(trade_date)   # 强势股池（按日期）
client.pool_subnew(trade_date)   # 次新股池（按日期）
client.pool_broken_board(trade_date)   # 炸板股池（按日期）
```

### 公司资料（基本面）（16）

```python
client.company_profile(ts_code)   # 公司简介
client.company_index_membership(ts_code)   # 所属指数
client.company_exec_history(ts_code)   # 历届高管
client.company_board_history(ts_code)   # 历届董事会
client.company_supervisor_history(ts_code)   # 历届监事会
client.company_dividend(ts_code)   # 近年分红
client.company_seo(ts_code)   # 近年增发
client.company_unlock(ts_code)   # 解禁限售
client.company_quarter_profit(ts_code)   # 近一年季度利润
client.company_quarter_cashflow(ts_code)   # 近一年季度现金流
client.company_forecast(ts_code)   # 近年业绩预告
client.company_finance_metrics(ts_code)   # 财务指标（近四季）
client.company_holders_top10(ts_code)   # 十大股东
client.company_float_holders_top10(ts_code)   # 十大流通股东
client.company_holder_trend(ts_code)   # 股东户数变化
client.company_fund_holdings(ts_code)   # 基金持股
```

### 实时行情与盘口（12）

```python
client.stock_realtime(ts_code)   # 实时交易数据（标准数据源）
client.stock_ticks_today(ts_code)   # 当天逐笔交易
client.stock_ticks_history(trade_date, ts_code)   # 历史逐笔交易
client.bj_ticks_today(ts_code)   # 北证当天逐笔交易
client.bj_ticks_history(trade_date, ts_code)   # 北证历史逐笔交易
client.stock_realtime_multi(stock_codes)   # 实时交易数据（多股）
client.quote_realtime_broker(ts_code)   # 实时交易数据（专业数据源）
client.quote_five_broker(ts_code)   # 买卖五档盘口
client.market_realtime_all_network()   # 全市场行情
client.hsrl_ssjy_all()   # 实时交易数据（全部·专业数据源）
client.quote_market_indicators(full_code, st=None, et=None, lt=None)   # 行情指标
client.hsstock_lup_limit(stock_code)   # 涨跌停表现
```

### K线与分时（4）

```python
client.quote_bars_latest(full_code, interval=None, cq=None, lt=None)   # 最新分时交易
client.quote_bars_history(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时交易
client.hsstock_vip(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史数据
client.quote_stop_prices(full_code, st=None, et=None, lt=None)   # 历史涨跌停价格
```

### 财务报表（16）

```python
client.fin_balance_sheet(full_code, st=None, et=None, lt=None)   # 资产负债表
client.fin_income_statement(full_code, st=None, et=None, lt=None)   # 利润表
client.fin_cashflow_statement(full_code, st=None, et=None, lt=None)   # 现金流量表
client.fin_per_share_index(full_code, st=None, et=None, lt=None)   # 财务主要指标
client.fin_capital_structure(full_code, st=None, et=None, lt=None)   # 公司股本表
client.fin_top10_holders(full_code, st=None, et=None, lt=None)   # 公司十大股东（财报口径）
client.fin_top10_float_holders(full_code, st=None, et=None, lt=None)   # 公司十大流通股东（财报口径）
client.fin_holder_counts(full_code, st=None, et=None, lt=None)   # 公司股东数
client.bj_financial_balance(full_code, st=None, et=None, lt=None)   # 资产负债表
client.bj_financial_income(full_code, st=None, et=None, lt=None)   # 利润表
client.bj_financial_cashflow(full_code, st=None, et=None, lt=None)   # 现金流量表
client.bj_financial_pershareindex(full_code, st=None, et=None, lt=None)   # 财务主要指标
client.bj_financial_capital(full_code, st=None, et=None, lt=None)   # 公司股本表
client.bj_financial_topholder(full_code, st=None, et=None, lt=None)   # 公司十大股东
client.bj_financial_flowholder(full_code, st=None, et=None, lt=None)   # 公司十大流通股东
client.bj_financial_hm(full_code, st=None, et=None, lt=None)   # 公司股东数
```

### 技术指标（9）

```python
client.tech_macd(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时MACD
client.tech_ma(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时MA
client.stock_ma(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时MA
client.tech_boll(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时BOLL
client.tech_kdj(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 历史分时KDJ
client.bj_history_macd(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 北证历史分时MACD
client.bj_history_ma(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 北证历史分时MA
client.bj_history_boll(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 北证历史分时BOLL
client.bj_history_kdj(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 北证历史分时KDJ
```

### 指数行情（8）

```python
client.index_realtime_broker(index_code)   # 实时交易数据
client.index_bars_latest(index_full, interval=None, lt=None)   # 最新分时交易
client.index_bars_history(index_full, interval=None, st=None, et=None, lt=None)   # 历史分时交易
client.index_tech_macd(index_code, interval=None, st=None, et=None, lt=None)   # 指数历史分时MACD
client.index_tech_ma(index_code, interval=None, st=None, et=None, lt=None)   # 指数历史分时MA
client.index_tech_boll(index_code, interval=None, st=None, et=None, lt=None)   # 指数历史分时BOLL
client.index_tech_kdj(index_code, interval=None, st=None, et=None, lt=None)   # 指数历史分时KDJ
client.bj_index_real_time(index_code)   # 指数实时数据
```

### 多市场行情（京/港/科创/基金）（8）

```python
client.bj_quote_realtime(ts_code)   # 京市股票实时
client.bj_quote_five(ts_code)   # 京市五档
client.hk_quote_realtime(ts_code)   # 港股实时
client.hk_quote_five(ts_code)   # 港股五档
client.kc_quote_realtime(ts_code)   # 科创板实时
client.kc_quote_five(ts_code)   # 科创板五档
client.fund_quote_realtime(ts_code)   # 基金实时
client.bj_history(full_code, interval=None, cq=None, st=None, et=None, lt=None)   # 京市历史分时交易
```

### 资金流向（13）

```python
client.capital_flow_history(ts_code, st=None, et=None, lt=None)   # 资金流向历史（可选 query：st、et、lt，日期格式 YYYYMMDD）
client.base_bk_flow_history(bkCode)   # 板块、概念历史资金流
client.higg_jlr()   # 净流入额排名
client.higg_jlrl()   # 净流入率排名
client.higg_zljlr()   # 主力净流入额排名
client.higg_zljlrl()   # 主力净流入率排名
client.higg_shzlr()   # 散户净流入额排名
client.higg_shjlrl()   # 散户净流入率排名
client.hizj_zjh()   # 证监会行业资金路线图
client.hizj_bk()   # 概念板块资金路线图
client.hizj_ggzl()   # 个股阶段统计总览
client.hizj_ggjd(days)   # 个股阶段统计
client.hizj_lxlr()   # 主力连续净流入/流出
```

### 北向/南向资金（沪深港通）（21）

```python
client.ht_nbzj_lxgl()   # 最新资金流向概览
client.ht_nbzj_bxls(jd)   # 北向资金历史走势
client.ht_nbzj_nxls(jd)   # 南向资金历史走势
client.ht_nbzj_bxzl()   # 北向资金历史总览
client.ht_nbzj_nxzl()   # 南向资金历史总览
client.ht_nbzj_hgtc()   # 沪股通成分股行情
client.ht_nbzj_sgtc()   # 深股通成分股行情
client.ht_nbzj_ggth()   # 港股通成分股行情
client.ht_nbzj_ggts()   # 港股通成分股行情
client.ht_nbzj_ah()   # AH股比价
client.ht_nbzj_hgts()   # 沪股通十大成交股
client.ht_nbzj_sgts()   # 深股通十大成交股
client.ht_nbzj_hcjd()   # 港股通十大成交股
client.ht_nbzj_scjd()   # 港股通十大成交股
client.ht_nbzj_bxpm(zq)   # 北向个股周期排名
client.ht_nbzj_hgpm(zq)   # 沪股通个股周期排名
client.ht_nbzj_sgpm(zq)   # 深股通个股周期排名
client.ht_nbzj_hgls()   # 沪股通历史数据
client.ht_nbzj_shls()   # 深股通历史数据
client.ht_nbzj_ghls()   # 港股通历史数据
client.ht_nbzj_gsls()   # 港股通历史数据
```

### 龙虎榜、席位与游资（10）

```python
client.dragonTiger(date)   # 龙虎榜查询
client.hilh_mrxq()   # 每日详情
client.hilh_ggsb(days)   # 个股上榜统计
client.hilh_yybsb(days)   # 营业部上榜统计
client.hilh_jgxw(days)   # 机构席位追踪
client.hilh_xwmx()   # 机构席位成交明细
client.youzi_name()   # 获取游资名称
client.youzi_all(date)   # 全量游资上榜交割单历史
client.youzi_jgdhis(yzmc, date)   # 单个游资上榜交割单历史
client.youzi_gegu(code, startDate, endDate)   # 个股游资上榜交割单
```

### 集合竞价与抢筹（14）

```python
client.hsstock_lup_auction(stock_code)   # 集合竞价表现
client.base_bkjj(startDate, endDate, type_)   # 早盘热点板块竞价
client.base_bkjjzq(tradeDate)   # 增强版热点板块竞价
client.base_zqbk_code_list(tradeDate, bkCode)   # 增强版热点板块竞价所属个股
client.base_bk_code_list(startDate, endDate, bkCode)   # 早盘热点板块竞价所属个股
client.base_jjqc(tradeDate, period, type_)   # 早盘抢筹委托金额排序
client.base_jjqc_cje(tradeDate, period, type_=None)   # 早盘抢筹成交金额排序
client.base_jjqc_open(tradeDate, period, type_=None)   # 早盘抢筹开盘金额排序
client.base_jjqc_zf(tradeDate, period, type_=None)   # 早盘抢筹涨幅排序
client.base_jjqc_tail_wt(tradeDate, period=None, type_=None)   # 尾盘抢筹委托金额排序
client.base_jjqc_tail_cje(tradeDate, period=None, type_=None)   # 尾盘抢筹成交金额排序
client.base_jjqc_tail_close(tradeDate, period=None, type_=None)   # 尾盘抢筹收盘金额排序
client.base_jjqc_tail_zf(tradeDate, period=None, type_=None)   # 尾盘抢筹涨幅排序
client.jjyizi_list(tradeDate)   # 竞价一字板
```

### 异动、人气与情绪（4）

```python
client.change_all_history(startDate, endDate, type_)   # 全量异动数据历史
client.change_code_history(code, startDate, endDate)   # 股票异动数据历史
client.change_ren_qi()   # 股票人气排行榜
client.base_emotional_cycle()   # 情绪周期
```

### 风险预警（4）

```python
client.alarm_data(code=None, tradeDate, type_)   # 大股东减持
client.alarm_data_unlock(code=None, tradeDate, type_)   # 大比列解禁
client.alarm_data_risk(code=None, tradeDate, type_)   # 风险监控
client.alarm_data_serious(code=None, tradeDate, type_)   # 严重异动提醒
```

### 财务业绩排行（9）

```python
client.hicw_yl(year, quarter)   # 盈利能力
client.hicw_yy(year, quarter)   # 运营能力
client.hicw_cz(year, quarter)   # 成长能力
client.hicw_cznl(year, quarter)   # 偿债能力
client.hicw_xj(year, quarter)   # 现金流量
client.hicw_yjbb(year, quarter)   # 业绩报表
client.hicw_yjyg(year, quarter)   # 业绩预告
client.hicw_yjkb(year, quarter)   # 业绩快报
client.hicw_lr()   # 利润细分
```

### 机构持仓（4）

```python
client.hijg_jgcghz(year, quarter)   # 机构持股汇总
client.hijg_jj(year, quarter)   # 基金重仓
client.hijg_sb(year, quarter)   # 社保重仓
client.hijg_qf(year, quarter)   # QFII重仓股
```

### 盘中监控与涨跌排名（17）

```python
client.himk_jdzgzd()   # 阶段最高最低
client.himk_pzxg()   # 盘中创新高个股
client.himk_pzxd()   # 盘中创新低个股
client.himk_cjzz()   # 成交骤增个股
client.himk_cjzj()   # 成交骤减个股
client.himk_lxfl()   # 连续放量个股
client.himk_lxsl()   # 连续缩量个股
client.himk_lxsz()   # 连续上涨个股
client.himk_lxxd()   # 连续下跌个股
client.himk_zzd()   # 周涨跌排名
client.himk_yzd()   # 月涨跌排名
client.himk_zqsg()   # 本周强势股
client.himk_mqsg()   # 本月强势股
client.himk_ltszph()   # 流通市值排行
client.himk_syl()   # 市盈率排行
client.himk_sjl()   # 市净率排行
client.himk_roe()   # ROE排行
```

### 基金数据（29）

```python
client.jj_all()   # 所有基金列表
client.jj_gzlb()   # 估值基金列表
client.jj_pzzzgz(fund_code)   # 盘中最新估值
client.jj_fbs()   # 封闭式基金列表
client.jj_etf()   # ETF基金列表
client.jj_lof()   # LOF基金列表
client.jj_zxkx(fund_code, interval=None)   # 最新K线
client.jj_lskx(fund_code, interval=None)   # 历史K线
client.jj_zxma(fund_code, interval=None)   # 最新MA
client.jj_lsma(fund_code, interval=None)   # 历史MA
client.jj_jjgk(fund_code)   # 基金概况
client.jj_lsjz(fund_code)   # 历史净值
client.jj_gpcc(fund_code)   # 股票持仓
client.jj_zqcc(fund_code)   # 债券持仓
client.js_pm_kfjzg_kfsjj_gpxjj_zsx()   # 开放式基金净值排名
client.js_pm_kfjzq_kfsjj_hbxjj_hba()   # 开放式基金净值排名
client.js_pm_fbjz_kfsjj_fbqy_ctfj()   # 封闭式基金净值排名
client.js_pm_kfpm_kfsjj_gpxjj_zsx()   # 开放式基金业绩排行
client.js_pm_fbpm_kfsjj_fbqy_ctfj()   # 封闭式基金业绩排行
client.js_pm_fzyj_kfsjj_fjgs_wjzqx()   # 分级子基金业绩排行
client.js_jf_kffh_kfsjj_gpxjj_zsx()   # 开放式基金基金分红
client.js_jf_fbfh_kfsjj_fbqy_ctfj()   # 封闭式基金基金分红
client.js_jf_fzfh_kfsjj_fjgs_wjzqx()   # 分级子基金基金分红
client.js_gm_kfgm_kfsjj_gpxjj_zsx()   # 开放式基金基金规模
client.js_gm_fbgm_kfsjj_fbqy_ctfj()   # 封闭式基金基金规模
client.js_gm_fzgm_kfsjj_fjgs_wjzqx()   # 分级子基金基金规模
client.js_other_jjzc(report_period)   # 基金重仓股
client.js_other_zcbd(report_period)   # 基金重仓股变动
client.js_other_dxjg_yh()   # 代销机构
```

### 可转债（3）

```python
client.kzz_list()   # 可转债一览
client.kzz_comparison()   # 可转债比价表
client.kzz_spot()   # 可转债实时行情
```

### 因子（16）

```python
client.factor_categories()   # 因子分类树
client.factor_valuation(ts_code)   # 估值因子
client.factor_quality(ts_code)   # 质量因子
client.factor_growth(ts_code)   # 成长因子
client.factor_momentum(ts_code)   # 动量因子
client.factor_capital(ts_code)   # 资金面因子
client.factor_signal(ts_code)   # 技术信号因子
client.factor_risk(ts_code)   # 风险因子
client.factor_dividend(ts_code)   # 分红因子
client.factor_scale(ts_code)   # 规模流动性因子
client.factor_sentiment(ts_code)   # 情绪事件因子
client.factor_all(ts_code)   # 单股全因子
client.factor_rank(factor_id)   # 因子排名
client.factor_top(factor_id, n)   # 因子 Top N
client.factor_history(factor_id, ts_code)   # 因子历史序列
client.factor_percentile(factor_id, ts_code)   # 因子分位数
```

### 公告与互动（2）

```python
client.hsstock_interactiveqa(stock_code, st=None, et=None, lt=None)   # 问董秘数据
client.hsstock_announcement(stock_code, st=None, et=None, lt=None)   # 交易所公告数据
```

### 交易提示（7）

```python
client.hitc_jrts()   # 今日交易提示
client.hitc_rzrqzl()   # 融资融券交易总量
client.hitc_rzrqmx()   # 融资融券交易明细
client.hitc_dzjy()   # 大宗交易
client.hitc_jjxs()   # 解禁限售
client.hitc_dxsy()   # 打新收益
client.hitc_lsfh()   # 历史累计分红
```

> 参数具体值请参考平台文档 [liangmai.pro/docs](https://liangmai.pro/docs)

---

## SDK 工程设计
```python
from liangmai import Client, API_COUNT, call
# API_COUNT = 255 导入即知接口总数
client = Client(token="your_token", timeout=30)
```
| 特性 | 说明 |
|------|------|
| 自动重试 | 5xx / code=500 自动重试，与平台文档页一致 |
| 参数别名 | `ts_code`/`code`/`symbol` 均可，`trade_date`/`date` 混用 |
| 市场后缀自动补全 | 6位代码自动推断 `.SZ`/`.SH`/`.BJ` |
| 环境变量驱动 | `LIANGMAI_TOKEN` + `LIANGMAI_BASE_URL` |
| 零臃肿 | 仅依赖 `requests`，不引入 pandas/numpy |
| 全版本 | Python 3.8 ~ 3.14 全面支持 |
| AI 友好 | 完整 docstring + `openai_tools()` function-calling 定义，AI Agent 开箱即用 |
### AI Agent 调用示例（function-calling）
```python
from liangmai import Client
client = Client(token="your_token")
# 一键拿到全部 255 个接口的 OpenAI function-calling 工具定义
tools = client.openai_tools()
# 把 tools 传给大模型（OpenAI / DeepSeek / Qwen / Dify / Coze 等），
# 模型返回的 function_call 形如：
call = {"name": "stock_realtime", "arguments": {"ts_code": "600519"}}
result = client.call(call["name"], **call["arguments"])
# 每个方法都有完整 docstring（参数说明 + 示例），AI 读源码也能直接理解
help(client.stock_realtime)
# 机器可读接口清单（供 RAG / 工具发现）
from liangmai import INTERFACES
```
---
## 获取 Token
访问 [liangmai.pro](https://liangmai.pro) 注册并获取 API Token。
## 相关链接
| 链接 | 地址 |
|------|------|
| 量脉平台 | [https://liangmai.pro](https://liangmai.pro) |
| PyPI | [https://pypi.org/project/liangmai/](https://pypi.org/project/liangmai/) |
| GitHub | [https://github.com/liangmai-sdk/liangmai](https://github.com/liangmai-sdk/liangmai) |
| 问题反馈 | [https://github.com/liangmai-sdk/liangmai/issues](https://github.com/liangmai-sdk/liangmai/issues) |
## 许可证
MIT License © 2026 liangmai