关于 finhay-market
通过 Finhay Securities Open API 获取只读市场数据的技能。它使用签名 GET 请求查询行情、财务指标、报告和历史价格,并遵循各端点的参数规则。
主要功能
- 01实时股票行情
- 02公司事件新闻
- 03黄金、白银与加密货币数据
- 04宏观和银行利率指标
- 05公司财务数据与报表
- 06历史价格图表
适用场景
- 01查询个股或交易所行情
- 02查看贵金属与宏观数据
- 03研究公司财务和分析师报告
- 04获取历史 OHLCV 价格
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ finhay-pro/ finhay-skills-hub --skill finhay-market安装后在 Claude Code 中输入/finhay-market确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.version_shared/.versionauthentication.mdconstraints.mdpreflight.md_shared/scripts/infer-sub-account.ps1infer-sub-account.shrequest.ps1request.shsync.ps1sync.shreferences/endpoints.mdreferences/endpoints/bank-interest-rates.mdcompany-financial-analysis.mdcompany-financial-overview.mdcryptos-top-trending.mdfinancial-data.mdfinancial-statement.mdgold-chart.mdgold-providers.mdgold.mdmacro.mdmetal-providers.mdnews.mdprice-histories-chart.mdrecommendation-reports.mdsilver-chart.mdsilver.mdstock-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/macro | CPI、PMI、利率… | — | type、country、period |
/market/recommendation-reports/:symbol | 分析师报告 | :symbol | — |
/market/price-histories-chart | OHLCV 价格历史记录 | — | 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