Browse Source

📝 docs(stock-api): 添加新股票API接口文档

- 新增最新分时交易API接口说明及示例
- 新增历史分时交易API接口说明及示例
- 新增历史涨跌停价格API接口说明及示例
- 新增行情指标API接口说明及示例
- 详细描述各接口的URL格式、参数说明、返回字段及示例数据
yourname 7 months ago
parent
commit
508cb4fb3e
1 changed files with 86 additions and 0 deletions
  1. 86 0
      .roo/commands/stock-api.md

+ 86 - 0
.roo/commands/stock-api.md

@@ -0,0 +1,86 @@
+---
+description: "修改为新股票api接口"
+---
+
+最新分时交易
+API接口:https://api.mairuiapi.com/hsstock/latest/股票代码.市场(如000001.SZ)/分时级别(如d)/除权方式/您的licence?lt=最新条数(如5)
+演示URL:https://api.mairuiapi.com/hsstock/latest/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073?lt=1
+接口说明:根据《股票列表》得到的股票代码和分时级别获取最新交易数据,交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线,对应的请求参数分别为5、15、30、60、d、w、m、y,日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权,对应的参数分别为n、f、b、fr、br,分钟级无除权数据,对应的参数为n。同时可以指定获取数据条数,例如指定lt=10,则获取最新的10条数据。
+数据更新:实时
+请求频率:1分钟300次 | 包年版1分钟3千次 | 钻石版1分钟6千次
+返回格式:标准Json格式      [{},...{}]
+字段名称	数据类型	字段说明
+t	string	交易时间
+o	float	开盘价
+h	float	最高价
+l	float	最低价
+c	float	收盘价
+v	float	成交量
+a	float	成交额
+pc	float	前收盘价
+sf	int	停牌 1停牌,0 不停牌
+
+演示URL:返回结果实例
+```json
+[{"t":"2025-08-20 00:00:00","o":12.06,"h":12.12,"l":11.98,"c":12.07,"v":1048739.0,"a":1265435773.22,"pc":12.06,"sf":0.0}]
+```
+
+历史分时交易
+API接口:https://api.mairuiapi.com/hsstock/history/股票代码.市场(如000001.SZ)/分时级别(如d)/除权方式/您的licence?st=开始时间(如20240601)&et=结束时间(如20250430)&lt=最新条数(如100)
+演示URL:https://api.mairuiapi.com/hsstock/history/000001.SZ/d/n/LICENCE-66D8-9F96-0C7F0FBCD073?st=20250101&et=20250430&lt=100
+接口说明:根据《股票列表》得到的股票代码和分时级别获取历史交易数据,交易时间升序。目前分时级别支持5分钟、15分钟、30分钟、60分钟、日线、周线、月线、年线,对应的请求参数分别为5、15、30、60、d、w、m、y,日线以上除权方式有不复权、前复权、后复权、等比前复权、等比后复权,对应的参数分别为n、f、b、fr、br,分钟级无除权数据,对应的参数为n。开始时间以及结束时间的格式均为 YYYYMMDD 或 YYYYMMDDhhmmss,例如:'20240101' 或'20241231235959'。不设置开始时间和结束时间则为全部历史数据。同时可以指定获取数据条数,例如指定lt=10,则获取最新的10条数据。
+数据更新:分钟级别数据盘中更新,分时越小越优先更新,如5分钟级别会每5分钟更新,15分钟级别会每15分钟更新,以此类推,日线及以上级别每日15:30开始更新,预计17:10完成
+请求频率:1分钟300次 | 包年版1分钟3千次 | 钻石版1分钟6千次
+返回格式:标准Json格式      [{},...{}]
+字段名称	数据类型	字段说明
+t	string	交易时间
+o	float	开盘价
+h	float	最高价
+l	float	最低价
+c	float	收盘价
+v	float	成交量
+a	float	成交额
+pc	float	前收盘价
+sf	int	停牌 1停牌,0 不停牌
+
+演示URL:返回结果实例
+```json
+[{"t":"2025-01-02 00:00:00","o":11.73,"h":11.77,"l":11.39,"c":11.43,"v":1819597.0,"a":2102923078.0,"pc":11.7,"sf":0.0},{"t":"2025-01-03 00:00:00","o":11.44,"h":11.54,"l":11.36,"c":11.38,"v":1154680.0,"a":1320520977.0,"pc":11.43,"sf":0.0},{"t":"2025-01-06 00:00:00","o":11.38,"h":11.48,"l":11.22,"c":11.44,"v":1085536.0,"a":1234305778.0,"pc":11.38,"sf":0.0},{"t":"2025-01-07 00:00:00","o":11.42,"h":11.53,"l":11.37,"c":11.51,"v":747863.0,"a":858329048.0,"pc":11.44,"sf":0.0}]
+```
+
+
+历史涨跌停价格
+API接口:http://api.mairuiapi.com/hsstock/stopprice/history/股票代码(如000001.SZ)/您的licence?st=开始时间&et=结束时间
+演示URL:http://api.mairuiapi.com/hsstock/stopprice/history/000001.SZ/LICENCE-66D8-9F96-0C7F0FBCD073?st=20240501&et=20240601
+接口说明:根据《股票列表》得到的股票代码获取历史涨跌停价格,开始时间以及结束时间的格式均为 YYYYMMDD,例如:'20240101'。不设置开始时间和结束时间则为全部历史数据。
+数据更新:每日0点
+请求频率:1分钟300次 | 包年版1分钟3千次 | 钻石版1分钟6千次
+返回格式:标准Json格式      [{},...{}]
+字段名称	数据类型	字段说明
+t	string	交易日期
+h	float	涨停价格
+l	float	跌停价格
+行情指标
+API接口:http://api.mairuiapi.com/hsstock/indicators/股票代码(如000001.SZ)/您的licence?st=开始时间&et=结束时间
+演示URL:http://api.mairuiapi.com/hsstock/indicators/600519.SH/LICENCE-66D8-9F96-0C7F0FBCD073
+接口说明:根据《股票列表》得到的股票代码获取各项行情指标,开始时间以及结束时间的格式均为 YYYYMMDD,例如:'20240101'。不设置开始时间和结束时间则为全部数据。
+数据更新:实时
+请求频率:1分钟300次 | 包年版1分钟3千次 | 钻石版1分钟6千次
+返回格式:标准Json格式      [{},...{}]
+字段名称	数据类型	字段说明
+time	string	更新时间
+lb	float	量比
+om	float	1分钟涨速(%)
+fm	float	5分钟涨速(%)
+3d	float	3日涨幅(%)
+5d	float	5日涨幅(%)
+10d	float	10日涨幅(%)
+3t	float	3日换手(%)
+5t	float	5日换手(%)
+10t	float	10日换手(%)
+
+
+演示URL:返回结果实例
+```json
+[{"t":"2025-08-19","h":13.29,"l":10.87},{"t":"2025-08-18","h":13.29,"l":10.87},{"t":"2025-08-15","h":13.42,"l":10.98},{"t":"2025-08-14","h":13.49,"l":11.03},{"t":"2025-08-13","h":13.56,"l":11.1},{"t":"2025-08-12","h":13.53,"l":11.07},{"t":"2025-08-11","h":13.64,"l":11.16},{"t":"2025-08-08","h":13.72,"l":11.22},{"t":"2025-08-07","h":13.71,"l":11.21}]
+```