mcpField
F
finhay-market

finhay-market

github.com/finhay-pro其他41 次安装
代码仓库

关于 finhay-market

通过 Finhay Securities Open API 获取只读市场数据的技能。它使用签名 GET 请求查询行情、财务指标、报告和历史价格,并遵循各端点的参数规则。

主要功能

  1. 01实时股票行情
  2. 02公司事件新闻
  3. 03黄金、白银与加密货币数据
  4. 04宏观和银行利率指标
  5. 05公司财务数据与报表
  6. 06历史价格图表

适用场景

  1. 01查询个股或交易所行情
  2. 02查看贵金属与宏观数据
  3. 03研究公司财务和分析师报告
  4. 04获取历史 OHLCV 价格

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/finhay-pro/finhay-skills-hub --skill finhay-market

安装后在 Claude Code 中输入/finhay-market确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.version
_shared/
.version
authentication.md
constraints.md
preflight.md
_shared/scripts/
infer-sub-account.ps1
infer-sub-account.sh
request.ps1
request.sh
sync.ps1
sync.sh
references/
endpoints.md
references/endpoints/
bank-interest-rates.md
company-financial-analysis.md
company-financial-overview.md
cryptos-top-trending.md
financial-data.md
financial-statement.md
gold-chart.md
gold-providers.md
gold.md
macro.md
metal-providers.md
news.md
price-histories-chart.md
recommendation-reports.md
silver-chart.md
silver.md
stock-realtime.md

详细介绍

Finhay Market

通过 Finhay Securities Open API 只读获取市场数据。所有请求均为签名的 GET。

MANDATORY:执行任何操作前,请阅读并完成 预检。必需项:FINHAY_API_KEY、FINHAY_API_SECRET。市场端点不需要 USER_ID。请勿跳过或延后。

发起请求

每次调用都使用 request.sh。

./_shared/scripts/request.sh GET /market/stock-realtime "symbol=VNM"
./_shared/scripts/request.sh GET /market/stock-realtime "symbols=VNM,VIC,HPG"
./_shared/scripts/request.sh GET /market/stock-realtime "exchange=HOSE"
./_shared/scripts/request.sh GET /market/financial-data/gold
./_shared/scripts/request.sh GET /market/price-histories-chart "symbol=VNM&resolution=1D&from=1609459200&to=1704067200"
./_shared/scripts/request.sh GET /market/financial-data/macro "type=CPI&country=VN&period=YEARLY"

端点

端点使用场景路径参数查询参数
/market/stock-realtime股票价格、实时报价—以下参数必须且只能选择一个:symbol、symbols、exchange
/market/news公司事件:分红、配股、股东大会日期—stock、stocks、from_date、to_date(均为可选项,日期格式为 DD/MM/YYYY;默认范围:最近 1 年)
/market/financial-data/gold、silver黄金/白银现货价格——
/market/financial-data/gold-chart、silver-chart黄金/白银价格图表—days(默认值为 30)
/market/financial-data/gold-providers、metal-providers按提供商查询价格(PNJ、DOJI…)——
/market/financial-data/bank-interest-rates银行存款利率——
/market/financial-data/cryptos/top-trending热门加密货币——
/market/financial-data/macroCPI、PMI、利率…—type、country、period
/market/recommendation-reports/:symbol分析师报告:symbol—
/market/price-histories-chartOHLCV 价格历史记录—symbol、resolution(1D、5、15、30、1H、4H,默认值为 1D)、from、to(秒)
/market/company-financial/overview关键比率:PE、PB、ROE、EPS、股息收益率—symbol
/market/company-financial/analysis按周期划分的历史财务指标—symbol、period(annual/quarterly)
/market/v2/financial-statement/statement损益表/资产负债表/现金流量表,指标-数值行格式—symbol、type、period、limit
参数规则
  • 每个端点仅接受上方路径参数和查询参数列出的参数。请勿添加额外参数。
  • URL 中所有 :variables 都是路径变量——请将其替换到 URL 中,切勿将其作为查询参数传递。

详情和响应结构:references/endpoints.md。

限制

请参阅共享限制,以及:

  • 股票实时行情——必须且只能传入 symbol、symbols 或 exchange 中的一个。切勿组合使用。
  • 价格历史记录——from 和 to 是以秒为单位的 Unix 时间戳,不是毫秒。如果数值超过 9,999,999,999,请停止并要求用户转换。resolution 必须是 1D、5、15、30、1H 或 4H 之一;未提供时默认为 1D。未提供时,to 默认为当前时间,from 默认为 5 年前。

评论

支持 Markdown