Data & analysis

FinXData

Try it

直接询问股价、公告、热门题材或龙虎榜;优先免 Key 免费查询金融数据。

What it does

FinXData 用于需要鉴权的金融数据查询。可调用的数据接口与 MCP 工具表面一致,包括 、,以及 中列出的当前 接口。

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/pricecode,支持多个;另需 --agent-type指数或板块行情。
agent stock-quote/api/v1/http/agent/stock/quotecode,支持多个;另需 --agent-type股票最新行情。
agent hot-sectors/api/v1/http/agent/market/hot_sectors另需 --agent-type热门题材/概念榜。
agent hot-sector/api/v1/http/agent/market/hot_sectorname 或 theme_id,days,track_date;另需 --agent-type热门题材详情。
agent hot-reason/api/v1/http/agent/stock/hot_reasoncode,days;另需 --agent-type个股题材归因历史。
agent dragon-tiger/api/v1/http/agent/market/dragon_tigertrade_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/chinatype;另需 --agent-type中国宏观经济报表。
agent economy-calendar/api/v1/http/agent/economy/calendaryear、month、months;另需 --agent-type国内宏观数据发布日历。
agent ontology-abstract/api/v1/http/agent/ontology/abstractcode;另需 --agent-type股票图谱摘要,不返回实体和关系明细。
agent financial/api/v1/http/agent/financialcode;另需 --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 错误的友好提示。

按这个顺序处理用户请求:

  1. 需要确认接口能力时,先运行 summary,再选择具体命令。
  2. 需要查询数据时,调用最窄的接口和参数;多股票报价或指数价格优先一次传多个 code。
  3. 查询失败时,先读脚本返回的 code 和 message,不要把 curl 或堆栈错误直接抛给用户。
  4. 返回给普通用户时,优先总结关键字段、日期范围、是否有数据和下一步建议;不要只贴原始 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

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván561 installs18 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván538 installs31 stars

More from qiuqp

Browse all skills

A股游资情绪周期量化研判系统。基于涨停/连板/炸板率/溢价/成交额/跌停/市场宽度等7维指标计算情绪得分,精准判定5阶段(冰点/低温/回暖/高潮/过热),自动识别周期转折点,输出结构化研判报告。

by qiuqp5 installs

This skill should be used when the user asks to "analyze a stock", "research a company", "give me a research report on [ticker]", "run stock analysis on [com...

by qiuqp4 installs