finhay-market

Finhay Market

Finhay Securities Open API を通じた読み取り専用の市場データです。

必須：認証情報が設定されていることを確認してください（環境変数 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_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	市場ニュース：企業イベント、配当、株主総会の日程です。	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。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	経済カレンダー：CN／EU／JP／US／UK／VN の今後のイベント（CPI、Fed 会合など）です。	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）のうち、いずれか1つだけを指定します。
• 時間枠：価格履歴のタイムスタンプは秒単位である必要があります。期間が指定されていない場合は、直近5年間をデフォルトとして使用します。