期货总览
期货模块提供品种、合约、持仓、仓单、基差、交易日与行情数据查询。
功能分类
| 分类 | 路径前缀 | 说明 |
|---|---|---|
| 期货品种资料 | /api/futures/varieties | 查询期货品种目录及交易属性。 |
| 期货品种板块 | /api/futures/variety-plates | 查询期货品种所属板块。 |
| 期货合约基础资料 | /api/futures/contracts | 查询期货合约详情和分页合约目录。 |
| 期货主力与指数合约 | /api/futures/contracts | 查询主连、主力、次主力与商品指数合约列表。 |
| 期货持仓 | /api/futures/positions | 查询品种、公司和合约维度的日持仓与历史持仓。 |
| 期货仓单 | /api/futures/warehouse-receipts | 查询期货历史仓单。 |
| 期货基差 | /api/futures/basis | 查询主连最新基差与历史基差。 |
| 期货F10宏观指标历史数据 | /api/futures/fundamentals | 仅供同花顺AI客户端内访问,端外暂不开放。 |
| 期货交易日 | /api/futures/calendar | 查询交易日列表及对应交易时间安排。 |
| 期货行情 | /api/futures/prices | 端外查询当前交易日分时与日 K;AI 客户端内还可查询历史分时与多周期 K 线。 |
| 期货交易时间轴 | /api/futures/calendar/session-timeline | 查询期货合约最近交易日的交易时间轴。 |
通用约定
- Base URL:
https://fuyao.aicubes.cn。 - 公开 API 使用
X-api-key。 - 期货合约使用完整
thscode,品种代码使用大写形式。 - ISO 日期按
Asia/Shanghai解释,Unix 时间戳为毫秒;金融数值与日期来源缺失时可为null,合法无数据时返回[]。