futurespro-panda

FuturesPro Panda Skill 期货手续费与保证金数据查询工具。通过 HTTP API 获取实时期货数据。 配置 默认 API 地址：https://124.221.52.208 所有接口路径前缀为 /api/。如用户指定其他地址，使用用户提供的地址。

使用方法 当用户查询期货相关数据时，使用 curl 或 WebFetch 工具调用对应 API。 中文参数编码 URL 中的中文参数需要 URL 编码。常用编码： 苹果 = %E8%8B%B9%E6%9E%9C 原油 = %E5%8E%9F%E6%B2%B9 黄金 = %E9%BB%84%E9%87%91 白银 = %E7%99%BD%E9%93%B6 铜 = %E9%93%9C 螺纹钢 = %E8%9E%BA%E7%BA%B9%E9%92%A2 或使用 curl --data-urlencode 自动编码。

API 接口

• 手续费与保证金查询

端点：GET /api/fees 参数： 参数 类型 说明 product_name string 品种名称模糊匹配，如 "苹果"、"原油" contract_code string 合约代码模糊匹配，如 "AP605" max_margin float 最大保证金筛选 margin_type string "company" 使用公司保证金，否则交易所 company_id int 公司 ID，配合 margin_type="company"

示例调用： # 查询苹果品种 curl -sk "https://124.221.52.208/api/fees?product_name=%E8%8B%B9%E6%9E%9C" # 查询原油（特殊品种） curl -sk "https://124.221.52.208/api/fees?product_name=%E5%8E%9F%E6%B2%B9" # 查询所有数据 curl -sk "https://124.221.52.208/api/fees"

返回字段： 品种名称、合约代码、product_code、1手开仓费用、1手平仓费用、1手平今费用、做多1手保证金、做空1手保证金、做多保证金率、做空保证金率、最新价、合约乘数、最小跳动

• 特殊品种检测

端点：GET /api/special-variety 检测某品种是否为特殊品种（需要特殊开户条件，如原油、铁矿石、PTA等）。 参数： 参数 类型 说明 product_code string 品种代码，如 "SC"、"I" product_name string 品种名称，如 "原油"、"铁矿石"

示例调用： # 检测原油 curl -sk "https://124.221.52.208/api/special-variety?product_code=SC&product_name=%E5%8E%9F%E6%B2%B9" # 检测铁矿石 curl -sk "https://124.221.52.208/api/special-variety?product_code=I&product_name=%E9%93%81%E7%9F%BF%E7%9F%B3"

返回： { "is_special": true, "condition_index": "COND_002", "content": "资金要求：申请日前连续5个交易日每日结算后账户可用资金余额不低于人民币50万元..." }

• 最近交易公告

端点：GET /api/announcements/recent 获取最近 5 条交易提示公告。 示例调用： curl -sk "https://124.221.52.208/api/announcements/recent"

• 交易日历数据

端点：GET /api/announcements/calendar 获取指定月份的日历事件，按日期分组。 参数： 参数 类型 说明 year int 年份，默认当前年 month int 月份，默认当前月

示例调用： # 查询 2026 年 4 月 curl -sk "https://124.221.52.208/api/announcements/calendar?year=2026&month=4"

返回格式： 按日期分组的对象，如 {"23": [...], "24": [...]}

• 按日期查询公告

端点：GET /api/announcements/by-date 参数： 参数 类型 必填 说明 date_str string 是 日期，格式 "YYYY-MM-DD"

示例调用： curl -sk "https://124.221.52.208/api/announcements/by-date?date_str=2026-04-24"

• 公司列表

端点：GET /api/companies 获取所有期货公司列表。 示例调用： curl -sk "https://124.221.52.208/api/companies"

常见用户请求处理流程 用户问："查询苹果的手续费" → 调用 GET /api/fees?product_name=%E8%8B%B9%E6%9E%9C → 提取返回数据中的手续费和保证金信息 → 以表格形式展示给用户

用户问："原油是特殊品种吗？开户条件是什么？" → 调用 GET /api/special-variety?product_code=SC&product_name=%E5%8E%9F%E6%B2%B9 → 根据 is_special 判断是否为特殊品种 → 如果是，展示 content 中的开户条件

用户问："最近的交易提示有哪些？" → 调用 GET /api/announcements/recent → 展示最近 5 条公告的标题和日期

用户问："4月24日有什么交易安排？" → 调用 GET /api/announcements/by-date?date_str=2026-04-24 → 展示该日期的所有公告内容

用户问："显示4月的交易日历" → 调用 GET /api/announcements/calendar?year=2026&month=4 → 按日期展示有事件的日期及对应内容