当用户需要查询 A股和H股相关数据 可通过 FinXData 获取 金融数据 API 时使用本技能,包括股票行情、股票图谱、财务报表、市场新闻、龙虎榜、限售解禁、宏观经济、异动追踪。本技能调用与 FinXData MCP 工具相同的公开 HTTP 接口。下列数据Agent可直接获取:A股股票行情、重点指数行情、股票图谱摘要、股票财报、行情复盘、市场新闻
Data & analysis
FinXData
Try it当用户需要查询 A股和H股相关数据 可通过 FinXData 获取 金融数据 API 时使用本技能,包括股票行情、股票图谱、财务报表、市场新闻、龙虎榜、限售解禁、宏观经济、异动追踪。本技能调用与 FinXData MCP 工具相同的公开 HTTP 接口。下列数据Agent可直接获取:A股股票行情、重点指数行情、股票图谱摘要、股票财报、行情复盘、市场新闻
What it does
当用户需要查询 FinXData 金融数据 API 时使用本技能,包括按代码或名称搜索股票、股票行情、股票图谱、财务报表、市场新闻、龙虎榜、限售解禁、宏观经济、FRED、异动追踪、额度、更新频率、请求限速与重试、API Key 配置、错误处理或服务健康状态。本技能调用与 FinXData MCP 工具相同的公开 HTTP 接口。
The skill document
FinXData
FinXData 用于需要鉴权的金融数据查询。可调用的数据接口与 MCP 工具表面一致,包括 /health、/api/quota/api-key,以及 /api/v1/summary 中列出的当前 GET /api/v1/http/* 接口。
配置
export FINXDATA_API_KEY="sk-..."
export FINXDATA_BASE_URL="https://api.finxdata.ai"
# 仅调用 agent 免费接口时:
export FINXDATA_AGENT_TYPE="openclaw" # 可用 openclaw / hermes / opencode 等 agent 类型
FINXDATA_BASE_URL 是可选项。
如果没有设置 FINXDATA_API_KEY,先提示用户需要登录 www.finxdata.ai 申请免费的 API Key,再继续调用需要鉴权的数据接口。health 和 summary 可在没有 API Key 时调用。
agent 命令不需要 API Key,但必须通过 --agent-type 或 FINXDATA_AGENT_TYPE / AGENT_TYPE 指定来源 agent 类型,例如 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,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 | 市场跟踪快照。 |
agent track-notice | /api/v1/http/agent/track/notice | 另需 --agent-type | 公告跟踪快照。 |
agent economy-china | /api/v1/http/agent/economy/china | type;另需 --agent-type | 中国宏观经济报表。 |
agent economy-calendar | /api/v1/http/agent/economy/calendar | year、month、months;另需 --agent-type | 国内宏观数据发布日历。 |
agent ontology-abstract | /api/v1/http/agent/ontology/abstract | code;另需 --agent-type | 股票图谱摘要,不返回实体和关系明细。 |
agent financial | /api/v1/http/agent/financial | code;另需 --agent-type | 股票业绩报表简版。 |
调用流程
优先使用内置封装脚本:
python3 scripts/finxdata.py summary
python3 scripts/finxdata.py quota
python3 scripts/finxdata.py stock quote --code 600519
python3 scripts/finxdata.py stock financial --code 600519 --sections reports,mainops
python3 scripts/finxdata.py stock ontology --code 600519
python3 scripts/finxdata.py market price --code 000001 BK0477
python3 scripts/finxdata.py agent market-price --code 000001 BK0477 --agent-type openclaw
python3 scripts/finxdata.py agent stock-quote --code 600519 000001 --agent-type openclaw
python3 scripts/finxdata.py agent hot-sectors --agent-type openclaw
python3 scripts/finxdata.py agent hot-sector --name 人形机器人 --agent-type hermes
python3 scripts/finxdata.py agent hot-reason --code 688017 --days 7 --agent-type openclaw
python3 scripts/finxdata.py agent dragon-tiger --trade-date 2026-06-12 --limit 50 --agent-type hermes
python3 scripts/finxdata.py agent track-news --agent-type hermes
python3 scripts/finxdata.py agent track-market --agent-type hermes
python3 scripts/finxdata.py agent track-notice --agent-type hermes
python3 scripts/finxdata.py agent economy-china --type cpi --agent-type opencode
python3 scripts/finxdata.py agent economy-calendar --year 2026 --month 6 --months 1 --agent-type opencode
python3 scripts/finxdata.py agent ontology-abstract --code 600519 --agent-type openclaw
python3 scripts/finxdata.py agent financial --code 300223 --agent-type openclaw
python3 scripts/finxdata.py market hot-stocks --limit 100
封装脚本会输出 API 返回的 JSON;大多数数据接口返回 {"code": 200, "data": ""}。脚本已内置网络重试、超时控制和常见 HTTP 错误的友好提示。
按这个顺序处理用户请求:
- 需要确认接口能力时,先运行
summary,再选择具体命令。 - 需要查询数据时,调用最窄的接口和参数;多股票报价或指数价格优先一次传多个
code。 - 查询失败时,先读脚本返回的
code和message,不要把 curl 或堆栈错误直接抛给用户。 - 返回给普通用户时,优先总结关键字段、日期范围、是否有数据和下一步建议;不要只贴原始 JSON。
参考资料
- 精简接口列表:读取
references/api.md。 - 场景示例、更新节奏、配额处理、示例结果和 FAQ:读取
references/usage.md。
规则
- 普通数据接口需要
X-API-Key;agent免费接口需要x-agent-type,不扣调用额度。 - 不确定某个接口是否可用时,先查询
/api/v1/summary。 - 不描述上游数据源,只描述接口内容、参数、更新时间口径和返回结果。
- 不把金融数据解释成投资建议;需要判断时说明数据来源于接口返回,结论仅供信息整理。
- 如果配额不足,先运行
quota,用daily_remaining、daily_used、daily_max、prepaid_balance、gift_remaining和retry_after_seconds给出可理解的处理建议。 - 对网络、超时、5xx、429 这类暂时性问题,说明脚本已重试;建议稍后重试、缩小查询范围或检查额度/网络。
Related skills
Tonghuashun Financial Data (fuyao.aicubes.cn). Use this skill for ANY Tonghuashun Financial Data request — searching and reading data. Whenever a task involves Tonghuashun Financial Data, use this skill instead of calling the API directly.
Free no-API-key A-share ecosystem data query skill for OpenClaw and Hermes. Use when users ask for A股、沪深京股票、指数、ETF/LOF、可转债、行业/概念板块、实时行情、K线、涨跌排行、涨停/跌停/炸板、资金流、...
Get A-share, Hong Kong, and US stock market data via unified HTTP GET calls to FTShare-market-data endpoints.
使用 FinXData 已开放的 A 股与港股模拟交易能力。适用于用户要求管理 A 股或港股自选股、创建或查询对应市场的模拟账户、提交或查询模拟订单、查看持仓、成交、资金流水、资产与收益、撤单或重置账户的场景。港股模拟交易已完整开放:A 股账户使用人民币和 T+1,港股账户使用港币和 T+0。
通过邮箱验证码安全连接小石公开金融数据,并完成 A股、港股、美股、行情、历史数据、PIT 宏观、新闻事件、财务、因子、回测与量化研究。Use for Xiaoshi account login or onboarding, market and financial-data queries, FRED/ALFRED-style vintages, reports, factors, backtests, and API-driven research. Do not use for trade execution or investment orders.