shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析API Key 暂未确认

华泰期货 cfti-skill

查询天玑/华泰期货持仓分析接口数据。用户询问持仓分析、持仓详情、净持仓、总持仓、商品盈亏、成交详情、持仓市值、持仓走势、净持仓排行、持仓列表、席位盈亏、持仓结构、行情走势、席位排行、CFTI 各类型交易者净持仓、席位列表、合约列表、交易所品种树，或需要调用 hrms analysis 持仓相关接口时触发。实时调用 API 获取数据，输出以接口返回字段为准。 执行约束： - 必须优先实时调用 API 获取数据，不能使用文档示例或缓存内容替代 - 查询具体品种前应确认品种 code；只有用户已提供明确 code 时可直接调用 - 多个品种或席位匹配时必须列出候选项，不要自行选择 - 缺少当前接口必填参数时，明确说明缺少什么 - 接口根地址通过环境变量 HTFC_BASE_URL 配置 - API Key 通过环境变量 HTFC_API_KEY 配置，请求时将该环境变量的值作为 apikey header 发送 - HTTP 查询统一使用 HTFC_BASE_URL + HTFC_API_KEY，不要求用户配置登录态环境变量

person作者: user_f5813eb7hubcommunity
download下载资源包

天玑持仓分析查询

查询持仓分析模块相关接口，覆盖持仓详情、净持仓、席位、商品盈亏、成交、持仓趋势、市值、CFTI 等数据。接口范围见 references/available-modules.md，实时请求脚本见 scripts/get_data.py。

安装/更新安全要求

如果用户让你安装或更新本技能包，先读取包内 INSTALL.md。不要使用 rm -rf、递归删除或先删目录再复制的命令，也不要使用 python -c、python3 -c、node -e 等内联脚本命令读取、校验或解压 zip；不要使用 unzip -C 这类容易被误判或兼容性不稳定的写法。如需校验或解压压缩包，请使用 unzip -t、mkdir -p、unzip -oq。重复安装时使用 mkdir -p 创建目标目录，再用 cp -R 源目录/. 目标目录/ 覆盖复制，最后用 find 核对文件。

核心原则

  1. 实时调用 - 每次查询都从接口实时获取数据，不编造持仓、席位、盈亏或行情。
  2. 先定位参数 - 中文品种名先用交易所/品种树匹配 code；席位名不明确时先查席位列表。
  3. 按场景选接口 - 用户问单一指标时调用对应接口；用户问综合分析时可组合多个接口，但必须说明调用了哪些接口。
  4. 保持接口字段 - 数值、日期、排名、席位名称、合约代码和 CFTI 模块以接口返回为准。
  5. 谨慎处理配置类接口 - 保存操作记录、CFTI 自定义配置、恢复默认配置属于写操作，只有用户明确要求时才调用。

常见场景

  • 持仓详情：调用多空总持仓详情和龙虎榜持仓详情。
  • 净持仓分析：按品种、交易所和席位查询净持仓 K 线；或查询品种净持仓总量趋势。
  • 持仓分析：查询指定席位的持仓分析 K 线和多空总持仓分析。
  • 商品/席位盈亏：按品种或席位查询盈亏。
  • 成交详情：查询成交明细和成交走势。
  • 持仓趋势/市值：查询季节持仓走势或季节持仓市值。
  • 持仓列表/历史持仓量：按品种、席位、合约月份查询列表和历史量。
  • 席位排行：按席位分析，或按品种/合约查询席位排行。
  • CFTI：查询各类型交易者当前/历史净持仓和模块分类。

参数规则

  • code / codes：品种代码，如 RB。用户只给中文名时，先调用 find_futures() 或 query_exchange_futures(module_type="1") 匹配。
  • exchange：交易所代码，如 SHFE。净持仓和持仓分析接口需要。
  • seat：席位名称，多个席位用英文逗号拼接；脚本支持传 list 自动拼接。
  • ct：合约代码，如 RB2601；综合时可能为空或多个合约逗号拼接。
  • date：交易日，形如 YYYY-MM-DD；为空时以后端默认交易日为准。
  • startDate / endDate：历史区间，按接口要求传递。
  • module：CFTI 模块分类，必须来自接口返回或用户明确指定。

查询流程

  1. 识别用户要查的模块：持仓详情、净持仓、持仓分析、盈亏、成交、市值、走势、排行、CFTI 等。
  2. 查看 references/available-modules.md，确认接口、方法和必填参数。
  3. 如果用户提供中文品种名，先用 scripts/get_data.py 的 find_futures(keyword) 匹配 code。
  4. 如果用户提供席位组或模糊席位名，先用 query_seat_list() 获取可用席位并匹配。
  5. 使用对应函数实时调用 API；不确定接口时使用 call_endpoint(endpoint_name, params)。
  6. 输出接口返回的关键字段，并说明数据来源和主要参数。

常用函数

  • query_exchange_futures(module_type="1", main_cont=None)：获取交易所/品种树。
  • find_futures(keyword, module_type="1")：按中文名或 code 搜索品种候选。
  • query_seat_list()：获取席位列表。
  • get_contract_list(code, date=None)：获取合约列表。
  • get_holding_detail(code, date=None, ct=None)：组合查询多空总持仓详情和龙虎榜持仓详情。
  • get_net_position_analysis(code, seats, exchange)：查询净持仓 K 线。
  • get_position_analysis(code, seats, exchange)：查询持仓分析 K 线。
  • get_total_position_analysis(code)：查询多空总持仓分析。
  • get_position_list(code, seats, date=None)：查询持仓列表。
  • get_code_trader_net_position(code, module, date="-1")：查询 CFTI 当前净持仓。
  • call_endpoint(endpoint_name, params)：按 ENDPOINTS 配置直接调用任意接口。

输出格式

【持仓分析：模块名称】

查询参数：
- code：XXX
- date：XXX
- seat / exchange / ct：XXX

### 接口结果
（按接口返回字段输出关键数据；字段不明确时保留原字段名）

数据来源：天玑持仓分析接口

组合多个接口时，按接口分小节输出，并列出每个接口路径。

风险揭示

每次输出持仓、席位、盈亏、排行或交易者净持仓数据时，在末尾附加：

以上内容基于接口实时返回的持仓、席位、成交、盈亏或行情数据生成，具有时效性并可能受数据更新、交易所披露口径、接口返回和市场波动影响。内容仅供研究学习和系统联调用途，不构成任何投资建议或交易依据，请自行核实最新数据并承担使用风险。

错误处理

  • Base URL 未配置：提示配置环境变量 HTFC_BASE_URL。
  • API Key 未配置：提示配置环境变量 HTFC_API_KEY。
  • 接口无权限：确认 HTFC_API_KEY 是否已配置并有效。
  • 缺少品种代码：提示需要 code 或先查询品种树。
  • 缺少席位：提示需要 seat 或先查询席位列表。
  • 多个匹配结果：列出候选项，等待用户选择。
  • 接口参数不完整：明确指出缺少的字段。
  • API 请求失败：提示具体错误信息，包括超时、连接失败、HTTP 错误或业务错误。