
Finhay Market
Access real-time stock quotes, financial data, precious metals prices, and market news through signed API endpoints.
Install
npx skills add https://github.com/finhay/finhay-skills-hub --skill finhay-marketWhat is this skill?
- Real-time stock data and news feeds
- Precious metals pricing (gold/silver) with historical charts
- Request signing via CLI scripts for secure API calls
Adoption & trust: 1 installs on skills.sh; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
Recommended Skills
Journey fit
This tool belongs in the build phase because it provides ready-to-use API endpoints that developers integrate into their applications during active development. The integration subphase is appropriate because finhay-market is fundamentally an API integration tool for connecting to market data services.
Common Questions / FAQ
Is Finhay Market safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Finhay Market
2.0.1 # Market Endpoints Signing: use `./finhay.sh request` (or `.\finhay.ps1 request`). ## Errors `400` = invalid request, `401` = auth failure, `429` = rate limited. Common causes: missing API key, combining `symbol`/`symbols`/`exchange`, path mismatch in signature. ## Response Keys - `result` — stock-realtime - `data` — all other endpoints --- ## Stock | # | Path | Params | Res key | Note | Detail | |---|------|--------|---------|------|--------| | 1 | `/market/stock-realtime` | 1-of: `symbol`, `symbols`, `exchange` | `result` | object for `symbol`, array for `symbols`/`exchange` | [detail](./endpoints/stock-realtime.md) | ## News | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/market/news` | `stock`, `stocks`, `from_date`, `to_date` (all optional) | `result` | [detail](./endpoints/news.md) | ## Financial Data — Precious Metals | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/market/financial-data` | — | `data` | [detail](./endpoints/financial-data.md) | | 2 | `/market/financial-data/gold` | — | `data` | [detail](./endpoints/gold.md) | | 3 | `/market/financial-data/silver` | — | `data` | [detail](./endpoints/silver.md) | | 4 | `/market/financial-data/gold-chart` | `days` (default 30) | `data` | [detail](./endpoints/gold-chart.md) | | 5 | `/market/financial-data/silver-chart` | `days` (default 30) | `data` | [detail](./endpoints/silver-chart.md) | | 6 | `/market/financial-data/gold-providers` | — | `data` | [detail](./endpoints/gold-providers.md) | | 7 | `/market/financial-data/metal-providers` | — | `data` | [detail](./endpoints/metal-providers.md) | ## Financial Data — Other | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/market/financial-data/bank-interest-rates` | — | `data` | [detail](./endpoints/bank-interest-rates.md) | | 2 | `/market/financial-data/cryptos/top-trending` | — | `data` | [detail](./endpoints/cryptos-top-trending.md) | | 3 | `/market/financial-data/macro` | `type`*, `country`*, `period` | `data` | [detail](./endpoints/macro.md) | | 4 | `/market/financial-data/trading-economics` | `country`* (enum), `category` (enum), `year` | `data` | [detail](./endpoints/trading-economics.md) | | 5 | `/market/financial-data/global-news` | `category` (enum), `page`, `page_size` (max 50, default 20) | `data` | [detail](./endpoints/global-news.md) | | 6 | `/market/financial-data/global-news/:id` | `:id`* (path) | `data` | [detail](./endpoints/global-news.md) | ## Financial Data — Market Indices & Assets | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/market/financial-data/market` | `type`* (enum), `limit` (default 50, max 500) | `data` | [detail](./endpoints/market-data.md) | ## Financial Data — Economic Calendar | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/market/financial-data/economic-calendar-events` | `weeks` (default 1), `country` (optional, e.g. `China`, `Vietnam`) | `data` | [detail](./endpoints/economic-calendar-events.md) | ## Funds | # | Path | Params | Res key | Detail | |---|------|--------|---------|--------| | 1 | `/fund-trading/public/fund-certificates` | `fund-type`* (`STOCK_FUND`\|`BOND_FUND`\|`BALANCE_FUND`), `fund-company-id` | `data` | [detail](./endpoints/funds.md) | | 2 | `/fund-trading/public/fund-companies` | — | `data` | [detail](./endpoints/fund-companies.md) | | 3 | `/fund-trading/public/fund-certificates/benchmark/growth` | `fund-names`*, `amount`* (VND), `period`* | `data` | [detail](./endpoints/fund-benchmark.md) | | 4 | `/fund-trading/public/fund-certificates/benchmark/nav` | `fund-names`*, `period` OR (`from-month`+`to-month`, `yyyy-MM`) | `data` | [detail](./endpoints/fund-benchmark.md) | | 5 | `/fund-trading/public/fund-certificates/:fund/nav-histories` | `:fund`* (path), `period` (default `ALL_TIME`) | `data` | [detail](./endpoints/fund-nav-history.md) | |