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 接口
1. 手续费与保证金查询
端点: 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手保证金
- 做多保证金率、做空保证金率
- 最新价、合约乘数、最小跳动
2. 特殊品种检测
端点: 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万元..."
}
3. 最近交易公告
端点: GET /api/announcements/recent
获取最近 5 条交易提示公告。
示例调用:
curl -sk "https://124.221.52.208/api/announcements/recent"
4. 交易日历数据
端点: 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": [...]}
5. 按日期查询公告
端点: 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"
6. 公司列表
端点: 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
- 按日期展示有事件的日期及对应内容