{"id":"e425f0da-6788-45ab-a4b2-eb7e31180956","entityType":"agent","slug":"clawhub-jisuapi-futures","name":"期货查询 - Futures Inquiry","canonicalUrl":"https://www.xpersona.co/agent/clawhub-jisuapi-futures","canonicalPath":"/agent/clawhub-jisuapi-futures","generatedAt":"2026-10-09T12:34:39.928Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":null},"description":"查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Skill: 期货查询 - Futures Inquiry Owner: jisuapi Summary: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-10T08:08:30.898Z | user - Removed the skill-card.md file. - No changes to logic, usage, or configuration; documentation and core functionality remain the same. v1.0.7 | 2026-06-23T07:58:24.051Z | user **Futures v1.0.7 – 支持期货历史","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s174fh1b14sn7vkvbqwsdn0xtd83gz5h:futures","sourceUrl":"https://clawhub.ai/jisuapi/futures","homepage":"https://clawhub.ai/jisuapi/skills/futures","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/jisuapi/futures","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/jisuapi/skills/futures","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Skill: 期货查询 - Futures Inquiry Owner: jisuapi Summary: 查询上期所、大商所、郑商所、中金所、广"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":null},"stars":null,"forks":null,"downloads":3125,"packageName":null,"latestVersion":"1.0.8","tractionLabel":"3.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T09:38:09.393Z","lastCrawledAt":"2026-10-09T09:38:09.393Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T09:38:09.393Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.8","createdAt":"2026-09-10T08:08:30.898Z","changelog":"- Removed the skill-card.md file. - No changes to logic, usage, or configuration; documentation and core functionality remain the same.","fileCount":4,"zipByteSize":6266},{"version":"1.0.7","createdAt":"2026-06-23T07:58:24.051Z","changelog":"**Futures v1.0.7 – 支持期货历史查询与单合约代码查询** - 新增 /futures/history 接口，支持按合约代码与日期区间查询期货历史 K 线（开高低收、涨跌幅、成交/持仓量）。 - 实时行情接口优化：支持通过 type 参数直接查询单一合约（减少返回量）。 - 文档完善：详细说明历史接口用法及参数，可按市场、品种和日期灵活查历史走势。 - 用法与错误处理示例补充，提升易用性和出错提示明确度。 - skill-card.md 文件已移除，规范文档结构。","fileCount":4,"zipByteSize":6517},{"version":"1.0.6","createdAt":"2026-04-03T09:10:20.607Z","changelog":"- 更新名称与描述，更加清晰表述技能用途和适用场景 - 优化 API 申请步骤说明，更便于用户理解 - 增加部分例句，明确用户提问场景与推荐用法 - 强化文档整体结构，无接口及返回参数变更","fileCount":4,"zipByteSize":5611},{"version":"1.0.5","createdAt":"2026-03-27T04:22:57.030Z","changelog":"- 文档优化：简化环境配置说明，突出获取 API Key 步骤，增加引导性说明 - 精简描述，将数据服务及数据范围介绍前置，便于理解 - 推荐用法、错误码、样例等细节未变，结构更加清晰 - 其他内容与此前版本一致，接口和使用方法无改动","fileCount":3,"zipByteSize":4142},{"version":"1.0.4","createdAt":"2026-03-24T10:47:43.694Z","changelog":"- Documentation update: Added a new \"关于极速数据\" section to introduce JisuAPI, its services, and instructions for obtaining API credentials. - No code or behavior changes in this release.","fileCount":3,"zipByteSize":4097},{"version":"1.0.3","createdAt":"2026-03-17T06:22:32.296Z","changelog":"- No functional or documentation changes in this version. - No file changes detected compared to the previous release.","fileCount":3,"zipByteSize":3339},{"version":"1.0.2","createdAt":"2026-03-17T03:58:01.649Z","changelog":"- No file changes detected in this release. - Documentation and usage instructions remain up to date. - No new features, bug fixes, or interface updates in this version.","fileCount":3,"zipByteSize":3339},{"version":"1.0.1","createdAt":"2026-03-16T03:37:06.332Z","changelog":"- Updated script file path from skill/futures/futures.py to skills/futures/futures.py throughout the documentation. - Adjusted usage instructions and example commands to reflect the new script path. - No changes to core functionality or API usage.","fileCount":3,"zipByteSize":3339}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174fh1b14sn7vkvbqwsdn0xtd83gz5h:futures","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T12:34:39.927Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":null},"readme":"Skill: 期货查询 - Futures Inquiry\n\nOwner: jisuapi\n\nSummary: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。\n\nTags: latest:1.0.8\n\nVersion history:\n\nv1.0.8 | 2026-09-10T08:08:30.898Z | user\n\n- Removed the skill-card.md file.\n- No changes to logic, usage, or configuration; documentation and core functionality remain the same.\n\nv1.0.7 | 2026-06-23T07:58:24.051Z | user\n\n**Futures v1.0.7 – 支持期货历史查询与单合约代码查询**\n\n- 新增 /futures/history 接口，支持按合约代码与日期区间查询期货历史 K 线（开高低收、涨跌幅、成交/持仓量）。\n- 实时行情接口优化：支持通过 type 参数直接查询单一合约（减少返回量）。\n- 文档完善：详细说明历史接口用法及参数，可按市场、品种和日期灵活查历史走势。\n- 用法与错误处理示例补充，提升易用性和出错提示明确度。\n- skill-card.md 文件已移除，规范文档结构。\n\nv1.0.6 | 2026-04-03T09:10:20.607Z | user\n\n- 更新名称与描述，更加清晰表述技能用途和适用场景\n- 优化 API 申请步骤说明，更便于用户理解\n- 增加部分例句，明确用户提问场景与推荐用法\n- 强化文档整体结构，无接口及返回参数变更\n\nv1.0.5 | 2026-03-27T04:22:57.030Z | user\n\n- 文档优化：简化环境配置说明，突出获取 API Key 步骤，增加引导性说明\n- 精简描述，将数据服务及数据范围介绍前置，便于理解\n- 推荐用法、错误码、样例等细节未变，结构更加清晰\n- 其他内容与此前版本一致，接口和使用方法无改动\n\nv1.0.4 | 2026-03-24T10:47:43.694Z | user\n\n- Documentation update: Added a new \"关于极速数据\" section to introduce JisuAPI, its services, and instructions for obtaining API credentials.\n- No code or behavior changes in this release.\n\nv1.0.3 | 2026-03-17T06:22:32.296Z | user\n\n- No functional or documentation changes in this version.\n- No file changes detected compared to the previous release.\n\nv1.0.2 | 2026-03-17T03:58:01.649Z | user\n\n- No file changes detected in this release.\n- Documentation and usage instructions remain up to date.\n- No new features, bug fixes, or interface updates in this version.\n\nv1.0.1 | 2026-03-16T03:37:06.332Z | user\n\n- Updated script file path from skill/futures/futures.py to skills/futures/futures.py throughout the documentation.\n- Adjusted usage instructions and example commands to reflect the new script path. \n- No changes to core functionality or API usage.\n\nv1.0.0 | 2026-03-13T04:11:28.710Z | user\n\nInitial release of jisu-futures for OpenClaw:\n\n- Provides real-time futures price queries for major Chinese exchanges including Shanghai, Dalian, Zhengzhou, China Financial Futures, and Guangzhou.\n- Supports command-line usage to fetch data from each exchange via simple subcommands.\n- Returns rich market data: contract code, name, latest price, change %, highs/lows, volume, open/close, bid/ask, and update time.\n- Requires a JISU_API_KEY environment variable for API access.\n- Includes detailed usage, environment configuration instructions, typical response examples, and error code explanations.\n\nArchive index:\n\nArchive v1.0.8: 4 files, 6266 bytes\n\nFiles: futures.py (4173b), skill-card.md (2130b), SKILL.md (8040b), _meta.json (126b)\n\nFile v1.0.8:SKILL.md\n\n---\r\nname: \"Futures Inquiry - 期货查询\"\r\ndescription: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n# 极速数据期货查询（Jisu Futures）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 提供上海、大连、郑州、中金、广州等交易所期货价格查询。\r\n\r\n## 何时使用本技能\r\n\r\n- **期货价格**、**主力合约**、**某品种涨跌**（如螺纹钢、豆粕、PTA、工业硅、IF 股指）\r\n- **五大交易所**行情：上期所、大商所、郑商所、中金所、广期所\r\n- **历史走势**：指定合约在某段时间的开高低收、成交量、持仓量\r\n\r\n**技术前提：** 脚本 **`skills/futures/futures.py`**，环境变量 **`JISU_API_KEY`**。\r\n\r\n**接口与数据范围：**\r\n\r\n- **上海期货交易所**（`/futures/shfutures`）\r\n- **大连商品交易所**（`/futures/dlfutures`）\r\n- **郑州商品交易所**（`/futures/zzfutures`）\r\n- **中国金融期货交易所**（`/futures/zgjrfutures`）\r\n- **广州期货交易所**（`/futures/gzfutures`）\r\n- **期货历史查询**（`/futures/history`）\r\n\r\n各交易所实时接口返回：品种代号、名称、最新价、涨跌幅、涨跌量、最高/最低价、开盘价、昨收盘价、成交量、持仓量、买卖价量、更新时间等。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [期货查询 API](https://www.jisuapi.com/api/futures/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n\r\n# 指定品种（可选 type）\r\npython3 skills/futures/futures.py shfutures '{\"type\":\"FU2309\"}'\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\npython3 skills/futures/futures.py dlfutures '{\"type\":\"V0\"}'\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\npython3 skills/futures/futures.py zzfutures '{\"type\":\"TA0\"}'\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\npython3 skills/futures/futures.py zgjrfutures '{\"type\":\"IF2306\"}'\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\npython3 skills/futures/futures.py gzfutures '{\"type\":\"SI0\"}'\r\n```\r\n\r\n### 6. 期货历史查询（/futures/history）\r\n\r\n按交易所、合约代码与日期区间查询历史开高低收、涨跌幅、成交量、持仓量等。\r\n\r\n```bash\r\npython3 skills/futures/futures.py history '{\"market\":\"shfutures\",\"type\":\"SC2703\",\"startdate\":\"2026-06-01\",\"enddate\":\"2026-06-10\"}'\r\n```\r\n\r\n请求 JSON：\r\n\r\n```json\r\n{\r\n \"market\": \"shfutures\",\r\n \"type\": \"SC2703\",\r\n \"startdate\": \"2026-06-01\",\r\n \"enddate\": \"2026-06-10\"\r\n}\r\n```\r\n\r\n| 字段名 | 类型 | 必填 | 说明 |\r\n|-----------|--------|------|----------------------------------------------------------------------|\r\n| market | string | 是 | `shfutures` / `dlfutures` / `zzfutures` / `zgjrfutures` / `gzfutures` |\r\n| type | string | 是 | 期货类型代码，如 `SC2703`、`TA0`、`IF2306` |\r\n| startdate | string | 是 | 开始日期 |\r\n| enddate | string | 是 | 结束日期 |\r\n\r\n### 各交易所实时接口可选参数\r\n\r\n| 字段名 | 类型 | 必填 | 说明 |\r\n|--------|--------|------|--------------|\r\n| type | string | 否 | 期货类型代码 |\r\n\r\n实时接口 `result` 按品种名称分组，例如 `{\"燃油\": [...], \"铜\": [...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n### 上海期货交易所（实时）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n### 期货历史查询\r\n\r\n```json\r\n{\r\n \"market\": \"shfutures\",\r\n \"type\": \"SC2703\",\r\n \"startdate\": \"2026-06-01\",\r\n \"enddate\": \"2026-06-10\",\r\n \"count\": 8,\r\n \"list\": [\r\n {\r\n \"typename\": \"上海原油2703\",\r\n \"date\": \"2026-06-10\",\r\n \"openingprice\": 562,\r\n \"maxprice\": 565.6,\r\n \"minprice\": 550.8,\r\n \"price\": 559.2,\r\n \"changeamount\": -5.8,\r\n \"changepercent\": \"-1.027%\",\r\n \"tradeamount\": 23,\r\n \"holdamount\": 0\r\n }\r\n ]\r\n}\r\n```\r\n\r\n当无数据时，脚本会输出：\r\n\r\n```json\r\n{\r\n \"error\": \"api_error\",\r\n \"code\": 201,\r\n \"message\": \"没有信息\"\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n来源于 [极速数据期货文档](https://www.jisuapi.com/api/futures/)：\r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 推荐用法\r\n\r\n1. **实时行情**：用户问「PTA、燃油今天什么价？」 \r\n - 调用 `zzfutures`、`shfutures` 等对应交易所 \r\n - 从返回的分组结果中按品种名（如 `PTA`、`燃油`）筛选合约，汇总 `price`、`changepercent`、`maxprice`、`minprice`\r\n\r\n2. **单合约查询**：已知合约代码时加 `type` 参数，减少返回体积： \r\n `python3 skills/futures/futures.py zzfutures '{\"type\":\"TA0\"}'`\r\n\r\n3. **历史走势**：用户问「SC2703 最近一周走势」 \r\n - 调用 `history`，`market` 与交易所子命令一致（如上期所 → `shfutures`） \r\n - 用 `list` 中的开高低收、涨跌幅归纳区间表现，并注明数据时效与免责\r\n\r\n4. **交易所对照**\r\n\r\n | 用户说法 | 子命令 | history 的 market |\r\n |--------------|--------------|-------------------|\r\n | 上期所、上海 | `shfutures` | `shfutures` |\r\n | 大商所、大连 | `dlfutures` | `dlfutures` |\r\n | 郑商所、郑州 | `zzfutures` | `zzfutures` |\r\n | 中金所、股指 | `zgjrfutures`| `zgjrfutures` |\r\n | 广期所、广州 | `gzfutures` | `gzfutures` |\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供生活常用、交通出行、工具万能、图像识别、娱乐购物、位置服务等百余类 API。\r\n\r\n在官网注册后，按 [期货查询 API](https://www.jisuapi.com/api/futures/) 申请数据，在会员中心获取 **AppKey** 进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\n\nFile v1.0.8:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789027710898\n}\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nQueries real-time and historical futures market data for Shanghai, Dalian, Zhengzhou, China Financial Futures, and Guangzhou futures exchanges using JisuAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[jisuapi](https://clawhub.ai/user/jisuapi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to answer futures price, contract movement, exchange listing, and historical K-line questions for supported Chinese futures exchanges.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends JISU_API_KEY and requested exchange, contract, and date-range parameters to JisuAPI over the network.\n\nMitigation: Install only when JisuAPI is an acceptable data provider, provide the key through the JISU_API_KEY environment variable, and rotate or revoke the key if exposure is suspected.\n\nRisk: Futures responses depend on third-party API availability, permissions, rate limits, and data freshness.\n\nMitigation: Surface returned timestamps and error objects to users, and verify consequential trading or compliance decisions against authoritative market sources.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/jisuapi/skills/futures)\n- [JisuAPI Website](https://www.jisuapi.com/)\n- [JisuAPI Futures API Documentation](https://www.jisuapi.com/api/futures/)\n- [JisuAPI Futures API Endpoint](https://api.jisuapi.com/futures)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires python3 and JISU_API_KEY; returns JSON-formatted futures data or structured error objects.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.7: 4 files, 6517 bytes\n\nFiles: futures.py (4173b), skill-card.md (2471b), SKILL.md (8040b), _meta.json (126b)\n\nFile v1.0.7:SKILL.md\n\n---\r\nname: \"Futures Inquiry - 期货查询\"\r\ndescription: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n# 极速数据期货查询（Jisu Futures）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 提供上海、大连、郑州、中金、广州等交易所期货价格查询。\r\n\r\n## 何时使用本技能\r\n\r\n- **期货价格**、**主力合约**、**某品种涨跌**（如螺纹钢、豆粕、PTA、工业硅、IF 股指）\r\n- **五大交易所**行情：上期所、大商所、郑商所、中金所、广期所\r\n- **历史走势**：指定合约在某段时间的开高低收、成交量、持仓量\r\n\r\n**技术前提：** 脚本 **`skills/futures/futures.py`**，环境变量 **`JISU_API_KEY`**。\r\n\r\n**接口与数据范围：**\r\n\r\n- **上海期货交易所**（`/futures/shfutures`）\r\n- **大连商品交易所**（`/futures/dlfutures`）\r\n- **郑州商品交易所**（`/futures/zzfutures`）\r\n- **中国金融期货交易所**（`/futures/zgjrfutures`）\r\n- **广州期货交易所**（`/futures/gzfutures`）\r\n- **期货历史查询**（`/futures/history`）\r\n\r\n各交易所实时接口返回：品种代号、名称、最新价、涨跌幅、涨跌量、最高/最低价、开盘价、昨收盘价、成交量、持仓量、买卖价量、更新时间等。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [期货查询 API](https://www.jisuapi.com/api/futures/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n\r\n# 指定品种（可选 type）\r\npython3 skills/futures/futures.py shfutures '{\"type\":\"FU2309\"}'\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\npython3 skills/futures/futures.py dlfutures '{\"type\":\"V0\"}'\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\npython3 skills/futures/futures.py zzfutures '{\"type\":\"TA0\"}'\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\npython3 skills/futures/futures.py zgjrfutures '{\"type\":\"IF2306\"}'\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\npython3 skills/futures/futures.py gzfutures '{\"type\":\"SI0\"}'\r\n```\r\n\r\n### 6. 期货历史查询（/futures/history）\r\n\r\n按交易所、合约代码与日期区间查询历史开高低收、涨跌幅、成交量、持仓量等。\r\n\r\n```bash\r\npython3 skills/futures/futures.py history '{\"market\":\"shfutures\",\"type\":\"SC2703\",\"startdate\":\"2026-06-01\",\"enddate\":\"2026-06-10\"}'\r\n```\r\n\r\n请求 JSON：\r\n\r\n```json\r\n{\r\n \"market\": \"shfutures\",\r\n \"type\": \"SC2703\",\r\n \"startdate\": \"2026-06-01\",\r\n \"enddate\": \"2026-06-10\"\r\n}\r\n```\r\n\r\n| 字段名 | 类型 | 必填 | 说明 |\r\n|-----------|--------|------|----------------------------------------------------------------------|\r\n| market | string | 是 | `shfutures` / `dlfutures` / `zzfutures` / `zgjrfutures` / `gzfutures` |\r\n| type | string | 是 | 期货类型代码，如 `SC2703`、`TA0`、`IF2306` |\r\n| startdate | string | 是 | 开始日期 |\r\n| enddate | string | 是 | 结束日期 |\r\n\r\n### 各交易所实时接口可选参数\r\n\r\n| 字段名 | 类型 | 必填 | 说明 |\r\n|--------|--------|------|--------------|\r\n| type | string | 否 | 期货类型代码 |\r\n\r\n实时接口 `result` 按品种名称分组，例如 `{\"燃油\": [...], \"铜\": [...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n### 上海期货交易所（实时）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n### 期货历史查询\r\n\r\n```json\r\n{\r\n \"market\": \"shfutures\",\r\n \"type\": \"SC2703\",\r\n \"startdate\": \"2026-06-01\",\r\n \"enddate\": \"2026-06-10\",\r\n \"count\": 8,\r\n \"list\": [\r\n {\r\n \"typename\": \"上海原油2703\",\r\n \"date\": \"2026-06-10\",\r\n \"openingprice\": 562,\r\n \"maxprice\": 565.6,\r\n \"minprice\": 550.8,\r\n \"price\": 559.2,\r\n \"changeamount\": -5.8,\r\n \"changepercent\": \"-1.027%\",\r\n \"tradeamount\": 23,\r\n \"holdamount\": 0\r\n }\r\n ]\r\n}\r\n```\r\n\r\n当无数据时，脚本会输出：\r\n\r\n```json\r\n{\r\n \"error\": \"api_error\",\r\n \"code\": 201,\r\n \"message\": \"没有信息\"\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n来源于 [极速数据期货文档](https://www.jisuapi.com/api/futures/)：\r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 推荐用法\r\n\r\n1. **实时行情**：用户问「PTA、燃油今天什么价？」 \r\n - 调用 `zzfutures`、`shfutures` 等对应交易所 \r\n - 从返回的分组结果中按品种名（如 `PTA`、`燃油`）筛选合约，汇总 `price`、`changepercent`、`maxprice`、`minprice`\r\n\r\n2. **单合约查询**：已知合约代码时加 `type` 参数，减少返回体积： \r\n `python3 skills/futures/futures.py zzfutures '{\"type\":\"TA0\"}'`\r\n\r\n3. **历史走势**：用户问「SC2703 最近一周走势」 \r\n - 调用 `history`，`market` 与交易所子命令一致（如上期所 → `shfutures`） \r\n - 用 `list` 中的开高低收、涨跌幅归纳区间表现，并注明数据时效与免责\r\n\r\n4. **交易所对照**\r\n\r\n | 用户说法 | 子命令 | history 的 market |\r\n |--------------|--------------|-------------------|\r\n | 上期所、上海 | `shfutures` | `shfutures` |\r\n | 大商所、大连 | `dlfutures` | `dlfutures` |\r\n | 郑商所、郑州 | `zzfutures` | `zzfutures` |\r\n | 中金所、股指 | `zgjrfutures`| `zgjrfutures` |\r\n | 广期所、广州 | `gzfutures` | `gzfutures` |\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供生活常用、交通出行、工具万能、图像识别、娱乐购物、位置服务等百余类 API。\r\n\r\n在官网注册后，按 [期货查询 API](https://www.jisuapi.com/api/futures/) 申请数据，在会员中心获取 **AppKey** 进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1782201504051\n}\n\nFile v1.0.7:skill-card.md\n\n## Description:
\n查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[jisuapi](https://clawhub.ai/user/jisuapi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to retrieve real-time and historical futures market data from JisuAPI for Shanghai, Dalian, Zhengzhou, China Financial Futures Exchange, and Guangzhou futures markets. It is intended for informational market-data lookup and summary, including single-contract queries and date-range historical K-line analysis.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The configured JISU_API_KEY is sent to JisuAPI during futures data requests.
\nMitigation: Use a dedicated JisuAPI key with appropriate scope and rotate it if exposure is suspected.
\nRisk: Market prices returned by the skill may be delayed, unavailable, or unsuitable as the sole basis for trading decisions.
\nMitigation: Use the data for informational lookup and verify important prices with an official source before acting.
\nRisk: The script depends on python3 and the Python requests package being available in the runtime.
\nMitigation: Confirm the runtime includes python3 and requests before relying on the skill.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/jisuapi/skills/futures)
\n- [JisuAPI](https://www.jisuapi.com/)
\n- [JisuAPI futures API documentation](https://www.jisuapi.com/api/futures/)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown guidance with shell commands and JSON API responses]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires python3, the Python requests package, and JISU_API_KEY.]
\n\n## Skill Version(s):
\n1.0.7 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.6: 4 files, 5611 bytes\n\nFiles: futures.py (3095b), skill-card.md (2296b), SKILL.md (5440b), _meta.json (126b)\n\nFile v1.0.6:SKILL.md\n\n---\r\nname: \"Futures Inquiry - 期货查询\"\r\ndescription: 查询上期所、大商所、郑商所、中金所、广期所等期货品种价格行情。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？或类似期货行情问题时，使用本技能。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [期货查询 API](https://www.jisuapi.com/api/futures/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r\n\r\n- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r\n- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r\n- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r\n- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r\n- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r\n- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r\n\r\n在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1775207420607\n}\n\nFile v1.0.6:skill-card.md\n\n## Description:
\n查询上期所、大商所、郑商所、中金所、广期所等期货品种价格行情。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？或类似期货行情问题时，使用本技能。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[jisuapi](https://clawhub.ai/user/jisuapi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and agents use this skill to fetch Chinese futures quote data from JisuAPI and summarize prices, percentage changes, volume, open interest, and update times for user-requested contracts or exchanges.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a JisuAPI AppKey, which may expose quota or billing impact if reused broadly or shared outside the runtime environment.
\nMitigation: Use a key intended for futures data lookups, keep it in the local environment as JISU_API_KEY, monitor quota or billing, and avoid sharing the key.
\nRisk: Futures quote data may be delayed, unavailable, or returned with provider error codes.
\nMitigation: Check the returned update time and error status, treat results as market-data reference, and verify critical trading decisions with an authoritative source.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/jisuapi/futures)
\n- [JisuAPI futures API](https://www.jisuapi.com/api/futures/)
\n- [JisuAPI](https://www.jisuapi.com/)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [JSON from the Python command, with Markdown usage guidance and shell examples in the skill documentation]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires python3 and a JISU_API_KEY environment variable; API calls are read-only futures data lookups.]
\n\n## Skill Version(s):
\n1.0.6 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.5: 3 files, 4142 bytes\n\nFiles: futures.py (3095b), SKILL.md (5337b), _meta.json (126b)\n\nFile v1.0.5:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [对应接口页面](https://www.jisuapi.com/api/futures/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r\n\r\n- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r\n- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r\n- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r\n- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r\n- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r\n- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r\n\r\n在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1774585377030\n}\n\nArchive v1.0.4: 3 files, 4097 bytes\n\nFiles: futures.py (3095b), SKILL.md (5271b), _meta.json (126b)\n\nFile v1.0.4:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n基于 [期货查询 API](https://www.jisuapi.com/api/futures/) 的 OpenClaw 技能，提供上海期货交易所、大连商品交易所、郑州商品交易所、中国金融期货交易所、广州期货交易所等多家交易所的期货价格查询。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/futures/\r\n\r\n## 环境变量配置\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 在 OpenClaw 中的推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r\n\r\n- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r\n- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r\n- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r\n- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r\n- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r\n- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r\n\r\n在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1774349263694\n}\n\nArchive v1.0.3: 3 files, 3339 bytes\n\nFiles: futures.py (3095b), SKILL.md (3875b), _meta.json (126b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n基于 [期货查询 API](https://www.jisuapi.com/api/futures/) 的 OpenClaw 技能，提供上海期货交易所、大连商品交易所、郑州商品交易所、中国金融期货交易所、广州期货交易所等多家交易所的期货价格查询。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/futures/\r\n\r\n## 环境变量配置\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 在 OpenClaw 中的推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1773728552296\n}\n\nArchive v1.0.2: 3 files, 3339 bytes\n\nFiles: futures.py (3095b), SKILL.md (3875b), _meta.json (126b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n基于 [期货查询 API](https://www.jisuapi.com/api/futures/) 的 OpenClaw 技能，提供上海期货交易所、大连商品交易所、郑州商品交易所、中国金融期货交易所、广州期货交易所等多家交易所的期货价格查询。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/futures/\r\n\r\n## 环境变量配置\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 在 OpenClaw 中的推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1773719881649\n}\n\nArchive v1.0.1: 3 files, 3339 bytes\n\nFiles: futures.py (3095b), SKILL.md (3875b), _meta.json (126b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n基于 [期货查询 API](https://www.jisuapi.com/api/futures/) 的 OpenClaw 技能，提供上海期货交易所、大连商品交易所、郑州商品交易所、中国金融期货交易所、广州期货交易所等多家交易所的期货价格查询。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/futures/\r\n\r\n## 环境变量配置\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 在 OpenClaw 中的推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1773632226332\n}\n\nArchive v1.0.0: 3 files, 3338 bytes\n\nFiles: futures.py (3095b), SKILL.md (3866b), _meta.json (126b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: jisu-futures\r\ndescription: 使用极速数据期货查询 API 获取上海、大连、郑州、中国金融、广州等交易所的期货价格行情。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据期货查询（Jisu Futures）\r\n\r\n基于 [期货查询 API](https://www.jisuapi.com/api/futures/) 的 OpenClaw 技能，提供上海期货交易所、大连商品交易所、郑州商品交易所、中国金融期货交易所、广州期货交易所等多家交易所的期货价格查询。\r\n\r\n每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r\n\r\n使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/futures/\r\n\r\n## 环境变量配置\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skill/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过不同子命令调用不同交易所接口：\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skill/futures/futures.py shfutures\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skill/futures/futures.py dlfutures\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skill/futures/futures.py zzfutures\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skill/futures/futures.py zgjrfutures\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skill/futures/futures.py gzfutures\r\n```\r\n\r\n上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{\"燃油\": [...合约列表...], \"铜\": [...合约列表...]}`。\r\n\r\n## 返回结果示例（节选）\r\n\r\n```json\r\n{\r\n \"燃油\": [\r\n {\r\n \"type\": \"FU2309\",\r\n \"typename\": \"燃料油2309\",\r\n \"price\": \"2948.00\",\r\n \"changepercent\": \"+6.27%\",\r\n \"changequantity\": \"+174\",\r\n \"maxprice\": \"2975.00\",\r\n \"minprice\": \"2777.00\",\r\n \"openingprice\": \"2782.00\",\r\n \"lastclosingprice\": \"2774.000\",\r\n \"tradeamount\": \"704525\",\r\n \"holdamount\": \"295063\",\r\n \"buyamount\": \"47\",\r\n \"buyprice\": \"2947.000\",\r\n \"sellamount\": \"66\",\r\n \"sellprice\": \"2948.000\",\r\n \"updatetime\": \"2023-04-03 15:46:43\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（参考官网错误码参照）： \r\n\r\n| 代号 | 说明 |\r\n|------|----------|\r\n| 201 | 没有信息 |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明 |\r\n|------|--------------------------|\r\n| 101 | APPKEY 为空或不存在 |\r\n| 102 | APPKEY 已过期 |\r\n| 103 | APPKEY 无请求此数据权限 |\r\n| 104 | 请求超过次数限制 |\r\n| 105 | IP 被禁止 |\r\n| 106 | IP 请求超过限制 |\r\n| 107 | 接口维护中 |\r\n| 108 | 接口已停用 |\r\n\r\n## 在 OpenClaw 中的推荐用法\r\n\r\n1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r\n2. 代理按交易所调用对应命令，例如：`python3 skill/futures/futures.py shfutures`、`python3 skill/futures/futures.py dlfutures`、`python3 skill/futures/futures.py gzfutures`。 \r\n3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1773375088710\n}","readmeExcerpt":"Skill: 期货查询 - Futures Inquiry Owner: jisuapi Summary: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-10T08:08:30.898Z | user - Removed the skill-card.md file. - No changes to logic, usage, or configuration; documentation and core functionality remain the same. v1.0.7 | 2026-06-23T07:58:24.051Z | user **Futures v1.0.7 – 支持期货历史","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: \"Futures Inquiry - 期货查询\"\r\ndescription: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。\r\nmetadata: { \"openclaw\": { \"emoji\": \"📉\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n# 极速数据期货查询（Jisu Futures）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 提供上海、大连、郑州、中金、广州等交易所期货价格查询。\r\n\r\n## 何时使用本技能\r\n\r\n- **期货价格**、**主力合约**、**某品种涨跌**（如螺纹钢、豆粕、PTA、工业硅、IF 股指）\r\n- **五大交易所**行情：上期所、大商所、郑商所、中金所、广期所\r\n- **历史走势**：指定合约在某段时间的开高低收、成交量、持仓量\r\n\r\n**技术前提：** 脚本 **`skills/futures/futures.py`**，环境变量 **`JISU_API_KEY`**。\r\n\r\n**接口与数据范围：**\r\n\r\n- **上海期货交易所**（`/futures/shfutures`）\r\n- **大连商品交易所**（`/futures/dlfutures`）\r\n- **郑州商品交易所**（`/futures/zzfutures`）\r\n- **中国金融期货交易所**（`/futures/zgjrfutures`）\r\n- **广州期货交易所**（`/futures/gzfutures`）\r\n- **期货历史查询**（`/futures/history`）\r\n\r\n各交易所实时接口返回：品种代号、名称、最新价、涨跌幅、涨跌量、最高/最低价、开盘价、昨收盘价、成交量、持仓量、买卖价量、更新时间等。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [期货查询 API](https://www.jisuapi.com/api/futures/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/futures/futures.py`\r\n\r\n## 使用方式\r\n\r\n### 1. 上海期货交易所（/futures/shfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py shfutures\r\n\r\n# 指定品种（可选 type）\r\npython3 skills/futures/futures.py shfutures '{\"type\":\"FU2309\"}'\r\n```\r\n\r\n### 2. 大连商品交易所（/futures/dlfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py dlfutures\r\npython3 skills/futures/futures.py dlfutures '{\"type\":\"V0\"}'\r\n```\r\n\r\n### 3. 郑州商品交易所（/futures/zzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zzfutures\r\npython3 skills/futures/futures.py zzfutures '{\"type\":\"TA0\"}'\r\n```\r\n\r\n### 4. 中国金融期货交易所（/futures/zgjrfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py zgjrfutures\r\npython3 skills/futures/futures.py zgjrfutures '{\"type\":\"IF2306\"}'\r\n```\r\n\r\n### 5. 广州期货交易所（/futures/gzfutures）\r\n\r\n```bash\r\npython3 skills/futures/futures.py gzfutures\r\npython3 skills/futures/futures.py gzfutures '{\"type\":\"SI0\"}'\r\n```\r\n\r\n### 6. 期货历史查询（/futures/history）\r\n\r\n按交易所、合约代码与日期区间查询历史开高低收、涨跌幅、成交量、持仓量等。\r\n\r\n```bash\r\npython3 skills/futures/futures.py history '{\"market\":\"shfutures\",\"type\":\"SC2703\",\"startdate\":\"2026-06-01\",\"enddate\":\"2026-06-10\"}'\r\n```\r\n\r\n请求 JSON：\r\n\r\n```json\r\n{\r\n \"market\": \"shfutures\",\r\n \"type\": \"SC2703\",\r\n \"startdate\": \"2026-06-01\",\r\n \"enddate\": \"2026-06-10\"\r\n}\r\n```\r\n\r\n| 字段名 | 类型 | 必填 | 说明 |\r\n|-----------|--------|------|----------------------------------------------------------------------|\r\n| market | string | 是 | `shfutures` / `dlfutures` / `zzfutures` / `zgjrfutures` / `gzfutures` |\r\n| type | string | 是 | 期货类型代码，如 `SC2703`、`TA0`、`IF2306` |\r\n| startdate | string | 是 | 开始日期 |\r\n| enddate | string | 是 |"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7ex9mabfb47dvpgkmeypwqj9825yyz\",\n \"slug\": \"futures\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789027710898\n}"},{"path":"skill-card.md","content":"## Description:\n\nQueries real-time and historical futures market data for Shanghai, Dalian, Zhengzhou, China Financial Futures, and Guangzhou futures exchanges using JisuAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[jisuapi](https://clawhub.ai/user/jisuapi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to answer futures price, contract movement, exchange listing, and historical K-line questions for supported Chinese futures exchanges.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends JISU_API_KEY and requested exchange, contract, and date-range parameters to JisuAPI over the network.\n\nMitigation: Install only when JisuAPI is an acceptable data provider, provide the key through the JISU_API_KEY environment variable, and rotate or revoke the key if exposure is suspected.\n\nRisk: Futures responses depend on third-party API availability, permissions, rate limits, and data freshness.\n\nMitigation: Surface returned timestamps and error objects to users, and verify consequential trading or compliance decisions against authoritative market sources.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/jisuapi/skills/futures)\n- [JisuAPI Website](https://www.jisuapi.com/)\n- [JisuAPI Futures API Documentation](https://www.jisuapi.com/api/futures/)\n- [JisuAPI Futures API Endpoint](https://api.jisuapi.com/futures)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires python3 and JISU_API_KEY; returns JSON-formatted futures data or structured error objects.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Skill: 期货查询 - Futures Inquiry Owner: jisuapi Summary: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？SC 原油最近一周走势？或类似期货行情问题时，使用本技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-10T08:08:30.898Z | user - Removed the skill-card.md file. - No changes to logic, usage, or configuration; documentation and core functionality remain the same. v1.0.7 | 2026-06-23T07:58:24.051Z | user **Futures v1.0.7 – 支持期货历史","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":840,"uniquenessScore":55,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T09:38:09.393Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:34:39.928Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}