接口文档

覆盖 A 股全市场的数据接口。

请求地址

所有接口共用的基础调用地址。

https://stock.bihu888.cn/stock/data/

鉴权方式

请求头携带 X-API-Key（sk- 前缀）即可调用。

调用限制

每页数据最多 1000 条，每分钟最多请求 60 次。

列式数据

数据在 data.column + data.item，按列顺序映射为对象。

客户端与 MCP

Python SDK 一行安装（MIT，Python ≥3.10，分页抓取 / 列式自动解码 / 429 自动重试）；MCP 服务供 Claude、Cursor 等 AI 客户端直接调用，鉴权同为 X-API-Key。

SDK 安装（PyPI）

pip install bihu-stock-data-client

SDK 安装（清华镜像）

pip install bihu-stock-data-client -i https://pypi.tuna.tsinghua.edu.cn/simple

MCP 端点（Streamable HTTP）

https://stock.bihu888.cn/stock/data/mcp # 请求头 X-API-Key: <你的 Key>

GET/market/quote/{stockCode}

实时五档行情

实时行情

实时五档行情

返回最新价、开高低、成交量额及五档买卖盘（列式数据）。stockCode 支持 600900 或 600900.SH

请求参数

参数	位置	类型	必填	说明
stockCode	path	string	必填	—

返回字段30 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
trade_time	字符串	交易时间(HHMMSS)
last_price	数值	最新价(元)
open	数值	开盘价(元)
high	数值	最高价(元)
low	数值	最低价(元)
last_close	数值	昨收价(元)
amount	数值	当日累计成交总额(元)
volume	数值	当日累计成交量(手)
ask_price1	数值	卖一价(元)
ask_price2	数值	卖二价(元)
ask_price3	数值	卖三价(元)
ask_price4	数值	卖四价(元)
ask_price5	数值	卖五价(元)
bid_price1	数值	买一价(元)
bid_price2	数值	买二价(元)
bid_price3	数值	买三价(元)
bid_price4	数值	买四价(元)
bid_price5	数值	买五价(元)
ask_vol1	数值	卖一量(手)
ask_vol2	数值	卖二量(手)
ask_vol3	数值	卖三量(手)
ask_vol4	数值	卖四量(手)
ask_vol5	数值	卖五量(手)
bid_vol1	数值	买一量(手)
bid_vol2	数值	买二量(手)
bid_vol3	数值	买三量(手)
bid_vol4	数值	买四量(手)
bid_vol5	数值	买五量(手)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "trade_time", "last_price", "open", "high", "low", "last_close", "amount", "volume", "ask_price1", "ask_price2", "ask_price3", "ask_price4", "ask_price5", "bid_price1", "bid_price2", "bid_price3", "bid_price4", "bid_price5", "ask_vol1", "ask_vol2", "ask_vol3", "ask_vol4", "ask_vol5", "bid_vol1", "bid_vol2", "bid_vol3", "bid_vol4", "bid_vol5"],
    "item": [
    "000001.SH", "2026-06-20", "093000", 12.34, 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
    "000001.SH", "2026-06-19", "093000", 12.34, 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 12.34, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
    ]
  }
}

POST/kline-daily/list

日 K 线

日K线行情

