资金流向数据能力升级：支持按日期区间一次查询多日记录

尊敬的用户，您好：

为便于回测、复盘与批量拉取，麦蕊智数已升级资金流向数据接口： 在保留「最近 1 个交易日」快速查询的同时，支持通过 st、et 参数 按日期区间一次返回多日日频资金流向记录。

一、本次升级要点

• 区间查询：同时传入 st（起始日）与 et（结束日），返回区间内多日记录（按日合并；区间内无数据的日期自动跳过）
• 单次上限：起止跨度最多 365 个自然日；超出将返回参数错误（HTTP 422）
• 成对校验：st 与 et 须同时提供；仅传一侧同样返回 422
• 兼容原行为：不传 st/et 时，接口行为不变——仍返回最近 1 个交易日数据（非交易日为最后 1 个交易日）
• 单日精确查询：路径中带交易日期的「历史资金流向数据」接口保持不变，适合按某一天定点取数

二、资金流向数据（含可选区间）

项	内容
接口名称	资金流向数据
请求方式	GET
调用地址	https://api.mairuiapi.com/hsstock/history/transaction/{股票代码}/{您的licence}
可选参数	st、et：区间起止，格式 yyyyMMdd 或 yyyy-MM-dd，须同时使用，跨度 ≤365 自然日
无 st/et	JSON 数组，仅含最近 1 个交易日；交易时段约每 15 分钟更新，逐日覆盖
有 st+et	JSON 数组，含区间内多日记录，字段与单日一致；按交易日升序
文档位置	API 文档 → 沪深 A 股数据 → 实时交易 → 资金流向数据

调用示例：

# 最近 1 个交易日（与升级前相同）
https://api.mairuiapi.com/hsstock/history/transaction/000001/您的licence

# 指定区间（示例：2026-08-01 至 2026-08-26）
https://api.mairuiapi.com/hsstock/history/transaction/000001/您的licence?st=20260801&et=20260826

三、历史资金流向数据（单日，不变）

项	内容
接口名称	历史资金流向数据
调用地址	https://api.mairuiapi.com/hsstock/history/transaction/{交易日期yyyyMMdd}/{股票代码}/{您的licence}
返回说明	仅返回指定交易日的日频数据；无该日则提示数据不存在
文档位置	API 文档 → 沪深 A 股数据 → 实时交易 → 历史资金流向数据

调用示例：

https://api.mairuiapi.com/hsstock/history/transaction/20260825/000001/您的licence

四、选用建议

• 盘中盯盘、只要最新一日：不传 st/et，调用「资金流向数据」
• 回测 / 复盘 / 批量拉一段日期：同一接口加 st+et（注意单次 ≤365 自然日；更长区间请自行分段请求）
• 只要某一天、且希望路径语义明确：调用「历史资金流向数据」并带上 yyyyMMdd

字段说明与「资金流向数据」一致，详见 API 文档字段表。如有疑问，请联系客服或您的商务对接人。感谢您的支持！

麦蕊智数团队
2026年8月29日