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 のいずれか1つのみ
/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 のいずれか1つのみを指定してください。組み合わせて指定しないでください。
  • 価格履歴 — from と to は Unix タイムスタンプの秒単位で指定します。ミリ秒ではありません。値が 9,999,999,999 を超える場合は処理を中断し、ユーザーに変換を依頼してください。resolution は 1D、5、15、30、1H、4H のいずれかを指定します。省略時のデフォルトは 1D です。to が省略された場合は現在時刻、from が省略された場合は5年前をデフォルト値として使用してください。

コメント

Markdown 対応