finhay-market

Finhay Market

通过 Finhay Securities Open API 获取只读市场数据。

MANDATORY：确保已设置凭据（通过环境变量 FINHAY_API_KEY/FINHAY_API_SECRET 或通过 ./finhay.sh auth）。运行 ./finhay.sh doctor 进行验证。

使用示例

# Get real-time stock quote
./finhay.sh request GET /market/stock-realtime "symbol=VNM"

# Get gold spot price
./finhay.sh request GET /market/financial-data/gold

# Get historical OHLCV chart data
./finhay.sh request GET /market/price-histories-chart "symbol=VNM&resolution=1D&from=1609459200&to=1704067200"

CLI 命令参考

命令	描述
auth	交互式配置 API 凭据
doctor	验证系统依赖项和设置状态
request	执行签名 API 请求
sync	根据源更新本地技能定义

Agent 标识

REQUIRED：发送任何请求前，请先导出 AGENT_NAME。使用工具的规范小写标识符，并采用 kebab-case 格式（例如 claude-code）。只要能始终如一地标识你的工具，任何值均可接受。

export AGENT_NAME=claude-code
./finhay.sh request GET /market/stock-realtime "symbol=VNM"

该值会作为 X-FH-OPENAPI-AGENT 发送，并嵌入 User-Agent 中。

端点

端点	描述	参数
/market/stock-realtime	股票报价：获取股票代码或交易所的实时价格。	symbol、symbols 或 exchange
/market/index-realtime	市场指数：获取指数实时值（VNINDEX、VN30、HNX30……）。	index（逗号分隔）
/market/news	市场新闻：公司事件、股息和 AGM 日期。	stock、from_date、to_date
/market/financial-data/gold	黄金价格：SJC 和全球黄金现货价格的实时数据。	—
/market/financial-data/silver	白银价格：白银现货价格的实时数据。	—
/market/financial-data/gold-chart	黄金图表：过去 N 天的黄金价格历史数据。	days
/market/financial-data/silver-chart	白银图表：过去 N 天的白银价格历史数据。	days
/market/financial-data/gold-providers	按提供商查询黄金价格：PNJ、DOJI、SJC 等提供的黄金价格。	—
/market/financial-data/metal-providers	按提供商查询金属价格：各提供商提供的白银及其他金属价格。	—
/market/financial-data/bank-interest-rates	利率：当前银行存款利率。	—
/market/financial-data/cryptos/top-trending	加密货币趋势：热门加密货币列表。	—
/market/financial-data/macro	宏观指标：CPI、PMI 和国家利率。	type、country（VN、US；仅当 type 为 GOVERNMENT_10Y_BOND_YIELD 时支持 JP、DE）、period
/market/financial-data/trading-economics	Trading Economics：按国家和类别查询历史经济指标。	country（必填：China、Euro Area、Japan、United States、United Kingdom、Vietnam）、category（GDP、Labour、Prices、Money、Trade、Government、Business、Consumer、Housing）、year
/market/financial-data/global-news	全球新闻：按类别筛选的分页全球财经新闻。	category（forex、commodities、economic-indicators、stock-market、cryptocurrency）、page、page_size（最大 50）
/market/financial-data/global-news/:id	全球新闻详情：按 ID 获取完整文章内容。	:id（路径参数，必填）
/market/financial-data/economic-calendar-events	经济日历：中国／欧盟／日本／美国／英国／越南即将发生的事件（CPI、美联储会议）。	weeks（默认值为 1）、country（例如 China、Vietnam、United States）
/market/financial-data/market	全球指数：全球指数、Mag7 股票、大宗商品和外汇的历史价格——返回按降序排列的 [{date, value}]。	type（SP500、NASDAQ、APPLE、GOLD、EURUSD……）、limit（默认值为 50，最大 500）
/fund-trading/public/fund-certificates	基金列表：可用基金，按 1 年收益排序。	fund-type*（STOCK_FUND|BOND_FUND|BALANCE_FUND）、fund-company-id
/fund-trading/public/fund-companies	基金公司：管理公司列表。	—
/fund-trading/public/fund-certificates/benchmark/growth	增长模拟：预测 VND 投资的回报。	fund-names（CSV）、amount（VND）、period*
/fund-trading/public/fund-certificates/benchmark/nav	NAV 对比：多个基金的 NAV 时间序列。	fund-names*、period 或（from-month+to-month，格式为 yyyy-MM）
/fund-trading/public/fund-certificates/:fund/nav-histories	NAV 历史记录：与基准对比的价格图表。	period（默认值为 ALL_TIME）
/fund-trading/public/fund-certificates/:fund/suggestions	相似基金：按条件提供建议。	—
/market/recommendation-reports/:symbol	分析师报告：专业的股票推荐报告。	:symbol（路径参数）
/market/price-histories-chart	历史数据：OHLCV 数据。	symbol、resolution（1D、1H、4H、30、15、5）、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（income-statement、balance-sheet、cash-flow）、period（annual、quarterly）

约束

• 只读：仅执行 GET 请求。
• 隐私：在所有输出中屏蔽敏感凭据。
• 凭据：如果缺少 FINHAY_API_KEY 或 FINHAY_API_SECRET，请停止并要求用户提供，或运行 ./finhay.sh auth。
• 参数：查询股票报价时，必须且只能传入一个标识符（symbol、symbols 或 exchange）。
• 时间范围：价格历史记录的时间戳必须使用秒。如果未提供范围，则默认使用最近 5 年。