期货查询 - Futures Inquiry
查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 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 – 支持期货历史
Rank
62
Safety
84
Downloads
3.1k
Updated
Oct 9, 2026
Version
1.0.8
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3.1K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3.1K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.0.8release · observed Sep 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s174fh1b14sn7vkvbqwsdn0xtd83gz5h:futures- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/snapshot"
Documentation
CLAWHUB
44,729 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: "Futures Inquiry - 期货查询"
description: 查询上期所、大商所、郑商所、中金所、广期所期货实时行情及历史 K 线。当用户说:螺纹钢主力什么价?豆粕期货涨了吗?SC 原油最近一周走势?或类似期货行情问题时,使用本技能。
metadata: { "openclaw": { "emoji": "📉", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
---
# 极速数据期货查询(Jisu Futures)
> 数据由 **[极速数据(JisuAPI)](https://www.jisuapi.com/)** 提供 — 提供上海、大连、郑州、中金、广州等交易所期货价格查询。
## 何时使用本技能
- **期货价格**、**主力合约**、**某品种涨跌**(如螺纹钢、豆粕、PTA、工业硅、IF 股指)
- **五大交易所**行情:上期所、大商所、郑商所、中金所、广期所
- **历史走势**:指定合约在某段时间的开高低收、成交量、持仓量
**技术前提:** 脚本 **`skills/futures/futures.py`**,环境变量 **`JISU_API_KEY`**。
**接口与数据范围:**
- **上海期货交易所**(`/futures/shfutures`)
- **大连商品交易所**(`/futures/dlfutures`)
- **郑州商品交易所**(`/futures/zzfutures`)
- **中国金融期货交易所**(`/futures/zgjrfutures`)
- **广州期货交易所**(`/futures/gzfutures`)
- **期货历史查询**(`/futures/history`)
各交易所实时接口返回:品种代号、名称、最新价、涨跌幅、涨跌量、最高/最低价、开盘价、昨收盘价、成交量、持仓量、买卖价量、更新时间等。
## 前置配置:获取 API Key
1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号
2. 进入 [期货查询 API](https://www.jisuapi.com/api/futures/) 页面,点击「申请数据」
3. 在会员中心获取 **AppKey**
4. 配置 Key:
```bash
# 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)
```bash
python3 skills/futures/futures.py shfutures
# 指定品种(可选 type)
python3 skills/futures/futures.py shfutures '{"type":"FU2309"}'
```
### 2. 大连商品交易所(/futures/dlfutures)
```bash
python3 skills/futures/futures.py dlfutures
python3 skills/futures/futures.py dlfutures '{"type":"V0"}'
```
### 3. 郑州商品交易所(/futures/zzfutures)
```bash
python3 skills/futures/futures.py zzfutures
python3 skills/futures/futures.py zzfutures '{"type":"TA0"}'
```
### 4. 中国金融期货交易所(/futures/zgjrfutures)
```bash
python3 skills/futures/futures.py zgjrfutures
python3 skills/futures/futures.py zgjrfutures '{"type":"IF2306"}'
```
### 5. 广州期货交易所(/futures/gzfutures)
```bash
python3 skills/futures/futures.py gzfutures
python3 skills/futures/futures.py gzfutures '{"type":"SI0"}'
```
### 6. 期货历史查询(/futures/history)
按交易所、合约代码与日期区间查询历史开高低收、涨跌幅、成交量、持仓量等。
```bash
python3 skills/futures/futures.py history '{"market":"shfutures","type":"SC2703","startdate":"2026-06-01","enddate":"2026-06-10"}'
```
请求 JSON:
```json
{
"market": "shfutures",
"type": "SC2703",
"startdate": "2026-06-01",
"enddate": "2026-06-10"
}
```
| 字段名 | 类型 | 必填 | 说明 |
|-----------|--------|------|----------------------------------------------------------------------|
| market | string | 是 | `shfutures` / `dlfutures` / `zzfutures` / `zgjrfutures` / `gzfutures` |
| type | string | 是 | 期货类型代码,如 `SC2703`、`TA0`、`IF2306` |
| startdate | string | 是 | 开始日期 |
| enddate | string | 是 |_meta.json
{
"ownerId": "kn7ex9mabfb47dvpgkmeypwqj9825yyz",
"slug": "futures",
"version": "1.0.8",
"publishedAt": 1789027710898
}skill-card.md
## Description: Queries real-time and historical futures market data for Shanghai, Dalian, Zhengzhou, China Financial Futures, and Guangzhou futures exchanges using JisuAPI. This skill is ready for commercial/non-commercial use. ## Publisher: [jisuapi](https://clawhub.ai/user/jisuapi) ### License/Terms of Use: MIT-0 ## Use Case: External users and agents use this skill to answer futures price, contract movement, exchange listing, and historical K-line questions for supported Chinese futures exchanges. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill sends JISU_API_KEY and requested exchange, contract, and date-range parameters to JisuAPI over the network. Mitigation: 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. Risk: Futures responses depend on third-party API availability, permissions, rate limits, and data freshness. Mitigation: Surface returned timestamps and error objects to users, and verify consequential trading or compliance decisions against authoritative market sources. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/jisuapi/skills/futures) - [JisuAPI Website](https://www.jisuapi.com/) - [JisuAPI Futures API Documentation](https://www.jisuapi.com/api/futures/) - [JisuAPI Futures API Endpoint](https://api.jisuapi.com/futures) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with shell commands and JSON examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires python3 and JISU_API_KEY; returns JSON-formatted futures data or structured error objects.] ## Skill Version(s): 1.0.8 (source: server release metadata) ## Ethical Considerations: Users 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.
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/jisuapi/skills/futures",
"sourceUrl": "https://clawhub.ai/jisuapi/skills/futures",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T09:38:09.393Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T09:38:09.393Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3.1K downloads",
"href": "https://clawhub.ai/jisuapi/futures",
"sourceUrl": "https://clawhub.ai/jisuapi/futures",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T09:38:09.393Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.8",
"href": "https://clawhub.ai/jisuapi/futures",
"sourceUrl": "https://clawhub.ai/jisuapi/futures",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T08:08:30.898Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-futures/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.8",
"description": "- Removed the skill-card.md file. - No changes to logic, usage, or configuration; documentation and core functionality remain the same.",
"href": "https://clawhub.ai/jisuapi/futures",
"sourceUrl": "https://clawhub.ai/jisuapi/futures",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T08:08:30.898Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
