Stock prices, funds, gold, silver, crypto, macro indicators, bank rates, price charts, and company financials (income statement, balance sheet, cash flow, ratios). Use when user asks about stock prices, gold/silver prices, fund performance, interest rates, macro data, price history charts, or company financial statements.
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_IDnot needed for market endpoints. Do not skip or defer.
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"
| Endpoint | Use when | Path param | Query params |
|---|---|---|---|
/market/stock-realtime | Stock price, realtime quote | — | exactly one of: symbol, symbols, exchange |
/market/funds | Fund list, NAV | — | — |
/market/funds/:fund/portfolio | Fund holdings | :fund | month (optional) |
/market/financial-data/gold, silver | Gold/silver spot price | — | — |
/market/financial-data/gold-chart, silver-chart | Gold/silver price chart | — | days (default 30) |
/market/financial-data/gold-providers, metal-providers | Price by provider (PNJ, DOJI…) | — | — |
/market/financial-data/bank-interest-rates | Bank deposit rates | — | — |
/market/financial-data/cryptos/top-trending | Top crypto | — | — |
/market/financial-data/macro | CPI, PMI, interest rates… | — | type, country, period |
/market/recommendation-reports/:symbol | Analyst reports | :symbol | — |
/market/price-histories-chart | OHLCV price history | — | symbol, resolution (only 1D), from, to (seconds) |
/market/company-financial/overview | Key ratios: PE, PB, ROE, EPS, dividend yield | — | symbol |
/market/company-financial/analysis | Historical financial metrics by period | — | symbol, period (annual/quarterly) |
/market/v2/financial-statement/statement | Income/balance sheet/cash flow, metric-value row format | — | symbol, type, period, limit |
:variables in the URL are path variables — substitute them into the URL, never pass as query params.Details & response shapes: references/endpoints.md.
See shared constraints, plus:
symbol, symbols, or exchange. Never combine them.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 1D. When not provided, default to to now and from to 5 years ago.