hithink-finance-futures 是 hithink-finance CLI 的期货领域命令集合,用于获取期货公开资料与行情数据。
用途:查询期货品种与合约信息,以及持仓、仓单、基差、交易日程和行情数据。
主要能力(命令路由):期货品种用 futures varieties;合约详情用 futures contract-detail;品种或公司持仓用 futures variety-positions / futures company-variety-positions;合约持仓及其历史用 futures contract-positions / futures contract-position-history;仓单或基差用 futures warehouse-receipts / futures latest-basis / futures basis-history;交易日程用 futures trading-schedule;分时或日 K 用 futures intraday / futures daily。此外还提供品种板块、商品指数、主力与次主力合约、主力连续、持仓公司、交易时段等命令。
使用方式:首次使用本域先读取共享规则;首次执行或版本变化时查看 hithink-finance capabilities --format json 与 hithink-finance schema <capability-id> --format json,组合规则不明确时查看 --help;执行具体命令前先读取对应 reference 文件,不要只凭命令名猜参数。全市场、分页、多标的或长区间查询使用命令声明的 --output <path> 落盘,只报告摘要。
限制:必须使用完整期货 thscode;品种代码须大写并与合约匹配。历史持仓开始日须在调用日前一年内;daily 的 start/end 必须成对提供。金融数值与日期允许为 null,合法无数据返回空数组。凭据与输出约定见共享规则。