分页查询日K线行情

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段15 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
open	数值	开盘价
high	数值	最高价
low	数值	最低价
close	数值	收盘价
volume	数值	成交量
amount	数值	成交额
adj_factor	数值	复权因子
open_qfq	数值	前复权开盘价
high_qfq	数值	前复权最高价
low_qfq	数值	前复权最低价
close_qfq	数值	前复权收盘价
avg_price	数值	均价
avg_price_qfq	数值	前复权均价

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "open", "high", "low", "close", "volume", "amount", "adj_factor", "open_qfq", "high_qfq", "low_qfq", "close_qfq", "avg_price", "avg_price_qfq"],
    "item": [
    "000001.SH", "2026-06-20", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 0, 2.35, 12.34, 12.34, 12.34, 12.34, 12.34,
    "000001.SH", "2026-06-19", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 0, 2.35, 12.34, 12.34, 12.34, 12.34, 12.34
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/kline-daily-stat/list

日 K 统计

每日统计指标

分页查询每日统计指标

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段11 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
close	数值	当日收盘价
turnover_rate	数值	换手率(%)
volume_ratio	数值	量比
pe	数值	市盈率
pe_ttm	数值	市盈率TTM
pb	数值	市净率
ps	数值	市销率
ps_ttm	数值	市销率TTM
dividend_yield	数值	股息率(%)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "close", "turnover_rate", "volume_ratio", "pe", "pe_ttm", "pb", "ps", "ps_ttm", "dividend_yield"],
    "item": [
    "000001.SH", "2026-06-20", 12.34, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35,
    "000001.SH", "2026-06-19", 12.34, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

GET/kline-minute/{stockCode}/{tradeDate}

分钟 K 线

1分钟K线

按股票代码和日期查询全部分钟K线

请求参数

参数	位置	类型	必填	说明
stockCode	path	string	必填	股票代码
tradeDate	path	string	必填	交易日期

返回字段10 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
trade_time	字符串	交易时间(HHMMSS)
open	数值	开盘价
high	数值	最高价
low	数值	最低价
close	数值	收盘价
volume	数值	成交量
amount	数值	成交额
avg_price	数值	成交均价

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "trade_time", "open", "high", "low", "close", "volume", "amount", "avg_price"],
    "item": [
    "000001.SH", "2026-06-20", "093000", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 12.34,
    "000001.SH", "2026-06-19", "093000", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89, 12.34
    ]
  }
}

GET/market/kline-minute/{stockCode}

当日分钟K线

实时行情

当日分钟K线

返回当日1分钟OHLC K线（列式数据）。stockCode 支持 600900 或 600900.SH

请求参数

参数	位置	类型	必填	说明
stockCode	path	string	必填	—

返回字段9 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
trade_time	字符串	交易时间(HHMMSS)
open	数值	开盘价(元)
high	数值	最高价(元)
low	数值	最低价(元)
close	数值	收盘价(元)
volume	数值	成交量(手)
amount	数值	成交额(元)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "trade_time", "open", "high", "low", "close", "volume", "amount"],
    "item": [
    "000001.SH", "2026-06-20", "093000", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89,
    "000001.SH", "2026-06-19", "093000", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89
    ]
  }
}

GET/market/transaction/{stockCode}

当日分笔成交

实时行情

当日分笔成交

返回当日逐笔成交数据，自动分页（列式数据）。stockCode 支持 600900 或 600900.SH

请求参数

参数	位置	类型	必填	说明
stockCode	path	string	必填	—
maxCount	query	int32	否	—

返回字段7 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
trade_time	字符串	交易时间(HHMMSS)
price	数值	成交价(元)
volume	数值	成交量(手)
num	整数	成交笔数
direction	整数	买卖方向(0=买 1=卖 2=中性)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "trade_time", "price", "volume", "num", "direction"],
    "item": [
    "000001.SH", "2026-06-20", "093000", 12.34, 1234567.89, 100, 0,
    "000001.SH", "2026-06-19", "093000", 12.34, 1234567.89, 100, 0
    ]
  }
}

POST/capital-flow/list

资金流向

