Futures Inquiry - 期货查询

查询上期所、大商所、郑商所、中金所、广期所等期货品种价格行情。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？或类似期货行情问题时，使用本技能。

极速数据期货查询（Jisu Futures）

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。

前置配置：获取 API Key

1. 前往 极速数据官网 注册账号
2. 进入 期货查询 API 页面，点击「申请数据」
3. 在会员中心获取 AppKey
4. 配置 Key：

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/futures/futures.py

使用方式

当前脚本通过不同子命令调用不同交易所接口：

1. 上海期货交易所（/futures/shfutures）

python3 skills/futures/futures.py shfutures

2. 大连商品交易所（/futures/dlfutures）

python3 skills/futures/futures.py dlfutures

3. 郑州商品交易所（/futures/zzfutures）

python3 skills/futures/futures.py zzfutures

4. 中国金融期货交易所（/futures/zgjrfutures）

python3 skills/futures/futures.py zgjrfutures

5. 广州期货交易所（/futures/gzfutures）

python3 skills/futures/futures.py gzfutures

上述接口均无需额外 JSON 参数，脚本会直接输出接口 result 对象，其内部按品种名称分组，例如 {"燃油": [...合约列表...], "铜": [...合约列表...]}。

返回结果示例（节选）

{
  "燃油": [
    {
      "type": "FU2309",
      "typename": "燃料油2309",
      "price": "2948.00",
      "changepercent": "+6.27%",
      "changequantity": "+174",
      "maxprice": "2975.00",
      "minprice": "2777.00",
      "openingprice": "2782.00",
      "lastclosingprice": "2774.000",
      "tradeamount": "704525",
      "holdamount": "295063",
      "buyamount": "47",
      "buyprice": "2947.000",
      "sellamount": "66",
      "sellprice": "2948.000",
      "updatetime": "2023-04-03 15:46:43"
    }
  ]
}

常见错误码

业务错误码（参考官网错误码参照）：

代号	说明
201	没有信息

系统错误码：

代号	说明
101	APPKEY 为空或不存在
102	APPKEY 已过期
103	APPKEY 无请求此数据权限
104	请求超过次数限制
105	IP 被禁止
106	IP 请求超过限制
107	接口维护中
108	接口已停用

推荐用法

1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」
2. 代理按交易所调用对应命令，例如：python3 skills/futures/futures.py shfutures、python3 skills/futures/futures.py dlfutures、python3 skills/futures/futures.py gzfutures。
3. 从返回的 result 中按品种名称（如 PTA、燃油、工业硅）筛选相关合约，读取 price、changepercent、maxprice、minprice、tradeamount 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。