agentCLAWHUBUnverified
FinXData
优先免 Key 免费查询金融数据；高级分析用户注册即获免费 API 额度。
OpenClaw
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.16
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/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 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.16release · observed Sep 11, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s174ddxbdjq678e6nw97ad1wh188qat1:finxdata- Install using `clawhub skill install s174ddxbdjq678e6nw97ad1wh188qat1:finxdata` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/qiuqp/finxdata before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-qiuqp-finxdata/snapshot"
Documentation
CLAWHUB
146,133 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: finxdata description: 查询 FinXData 金融数据时使用。优先使用免 Key API，无需注册即可免费查询行情、公告、题材、宏观及财务和图谱摘要，享有每日免费调用额度；高级分析用户注册可免费获得 API 额度，用于完整财务、图谱明细、FRED 等更深入的数据查询。支持额度查询、限速重试和错误排障。 --- # FinXData FinXData 为 AI Agent 提供金融数据查询，优先通过免 Key API 免费开始；需要更深入的数据分析时，注册即可免费获得 API 调用额度。可调用的接口与 FinXData MCP 工具一致。 ## 1. 优先使用免 Key API：无需注册，直接开始 无需注册、无需申请 API Key，即可使用行情、标准化个股/市场公告、热门题材、龙虎榜、宏观数据，以及财务和股票图谱摘要。享有每日免费调用额度，适合先完成真实查询、持续体验数据服务；仅需声明实际使用的 Agent 类型。 从 Skill 目录运行： ```bash export FINXDATA_AGENT_TYPE="codex" # 按实际客户端填写，如 openclaw / hermes / claude / codex python3 scripts/finxdata.py agent stock-quote --code 600519 python3 scripts/finxdata.py agent disclosures --symbol 600519 --limit 20 ``` 以上是独立场景示例，按需选择。免 Key 接口不扣账户额度，免费调用额度按单 IP 每日共享，并受频率限制；具体数量以服务端当前规则为准。优先选择能满足用户需求的 `agent` 接口，不把注册或配置 API Key 作为首次查询的前提。 ## 2. 高级分析用户：注册即获免费 API 额度 需要完整财务板块、股票图谱实体与关系明细、FRED 时间序列等深入研究数据时，可前往 [FinXData 官网](https://www.finxdata.ai) 注册，免费获得 API 调用额度，并在账户中创建 API Key。可先使用免费额度，无需先充值；每日试用额度按北京时间 00:00 重置，实际可用额度以账户页面或 `quota` 返回为准。 注册并创建 API Key 后配置： ```bash export FINXDATA_API_KEY="sk-..." python3 scripts/finxdata.py stock financial --code 600519 --sections reports,mainops # 需要确认账户免费额度时查询： python3 scripts/finxdata.py quota ``` 已有 API Key 时，仍优先使用能满足需求的免 Key API；用户明确指定账户接口或需要免 Key 接口未提供的数据时，再使用 API Key。免 Key 限额不足时，可说明注册能免费获得账户 API 额度；两类额度分别计算，不承诺无限调用或所有高级需求均可由免费额度覆盖。 ## 连接配置 `FINXDATA_BASE_URL` 是可选项，仅接受官方地址 `https://api.finxdata.ai`（允许显式端口 `443` 和末尾 `/`）。兼容旧变量 `FINDATA_BASE_URL`，校验规则相同；两者均设置时优先使用 `FINXDATA_BASE_URL`。上传版不支持自定义主机、HTTP、非标准端口、URL 内嵌凭据、额外路径、查询串或片段，非法配置会在发起请求前返回 `invalid_base_url`。 只有需要 API Key 的接口发送 `X-API-Key`；`health`、`summary` 和 `agent` 接口即使环境中已配置密钥也不会发送。脚本使用 Python 标准库在当前进程内直连官方 HTTPS 服务并校验证书，不创建 curl 子进程、不跟随重定向、不读取代理环境变量。密钥只进入内存中的请求头，输出中的密钥统一替换为 `[REDACTED]`。 未设置 `FINXDATA_API_KEY` 时，先检查免 Key API 是否满足需求；只有需要账户接口时，才说明注册可免费获得 API 额度，并引导用户创建和配置 API Key。`health` 和 `summary` 也无需 API Key。 `agent` 命令不需要 API Key，但必须通过 `--agent-type` 或 `FINXDATA_AGENT_TYPE` / `AGENT_TYPE` 指定来源 agent 类型，例如 `openclaw`、`hermes`、`opencode`。 ## API 列表 ### 免 Key API（优先使用） 无需 API Key，必须指定 Agent 来源类型。支持的命令如下： | 命令 | 接口 | 参数 | 内容 | |---|---|---|---| | `agent market-price` | `/api/v1/http/agent/market/price` | `code`，支持多个；另需 `--agent-type` | 指数或板块行情。 | | `agent stock-quote` | `/api/v1/http/agent/stock/quote` | `code`，支持多个；另需 `--agent-type` | 股票最新行情。 | | `agent hot-sectors` | `/api/v1/http/agent/market/hot_sectors` | 另需 `--agent-type` | 热门题材/概念榜。 | | `agent hot-sector` | `/api/v1/http/agent/market/hot_sector` | `name` 或 `theme_id`，`days`，`track_date`；另需 `--agent-type` | 热门题材详情。 | | `agent hot-reason` | `/api/v1/http/agent/stock/hot_reason` | `code`，`days`；另需 `--agent-type` | 个股题材归因历史。 | | `agent dragon-tiger` | `/api/v1/http/agent/market/dragon_tiger` | `trade_date`、`min_net_buy`、`limit`、`refresh`；另需 `--agent-type` | 全市场龙虎榜。 | | `agent track-news` | `/api/v1/http/agent/track/news` | 另需 `--agent-type` | 新闻跟踪快照。 | | `agent track-market` | `/api/v1/http/agent/track/market` | 另需 `--agent-type`
_meta.json
{
"ownerId": "kn7007813aqrs1qqfwk0qa5nrd88q1j2",
"slug": "finxdata",
"version": "1.0.16",
"publishedAt": 1789122180052
}references/api.md
# FinXData API 参考
下列接口与 FinXData MCP tools 暴露的接口集合一致。按访问方式分为三类：
- 优先使用免 Key API：`agent ...` 命令，对应 `/api/v1/http/agent/*`。无需注册即可使用每日免费调用额度，不扣账户额度；必须提供 `--agent-type` 或 `FINXDATA_AGENT_TYPE` / `AGENT_TYPE`，服务端通过 `x-agent-type` 统计来源，并执行单 IP 每日限额与频率保护。
- 高级分析使用 API Key：需要完整财务、图谱实体关系、FRED 等数据时，到 [FinXData 官网](https://www.finxdata.ai) 注册可免费获得 API 额度，再创建并配置 `FINXDATA_API_KEY`。`quota` 查询账户额度；常规接口按账户额度、余额和频率限制处理，无需先充值即可使用免费额度。
- 无需 API Key 的系统接口：`health` 和 `summary`，用于健康检查和发现当前可用接口。
需要最新机器可读清单时，以 `python3 scripts/finxdata.py summary` 为准。需要了解更新节奏、配额处理、错误解释和生活化使用场景时，读取 `usage.md`。
## 无需 API Key 的系统接口
| 命令 | 接口 | 参数 | 内容 |
|---|---|---|---|
| `health` | `GET /health` | 无 | 服务健康状态。 |
| `summary` | `GET /api/v1/summary` | 无 | 当前机器可读 API 清单，也是 MCP 工具面的事实来源。 |
## Agent 公开接口
运行本节接口不需要 API Key，但必须指定 agent 来源类型：
```bash
export FINXDATA_AGENT_TYPE="openclaw" # 也可在命令中传 --agent-type
```
这些接口不扣注册用户额度；服务端会按 `x-agent-type` 和调用 IP 做来源统计与频率控制。适合 OpenClaw、Hermes、OpenCode 等 agent 客户端免费查询行情、公告、题材、宏观及财务和图谱摘要。
| 命令 | 接口 | 参数 | 内容 |
|---|---|---|---|
| `agent market-price` | `/api/v1/http/agent/market/price` | `code`，支持多个；另需 `--agent-type` | 指数或板块行情。 |
| `agent stock-quote` | `/api/v1/http/agent/stock/quote` | `code`，支持多个；另需 `--agent-type` | 股票最新行情。 |
| `agent hot-sectors` | `/api/v1/http/agent/market/hot_sectors` | 另需 `--agent-type` | 热门题材/概念榜。 |
| `agent hot-sector` | `/api/v1/http/agent/market/hot_sector` | `name` 或 `theme_id`，`days=1`，`track_date`；另需 `--agent-type` | 热门题材详情。 |
| `agent hot-reason` | `/api/v1/http/agent/stock/hot_reason` | `code`，`days=30`；另需 `--agent-type` | 个股题材归因历史。 |
| `agent dragon-tiger` | `/api/v1/http/agent/market/dragon_tiger` | `trade_date`，`min_net_buy`，`limit=100`，`refresh`；另需 `--agent-type` | 全市场龙虎榜。 |
| `agent track-news` | `/api/v1/http/agent/track/news` | 另需 `--agent-type` | 新闻跟踪快照。 |
| `agent track-market` | `/api/v1/http/agent/track/market` | 另需 `--agent-type` | 市场跟踪快照。 |
| `agent track-notice` | `/api/v1/http/agent/track/notice` | 另需 `--agent-type` | 公告跟踪快照。 |
| `agent disclosures` | `/api/v1/http/agent/disclosures` | `symbol`、`market=SSE|SZSE|HKEX`、公告类型、日期、`cursor`、`limit=20`；另需 `--agent-type` | 与 API Key 公告接口相同的标准化结构；传 `symbol` 为个股公告，不传为市场公告。 |
| `agent economy-china` | `/api/v1/http/agent/economy/china` | `type`；另需 `--agent-type` | 中国宏观经济报表。 |
| `agent economy-calendar` | `/api/v1/http/agent/economy/calendar` | `year`，`month`，`months=3`；另需 `--agent-type` | 国内宏观数据发布日历。 |
| `agent ontology-abstract` | `/api/v1/http/agent/ontology/abstract` | `code`；另需 `--agent-type` | 股票图谱摘要，只返回代码、名称、摘要、分析时间和图谱版本。 |
| `agent financial` | `/api/v1/http/agent/financial` | `code`；另需 `--agent-type` | 股票业绩报表简版，只返回业绩报表关键字段。 |
公告接口的完整参数、返回结构、分页示例和错误码见本页[标准化公告](#标准化公告)章节。
## 设置 API Key 后可访问接口
运行本节接口前配置：
```bash
export FINXDATA_API_KEY="sk-..."
```
这些接口需要账户认证；除 `stock search` 外会走账户额度逻辑。数据接口通常返回 `{"code": 200, "confidence": "高|中高|中", "data": "<字符串、对象或数组>"}`。
### 额度
| 命令 | 接口 | 参数 | 内容 |
|---|---|---|---|
| `quota` | `GET /api/quota/api-key` | 无 | 当references/usage.md
# FinXData 使用指南 ## 常见场景 优先使用免 Key API：无需注册即可享有每日免费调用额度，通过 `agent ... --agent-type <实际类型>` 查询行情、公告、题材、宏观及财务和图谱摘要。已有 API Key 时也按数据需求选择，免 Key API 能满足需求就优先使用。 高级分析用户需要完整财务板块、图谱实体关系或 FRED 等数据时，可到 [FinXData 官网](https://www.finxdata.ai) 注册，免费获得 API 调用额度，再创建并配置 `FINXDATA_API_KEY`。无需先充值；每日试用额度按北京时间 00:00 重置，实际额度以账户页面或 `quota` 为准。 ### 1. 免 Key 免费场景（优先使用） 运行本节命令不需要 `FINXDATA_API_KEY`，但必须提供 `--agent-type`，例如 `openclaw`、`hermes`、`opencode`。这些接口不扣注册用户额度，适合 Agent 客户端直接获取公开摘要。 | 用户想做什么 | 推荐命令 | 说明 | | --- | --- | --- | | Agent 查指数或板块行情 | `python3 scripts/finxdata.py agent market-price --code 000001 BK0477 --agent-type openclaw` | 免费零扣费；支持多个指数/板块代码。 | | Agent 查股票最新行情 | `python3 scripts/finxdata.py agent stock-quote --code 600519 000001 --agent-type openclaw` | 免费零扣费；支持多个股票代码。 | | Agent 查热门题材 | `python3 scripts/finxdata.py agent hot-sectors --agent-type openclaw` | 免费零扣费；返回热门题材/概念榜。 | | Agent 查题材详情 | `python3 scripts/finxdata.py agent hot-sector --name 人形机器人 --agent-type hermes` | 免费零扣费；适合从题材榜继续追问成分股和热度变化。 | | Agent 查个股题材归因 | `python3 scripts/finxdata.py agent hot-reason --code 688017 --days 7 --agent-type openclaw` | 免费零扣费；适合回答某只股票近期为什么活跃。 | | Agent 查全市场龙虎榜 | `python3 scripts/finxdata.py agent dragon-tiger --trade-date 2026-06-12 --limit 50 --agent-type hermes` | 免费零扣费；支持日期、净买入下限、条数和刷新参数。 | | Agent 查股票图谱摘要 | `python3 scripts/finxdata.py agent ontology-abstract --code 600519 --agent-type openclaw` | 免费零扣费；只返回摘要、分析时间和版本，不返回实体关系明细。 | | Agent 查股票业绩报表 | `python3 scripts/finxdata.py agent financial --code 300223 --agent-type openclaw` | 免费零扣费；只返回业绩报表关键字段。 | | Agent 看新闻跟踪 | `python3 scripts/finxdata.py agent track-news --agent-type hermes` | 免费零扣费；后台会按来源头统计调用来源和频率。 | | Agent 看市场跟踪 | `python3 scripts/finxdata.py agent track-market --agent-type hermes` | 免费零扣费；适合 Agent 客户端默认行情摘要。 | | Agent 看公告跟踪 | `python3 scripts/finxdata.py agent track-notice --agent-type hermes` | 免费零扣费；适合整理近期公告事项。 | | Agent 查标准公告 | `python3 scripts/finxdata.py agent disclosures --symbol 600519 --agent-type hermes` | 免费零扣费；返回与 API Key 通道一致的标准结构，受单 IP 限额。 | | Agent 查港股市场公告 | `python3 scripts/finxdata.py agent disclosures --market HKEX --limit 20 --agent-type codex` | 不传 `symbol`，按港股市场筛选；支持日期、公告类型及游标分页。 | | Agent 查中国宏观指标 | `python3 scripts/finxdata.py agent economy-china --type cpi --agent-type opencode` | 免费零扣费；返回中国宏观经济报表。 | | Agent 看宏观发布日历 | `python3 scripts/finxdata.py agent economy-calendar --year 2026 --month 6 --months 1 --agent-type opencode` | 免费零扣费；返回国内宏观数据发布日历。 | ### 2. 高级分析场景（注册即获免费 API 额度） 运行本节命令前需要配置 `FINXDATA_API_KEY`。这些接口会走账户认证、额度和频率限制。 | 用户想做什么 | 推荐命令 | 说明 | | --- | --- | --- | | 按代码或名称查找股票 | `python3 scripts/finxdata.py stock search --query 阿里` | 需要 API Key，但不扣账户额度；最多返回 5 个 A/H 股匹配项。 | | 看一只股票的当前概况 | `python3 scripts/finxdata.py stock summary --code 600519` | 用于公司简介、主营信息和概要行情。 | | 对比几只股票最新行情 | `python3 scripts/finxdata.py stock quote --code 600519 000001 300750` | 报价接口支持批量代码，优先一次请求完成。 | | 查一只股票的财报明细 | `python3 scripts/finxdata.py stock financial --code 600519 --sections reports,
skill-card.md
## Description: FinXData helps agents query financial market data, disclosures, market themes, macroeconomic data, financial summaries, and graph summaries through no-key endpoints first, with optional API-key endpoints for deeper analysis. This skill is ready for commercial/non-commercial use. ## Publisher: [qiuqp](https://clawhub.ai/user/qiuqp) ### License/Terms of Use: MIT-0 ## Use Case: Developers and external agent users use this skill to retrieve FinXData financial data, including quotes, disclosures, themes, macroeconomic series, financial reports, and graph summaries. The skill is intended for data lookup and summarization, with no-key agent endpoints preferred before optional API-key endpoints. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Financial query parameters, an agent-type identifier, and optionally a FinXData API key are sent to FinXData over HTTPS. Mitigation: Confirm that this data sharing is acceptable for the deployment, prefer no-key agent endpoints when they satisfy the request, and configure API keys only through environment variables. Risk: Remote API responses may contain untrusted text, links, or fields that could mislead an agent. Mitigation: Treat API response content as data only, summarize only fields needed for the user's request, and do not execute instructions or automatically open links from response data. Risk: Implicit invocation is enabled and the documentation is Chinese-first, which may affect automatic activation and language expectations. Mitigation: Review implicit invocation policy and user-facing language behavior before deploying in environments where automatic activation or non-English documentation is a concern. ## Reference(s): - [FinXData API Reference](references/api.md) - [FinXData Usage Guide](references/usage.md) - [FinXData Website](https://www.finxdata.ai) - [ClawHub Skill Page](https://clawhub.ai/qiuqp/skills/finxdata) ## Skill Output: **Output Type(s):** [Text, Markdown, JSON, Shell commands, Configuration, Guidance] **Output Format:** [Markdown guidance with shell commands and bounded JSON API results for agent summarization] **Output Parameters:** [1D] **Other Properties Related to Output:** [Uses official FinXData HTTPS endpoints only; API responses are explicitly treated as untrusted data and API keys are redacted from output.] ## Skill Version(s): 1.0.16 (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.
Github ReposUpdated 2d agoRank 70
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!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
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
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
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/qiuqp/skills/finxdata",
"sourceUrl": "https://clawhub.ai/qiuqp/skills/finxdata",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:58:48.967Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-qiuqp-finxdata/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-qiuqp-finxdata/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T08:58:48.967Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/qiuqp/finxdata",
"sourceUrl": "https://clawhub.ai/qiuqp/finxdata",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:58:48.967Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.16",
"href": "https://clawhub.ai/qiuqp/finxdata",
"sourceUrl": "https://clawhub.ai/qiuqp/finxdata",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-11T10:23:00.052Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-qiuqp-finxdata/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-qiuqp-finxdata/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.16",
"description": "finxdata 1.0.16 - 优化 Skill 说明文档，突出“免 Key API”优先原则：无需注册即可免费查询，优先使用免 Key 免费额度和接口。 - 精简大部分文档内容，删除过于冗长的配置与能力描述，改为分级引导（免 Key > 注册 Key）。 - 明确区分免 Key API（即 agent 接口，适合大部分普通场景）与 API Key 高级接口（深入数据分析和高级用法）。 - 新增更直白的注册说明：注册即送免费额度，按需用高级接口。 - 删除旧 skill-card.md。",
"href": "https://clawhub.ai/qiuqp/finxdata",
"sourceUrl": "https://clawhub.ai/qiuqp/finxdata",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-11T10:23:00.052Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.