分页查询资金流向

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段12 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
main_net_inflow	数值	主力净流入(元)
main_net_inflow_pct	数值	主力净流入占比(%)
huge_net_inflow	数值	超大单净流入(元)
huge_net_inflow_pct	数值	超大单净流入占比(%)
large_net_inflow	数值	大单净流入(元)
large_net_inflow_pct	数值	大单净流入占比(%)
medium_net_inflow	数值	中单净流入(元)
medium_net_inflow_pct	数值	中单净流入占比(%)
small_net_inflow	数值	小单净流入(元)
small_net_inflow_pct	数值	小单净流入占比(%)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "main_net_inflow", "main_net_inflow_pct", "huge_net_inflow", "huge_net_inflow_pct", "large_net_inflow", "large_net_inflow_pct", "medium_net_inflow", "medium_net_inflow_pct", "small_net_inflow", "small_net_inflow_pct"],
    "item": [
    "000001.SH", "2026-06-20", 12.34, 2.35, 12.34, 2.35, 12.34, 2.35, 12.34, 2.35, 12.34, 2.35,
    "000001.SH", "2026-06-19", 12.34, 2.35, 12.34, 2.35, 12.34, 2.35, 12.34, 2.35, 12.34, 2.35
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/chip-distribution/list

筹码分布

分页查询筹码分布

查询单只股票最新的价格-成交量分布快照（每股每价格档一行，0.01 元粒度，历史量按换手率衰减演化），按价格升序返回，可选价格区间过滤，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	必填	股票代码，如 600519.SH
minPrice	body	number	否	价格下限(元)，可空
maxPrice	body	number	否	价格上限(元)，可空

返回字段4 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
price	数值	价格档(元，0.01 粒度)
volume	数值	累计成交量(股，历史按换手率衰减)
last_date	日期	数据截止的归档交易日

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "price", "volume", "last_date"],
    "item": [
    "000001.SH", 12.34, 1234567.89, "2026-06-20",
    "000001.SH", 12.34, 1234567.89, "2026-06-19"
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

GET/index-basic/list

指数基础信息

查询所有指数

返回列式格式的所有指数基础信息，不分页

请求参数

无参数

返回字段2 个字段，顺序与 data.column 一致

字段	类型	说明
index_code	字符串	指数代码
index_name	字符串	指数名称

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["index_code", "index_name"],
    "item": [
    "000300.SH", "示例名称",
    "000300.SH", "示例名称"
    ]
  }
}

POST/index-kline-daily/list

指数日 K 线

指数日K线

分页查询指数日K线

按指数代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
indexCode	body	string	否	指数代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段8 个字段，顺序与 data.column 一致

字段	类型	说明
index_code	字符串	指数代码
trade_date	日期	交易日期
open	数值	开盘价
high	数值	最高价
low	数值	最低价
close	数值	收盘价
volume	数值	成交量(手)
amount	数值	成交额(元)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["index_code", "trade_date", "open", "high", "low", "close", "volume", "amount"],
    "item": [
    "000300.SH", "2026-06-20", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89,
    "000300.SH", "2026-06-19", 2.35, 12.34, 12.34, 12.34, 1234567.89, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/index-constituent/list

指数成分股

分页查询指数成分股

按指数代码或股票代码分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
indexCode	body	string	否	指数代码
stockCode	body	string	否	股票代码

返回字段2 个字段，顺序与 data.column 一致

字段	类型	说明
index_code	字符串	指数代码
stock_code	字符串	股票代码

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["index_code", "stock_code"],
    "item": [
    "000300.SH", "000001.SH",
    "000300.SH", "000001.SH"
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

GET/stock-basic/list

股票基础信息

股票基本信息

查询所有股票

返回列式格式的所有股票基本信息，不分页

请求参数

无参数

返回字段6 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
stock_name	字符串	股票名称
market	字符串	市场类型
list_date	日期	上市日期
is_st	布尔	是否ST股
is_delisted	布尔	是否已退市

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "stock_name", "market", "list_date", "is_st", "is_delisted"],
    "item": [
    "000001.SH", "示例名称", "SH", "2026-06-20", 0, 0,
    "000001.SH", "示例名称", "SH", "2026-06-19", 0, 0
    ]
  }
}

GET/sw-industry/list

申万行业分类

查询所有申万行业

返回列式格式的所有申万行业分类信息，不分页

请求参数

无参数

返回字段5 个字段，顺序与 data.column 一致

字段	类型	说明
industry_code	字符串	行业代码(6位)
industry_name	字符串	行业名称
level	整数	行业层级(1/2/3)
parent_code	字符串	上级行业代码
version	字符串	分类版本

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["industry_code", "industry_name", "level", "parent_code", "version"],
    "item": [
    "801010", "示例名称", 1, "801010", "1",
    "801010", "示例名称", 1, "801010", "1"
    ]
  }
}

POST/sw-stock-classify/list

个股行业归属

申万行业个股归属

分页查询个股申万行业归属

按股票代码分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码

