mcpField
F
finhay-market

finhay-market

github.com/finhay-proOther41 installs
Repository

About finhay-market

A skill for retrieving read-only market data from the Finhay Securities Open API. It uses signed GET requests for quotes, financial indicators, reports, and price histories, with endpoint-specific parameter rules.

Key features

  1. 01Realtime stock quotes
  2. 02Corporate event news
  3. 03Gold, silver, and crypto data
  4. 04Macro and bank-rate indicators
  5. 05Company financials and statements
  6. 06Historical price charts

Use cases

  1. 01Checking quotes for stocks or an exchange
  2. 02Reviewing precious-metal and macroeconomic data
  3. 03Researching company financials and analyst reports
  4. 04Retrieving historical OHLCV prices

Install

Copy the command and run it in a terminal.

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

After installing, type/finhay-marketin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project README

Finhay Market

Read-only market data via the Finhay Securities Open API. All requests are signed GET.

MANDATORY: Before any action, read and complete pre-flight checks. Required: FINHAY_API_KEY, FINHAY_API_SECRET. USER_ID not needed for market endpoints. Do not skip or defer.

Making a Request

Use request.sh for every call.

./_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"

Endpoints

EndpointUse whenPath paramQuery params
/market/stock-realtimeStock price, realtime quote—exactly one of: symbol, symbols, exchange
/market/newsCorporate events: dividends, rights issues, AGM dates—stock, stocks, from_date, to_date (all optional, dates in DD/MM/YYYY; default range: last 1 year)
/market/financial-data/gold, silverGold/silver spot price——
/market/financial-data/gold-chart, silver-chartGold/silver price chart—days (default 30)
/market/financial-data/gold-providers, metal-providersPrice by provider (PNJ, DOJI…)——
/market/financial-data/bank-interest-ratesBank deposit rates——
/market/financial-data/cryptos/top-trendingTop crypto——
/market/financial-data/macroCPI, PMI, interest rates…—type, country, period
/market/recommendation-reports/:symbolAnalyst reports:symbol—
/market/price-histories-chartOHLCV price history—symbol, resolution (1D, 5, 15, 30, 1H, 4H, default 1D), from, to (seconds)
/market/company-financial/overviewKey ratios: PE, PB, ROE, EPS, dividend yield—symbol
/market/company-financial/analysisHistorical financial metrics by period—symbol, period (annual/quarterly)
/market/v2/financial-statement/statementIncome/balance sheet/cash flow, metric-value row format—symbol, type, period, limit
Parameter rules
  • Each endpoint accepts only the parameters listed in its path and query columns above. Do not add extra parameters.
  • All :variables in the URL are path variables — substitute them into the URL, never pass as query params.

Details & response shapes: references/endpoints.md.

Constraints

See shared constraints, plus:

  • Stock realtime — pass exactly one of symbol, symbols, or exchange. Never combine them.
  • Price history — from and to are Unix timestamps in seconds, not milliseconds. If a value exceeds 9,999,999,999, stop and ask the user to convert. resolution must be one of 1D, 5, 15, 30, 1H, or 4H, with a default of 1D when not provided. When not provided, default to to now and from to 5 years ago.

Comments

Markdown supported