返回字段7 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
l1_code	字符串	一级行业代码
l1_name	字符串	一级行业名称
l2_code	字符串	二级行业代码
l2_name	字符串	二级行业名称
l3_code	字符串	三级行业代码
l3_name	字符串	三级行业名称

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "l1_code", "l1_name", "l2_code", "l2_name", "l3_code", "l3_name"],
    "item": [
    "000001.SH", "801010", "示例名称", "801010", "示例名称", "801010", "示例名称",
    "000001.SH", "801010", "示例名称", "801010", "示例名称", "801010", "示例名称"
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/sw-industry-daily-stat/list

行业日度统计

申万行业日度统计

分页查询申万行业日度统计

按行业代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
industryCode	body	string	否	行业代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段15 个字段，顺序与 data.column 一致

字段	类型	说明
industry_code	字符串	行业代码
trade_date	日期	交易日期
stock_count	整数	股票数量
advance_count	整数	上涨家数
decline_count	整数	下跌家数
flat_count	整数	平盘家数
pct_change	数值	行业涨跌幅(%)(市值加权)
total_market_cap	数值	总市值(元)
total_volume	数值	总成交量(手)
total_amount	数值	总成交额(元)
avg_turnover_rate	数值	平均换手率(%)
pe	数值	整体法PE(静态)
pe_ttm	数值	整体法PE(TTM)
pb	数值	整体法PB
ps_ttm	数值	整体法PS(TTM)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["industry_code", "trade_date", "stock_count", "advance_count", "decline_count", "flat_count", "pct_change", "total_market_cap", "total_volume", "total_amount", "avg_turnover_rate", "pe", "pe_ttm", "pb", "ps_ttm"],
    "item": [
    "801010", "2026-06-20", 100, 100, 100, 100, 2.35, 1234567.89, 1234567.89, 1234567.89, 2.35, 2.35, 2.35, 2.35, 2.35,
    "801010", "2026-06-19", 100, 100, 100, 100, 2.35, 1234567.89, 1234567.89, 1234567.89, 2.35, 2.35, 2.35, 2.35, 2.35
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/sw-industry-capital-flow/list

行业资金流

申万行业资金流

分页查询申万行业资金流

按行业代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
industryCode	body	string	否	行业代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段14 个字段，顺序与 data.column 一致

字段	类型	说明
industry_code	字符串	行业代码(一/二/三级)
trade_date	日期	交易日期
stock_count	整数	有资金流数据的成分股数
main_net_inflow	数值	主力净流入合计(元)
huge_net_inflow	数值	超大单净流入合计(元)
large_net_inflow	数值	大单净流入合计(元)
medium_net_inflow	数值	中单净流入合计(元)
small_net_inflow	数值	小单净流入合计(元)
main_net_inflow_pct	数值	主力净流入占比(%)(成交额加权)
huge_net_inflow_pct	数值	超大单净流入占比(%)(成交额加权)
large_net_inflow_pct	数值	大单净流入占比(%)(成交额加权)
medium_net_inflow_pct	数值	中单净流入占比(%)(成交额加权)
small_net_inflow_pct	数值	小单净流入占比(%)(成交额加权)
total_amount	数值	行业总成交额(元)(加权占比分母)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["industry_code", "trade_date", "stock_count", "main_net_inflow", "huge_net_inflow", "large_net_inflow", "medium_net_inflow", "small_net_inflow", "main_net_inflow_pct", "huge_net_inflow_pct", "large_net_inflow_pct", "medium_net_inflow_pct", "small_net_inflow_pct", "total_amount"],
    "item": [
    "801010", "2026-06-20", 100, 12.34, 12.34, 12.34, 12.34, 12.34, 2.35, 2.35, 2.35, 2.35, 2.35, 1234567.89,
    "801010", "2026-06-19", 100, 12.34, 12.34, 12.34, 12.34, 12.34, 2.35, 2.35, 2.35, 2.35, 2.35, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/block-trade/list

大宗交易

分页查询大宗交易

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段4 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
avg_price	数值	成交均价
amount	数值	成交金额

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "avg_price", "amount"],
    "item": [
    "000001.SH", "2026-06-20", 12.34, 1234567.89,
    "000001.SH", "2026-06-19", 12.34, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/margin-trading/list

融资融券

分页查询融资融券数据

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段10 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
margin_balance	数值	融资余额
short_volume	数值	融券余量
margin_buy_amount	数值	融资买入额
margin_repay_amount	数值	融资偿还额
short_sell_volume	数值	融券卖出量
short_repay_volume	数值	融券偿还量
margin_net_buy	数值	融资净买入
short_net_sell	数值	融券净卖出

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "margin_balance", "short_volume", "margin_buy_amount", "margin_repay_amount", "short_sell_volume", "short_repay_volume", "margin_net_buy", "short_net_sell"],
    "item": [
    "000001.SH", "2026-06-20", 2.35, 1234567.89, 2.35, 2.35, 1234567.89, 1234567.89, 2.35, 1234567.89,
    "000001.SH", "2026-06-19", 2.35, 1234567.89, 2.35, 2.35, 1234567.89, 1234567.89, 2.35, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/dragon-tiger/list

龙虎榜

分页查询龙虎榜数据

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段15 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
total_buy	数值	总买入额
total_sell	数值	总卖出额
inst_sell_count	整数	机构卖出席位数
inst_sell_amount	数值	机构卖出金额
inst_buy_count	整数	机构买入席位数
inst_buy_amount	数值	机构买入金额
dept_buy_amount	数值	营业部买入金额
dept_sell_amount	数值	营业部卖出金额
hsgt_buy_amount	数值	沪港通买入金额
hsgt_sell_amount	数值	沪港通卖出金额
listed_days	整数	上市天数
inst_net	数值	机构净买入
total_net	数值	总净买入

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "total_buy", "total_sell", "inst_sell_count", "inst_sell_amount", "inst_buy_count", "inst_buy_amount", "dept_buy_amount", "dept_sell_amount", "hsgt_buy_amount", "hsgt_sell_amount", "listed_days", "inst_net", "total_net"],
    "item": [
    "000001.SH", "2026-06-20", 1234567.89, 1234567.89, 100, 1234567.89, 100, 1234567.89, 1234567.89, 1234567.89, 1234567.89, 1234567.89, 1, 1234567.89, 1234567.89,
    "000001.SH", "2026-06-19", 1234567.89, 1234567.89, 100, 1234567.89, 100, 1234567.89, 1234567.89, 1234567.89, 1234567.89, 1234567.89, 1, 1234567.89, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/pre-post-market/list

盘前盘后

盘前盘后成交

分页查询盘前盘后成交

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段4 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
pre_market_volume	数值	盘前成交量
post_market_volume	数值	盘后成交量

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "pre_market_volume", "post_market_volume"],
    "item": [
    "000001.SH", "2026-06-20", 1234567.89, 1234567.89,
    "000001.SH", "2026-06-19", 1234567.89, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/share-capital/list

股本数据

分页查询股本数据

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段6 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	日期
total_shares	数值	总股本(股)
circulating_shares	数值	流通股本(股)
market_cap	数值	总市值(元)
circulating_market_cap	数值	流通市值(元)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "total_shares", "circulating_shares", "market_cap", "circulating_market_cap"],
    "item": [
    "000001.SH", "2026-06-20", 1234567.89, 1234567.89, 1234567.89, 1234567.89,
    "000001.SH", "2026-06-19", 1234567.89, 1234567.89, 1234567.89, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/share-trade/list

增减持

增减持数据

分页查询增减持数据

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段3 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
volume	数值	变动股数(股)，正数=增持，负数=减持

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "volume"],
    "item": [
    "000001.SH", "2026-06-20", 1234567.89,
    "000001.SH", "2026-06-19", 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/shareholder-stats/list

股东统计

分页查询股东统计

根据股票代码、报告年份、季度类型分页查询股东统计数据，每页最多1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
reportYear	body	int32	否	报告年份
quarterType	body	int32	否	季度类型(1=一季报 2=年中报 3=三季报 4=年报)

返回字段9 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
report_year	整数	报告年份
quarter_type	整数	季度类型(1=一季报 2=年中报 3=三季报 4=年报)
report_date	日期	报告期
announce_date	日期	公告日期
holder_count	数值	股东户数
top1_holder_shares	数值	第一大股东持股数
top10_float_holder_shares	数值	前十大流通股东持股数
top10_holder_shares	数值	前十大股东持股数

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "report_year", "quarter_type", "report_date", "announce_date", "holder_count", "top1_holder_shares", "top10_float_holder_shares", "top10_holder_shares"],
    "item": [
    "000001.SH", 2025, 1, "2026-06-20", "2026-06-20", 0, 1234567.89, 1234567.89, 1234567.89,
    "000001.SH", 2025, 1, "2026-06-19", "2026-06-19", 0, 1234567.89, 1234567.89, 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/institutional-holding/list

机构持股

分页查询机构持股

根据股票代码、年份、季度类型分页查询机构持股数据，每页最多1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
reportYear	body	int32	否	报告年份
quarterType	body	int32	否	季度类型(1=一季报 2=年中报 3=三季报 4=年报)

返回字段31 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
report_year	整数	报告年份
quarter_type	整数	季度类型(1=一季报 2=年中报 3=三季报 4=年报)
report_date	日期	报告期
announce_date	日期	公告日期
inst_total_count	数值	机构总数
inst_total_shares	数值	机构持股总数
qfii_count	数值	QFII家数
qfii_shares	数值	QFII持股数
broker_count	数值	券商家数
broker_shares	数值	券商持股数
insurance_count	数值	保险家数
insurance_shares	数值	保险持股数
fund_count	数值	基金家数
fund_shares	数值	基金持股数
social_security_count	数值	社保家数
social_security_shares	数值	社保持股数
private_fund_count	数值	私募家数
private_fund_shares	数值	私募持股数
finance_co_count	数值	财务公司家数
finance_co_shares	数值	财务公司持股数
annuity_count	数值	年金家数
annuity_shares	数值	年金持股数
bank_count	数值	银行家数
bank_shares	数值	银行持股数
legal_person_count	数值	一般法人家数
legal_person_shares	数值	一般法人持股数
trust_count	数值	信托家数
trust_shares	数值	信托持股数
special_entity_count	数值	特殊机构家数
special_entity_shares	数值	特殊机构持股数

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "report_year", "quarter_type", "report_date", "announce_date", "inst_total_count", "inst_total_shares", "qfii_count", "qfii_shares", "broker_count", "broker_shares", "insurance_count", "insurance_shares", "fund_count", "fund_shares", "social_security_count", "social_security_shares", "private_fund_count", "private_fund_shares", "finance_co_count", "finance_co_shares", "annuity_count", "annuity_shares", "bank_count", "bank_shares", "legal_person_count", "legal_person_shares", "trust_count", "trust_shares", "special_entity_count", "special_entity_shares"],
    "item": [
    "000001.SH", 2025, 1, "2026-06-20", "2026-06-20", 1234567.89, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 2.35, 2.35, 0, 1234567.89, 2.35, 2.35,
    "000001.SH", 2025, 1, "2026-06-19", "2026-06-19", 1234567.89, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 0, 1234567.89, 2.35, 2.35, 0, 1234567.89, 2.35, 2.35
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/financial-report/list

财务报告

分页查询财务报告

根据股票代码、年份、季度类型分页查询财务报告数据，每页最多1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
reportYear	body	int32	否	报告年份
quarterType	body	int32	否	季度类型(1=一季报 2=年中报 3=三季报 4=年报)

返回字段23 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
report_year	整数	报告年份
quarter_type	整数	季度类型(1=一季报 2=年中报 3=三季报 4=年报)
report_date	日期	报告期
announce_date	日期	公告日期
bvps	数值	每股净资产
eps_basic	数值	基本每股收益
cfps	数值	每股经营现金流
udps	数值	每股未分配利润
capital_reserve_ps	数值	每股资本公积金
eps_deducted	数值	扣除非经常损益后每股收益
roe	数值	净资产收益率
total_roe	数值	摊薄总资产收益率(%)
gross_margin	数值	毛利率
net_margin	数值	净利率
inc_revenue_rate	数值	主营收入同比(%)
du_profit_rate	数值	净利润同比(%)
inc_net_profit_rate	数值	归母净利润同比(%)
inc_total_revenue_annual	数值	TTM营收滚动环比(%)
inc_net_profit_to_shareholders_annual	数值	TTM归母净利滚动环比(%)
sales_cash_flow	数值	销售现金流/营收(%)
debt_ratio	数值	资产负债率
inventory_turnover	数值	存货周转率(次)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "report_year", "quarter_type", "report_date", "announce_date", "bvps", "eps_basic", "cfps", "udps", "capital_reserve_ps", "eps_deducted", "roe", "total_roe", "gross_margin", "net_margin", "inc_revenue_rate", "du_profit_rate", "inc_net_profit_rate", "inc_total_revenue_annual", "inc_net_profit_to_shareholders_annual", "sales_cash_flow", "debt_ratio", "inventory_turnover"],
    "item": [
    "000001.SH", 2025, 1, "2026-06-20", "2026-06-20", 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 1234567.89, 1234567.89, 12.34, 2.35, 2.35,
    "000001.SH", 2025, 1, "2026-06-19", "2026-06-19", 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 2.35, 1234567.89, 1234567.89, 12.34, 2.35, 2.35
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

/balance-sheet/list

资产负债表

该接口暂未在后端发布。

/income-statement/list

利润表

该接口暂未在后端发布。

/cash-flow-statement/list

现金流量表

该接口暂未在后端发布。

POST/dividend-factor/list

分红配送

分页查询分红配送数据

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段7 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
ex_date	日期	除权除息日
div_type	字符串	分红类型
bonus	数值	每股红利(税前)(元)
allot_price	数值	配股价格(元)
share_bonus	数值	每股送转股(股)
allotment	数值	每股配股(股)

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "ex_date", "div_type", "bonus", "allot_price", "share_bonus", "allotment"],
    "item": [
    "000001.SH", "2026-06-20", "1", 0, 12.34, 0, 0,
    "000001.SH", "2026-06-19", "1", 0, 12.34, 0, 0
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/stock-limit-up-stats/list

涨跌停统计

分页查询涨跌停统计

按股票代码、日期范围分页查询，每页最多返回1000条

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
stockCode	body	string	否	股票代码
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段14 个字段，顺序与 data.column 一致

字段	类型	说明
stock_code	字符串	股票代码
trade_date	日期	交易日期
zt_amount	数值	涨停金额
zt_open_count	整数	涨停开板次数
zt_dt_status	整数	涨跌停状态
seal_amount	数值	封单金额
seal_volume_ratio	数值	封单量比
seal_flow_ratio	数值	封单流通比
first_zt_time	字符串	首次涨停时间
zt_max_seal_amount	数值	涨停最大封单金额
dt_amount	数值	跌停金额
dt_open_count	整数	跌停开板次数
first_dt_time	字符串	首次跌停时间
dt_max_seal_amount	数值	跌停最大封单金额

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["stock_code", "trade_date", "zt_amount", "zt_open_count", "zt_dt_status", "seal_amount", "seal_volume_ratio", "seal_flow_ratio", "first_zt_time", "zt_max_seal_amount", "dt_amount", "dt_open_count", "first_dt_time", "dt_max_seal_amount"],
    "item": [
    "000001.SH", "2026-06-20", 1234567.89, 100, 1, 1234567.89, 2.35, 2.35, "093000", 1234567.89, 1234567.89, 100, "093000", 1234567.89,
    "000001.SH", "2026-06-19", 1234567.89, 100, 1, 1234567.89, 2.35, 2.35, "093000", 1234567.89, 1234567.89, 100, "093000", 1234567.89
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

POST/trading-calendar/list

交易日历

分页查询交易日历

请求参数

参数	位置	类型	必填	说明
pageNum	body	int32	必填	第几页
pageSize	body	int32	必填	每页条数，最大 1000
startDate	body	string	否	开始日期(yyyy-MM-dd)
endDate	body	string	否	结束日期(yyyy-MM-dd)

返回字段1 个字段，顺序与 data.column 一致

字段	类型	说明
trade_date	日期	日期

返回示例（列式 JSON）结构示意，值为占位

{
  "code": "0000",
  "message": "成功",
  "data": {
    "column": ["trade_date"],
    "item": [
    "2026-06-20",
    "2026-06-19"
    ],
    "pageNum": 1,
    "pageSize": 10,
    "totalCount": 100,
    "totalPage": 10
  }
}

错误码对照表

统一响应中 code 为 "0000" 表示成功，其余为错误码。

code	含义
0000	成功
1001	失败
1002	未认证
1003	Token 已过期
1004	请求过于频繁（限流）
1005	验证码错误或已过期
1006	验证码发送过于频繁
1007	手机号已被绑定
1008	API Key 不存在或已失效
1009	用户已被禁用
1010	微信授权状态无效
1011	临时 Token 无效或已过期
1012	密码错误
1013	该手机号已注册
1014	该手机号未注册