Finhay

Báo giá dealer nội địa (VN) cho 1 hàng hoá — vd vàng SJC/PNJ/DOJI. Hàng hoá không có dealer trả mảng rỗng.

get_dealer_products

Lịch sử giá OHLCV của 1 hàng hoá (chỉ hỗ trợ `resolution=1D`). `from`/`to` Unix timestamp GIÂY.

get_commodity_history

Giá realtime QUỐC TẾ của 1 hàng hoá theo mã ISO (vd XAU=vàng, XAG=bạc).

get_commodity_quote

Chỉ số tài chính tổng quan của doanh nghiệp

get_company_overview

Hồ sơ doanh nghiệp của 1 mã: tên tiếng Việt/tiếng Anh, cây ngành, mô tả hoạt động kinh doanh. Dữ liệu tham chiếu tĩnh — chỉ số tài chính dùng get_company_overview.

get_stock_profile

Lịch sử giá OHLCV của 1 crypto (chỉ hỗ trợ `resolution=1D`). `from`/`to` Unix timestamp GIÂY.

get_crypto_history

Giá realtime của 1 crypto (vd BTC, ETH, SOL).

get_crypto_quote

Danh sách crypto được hỗ trợ kèm ticker và tên. Lấy symbol từ đây để gọi `get_crypto_quote` / `get_crypto_history`.

get_cryptos_catalog

Lịch sử giá 1 sản phẩm dealer theo `code`. `from`/`to` Unix timestamp GIÂY.

get_dealer_product_history

Giá mua vào / bán ra hiện tại của 1 sản phẩm dealer nội địa theo code (lấy từ get_dealer_products). Đơn vị VNĐ, thường tính theo lượng/chỉ tuỳ sản phẩm.

get_dealer_product_quote

Lịch sử giá OHLCV của 1 ETF. `resolution` 1D/5/15/30/1H/4H (mặc định 1D); `from`/`to` là Unix timestamp GIÂY và bắt buộc cả hai.

get_etf_history

Độ sâu bid/ask hiện tại của 1 ETF niêm yết

get_etf_order_book

Giá realtime của 1 chứng chỉ quỹ ETF niêm yết — cùng cấu trúc trả về với get_stock_quote (giá khớp, tham chiếu, trần/sàn, khối lượng). Đây là GIÁ THỊ TRƯỜNG trên sàn, có thể chênh lệch (premium/discount) so với NAV.

get_etf_quote

Danh mục ETF niêm yết kèm metadata (công ty QLQ, chỉ số tham chiếu).

get_etfs_catalog

Phân tích tài chính doanh nghiệp theo kỳ

get_financial_analysis

Báo cáo tài chính

get_financial_statement

Khối ngoại mua / bán / ròng bao nhiêu ở 1 mã trong 1 phiên, tách riêng khớp lệnh và thoả thuận. Đây là tool đúng khi người dùng hỏi 'khối ngoại mua bán bao nhiêu', 'nước ngoài mua ròng hay bán ròng'. KHÁC get_stock_foreign_room — cái đó là trần sở hữu và room còn lại, không phải giao dịch trong phiên.

get_stock_foreign_flow

Chuỗi mua/bán/ròng của khối ngoại theo phiên (diễn biến dòng tiền ngoại). KHÁC get_stock_foreign_room_history — cái đó là room ngoại còn lại theo ngày. `from`/`to` dạng `YYYY-MM-DD` phải truyền CÙNG NHAU (khoảng tối đa 5 năm); bỏ trống cả hai → 3 tháng gần nhất. Bar nằm trong `data`. Chưa phân trang.

get_stock_foreign_flow_history

Room ngoại của 1 mã tại phiên gần nhất: trần sở hữu nước ngoài (`max_pct`, `max_volume`), khối lượng khối ngoại đang nắm (`owned`), room còn lại (`available`). Cần chuỗi theo ngày dùng get_stock_foreign_room_history.

get_stock_foreign_room

Chuỗi room ngoại theo ngày của 1 mã. `from`/`to` dạng `YYYY-MM-DD` phải truyền CÙNG NHAU (khoảng tối đa 5 năm); bỏ trống cả hai → 3 tháng gần nhất. Phân trang qua `page`/`page_size` (tối đa 50), `total` là tổng số phiên trong khoảng.

get_stock_foreign_room_history

Danh mục cặp forex được hỗ trợ.

get_forex_catalog

Lịch sử tỷ giá 1 cặp forex — chỉ hỗ trợ resolution=1D và chỉ có giá đóng cửa (close-only), không có OHLC đầy đủ. from/to Unix timestamp GIÂY

get_forex_history

Tỷ giá realtime của 1 cặp forex (vd USDVND, EURUSD). Đây là tỷ giá THỊ TRƯỜNG QUỐC TẾ, có thể lệch đáng kể so với tỷ giá niêm yết của ngân hàng thương mại VN

get_forex_quote

Lịch sử NAV của 1 quỹ mở — chuỗi điểm {t, nav}, đơn vị VNĐ/CCQ. from/to là Unix timestamp GIÂY, bắt buộc cả hai.

get_fund_history

NAV mới nhất của 1 chứng chỉ quỹ mở (vd VESAF, DCDS, TCBF). Quỹ mở chỉ định giá theo tần suất riêng (thường 1–3 phiên/tuần) nên NAV mới nhất có thể là của vài ngày trước

get_fund_quote

Danh mục quỹ mở kèm metadata (công ty QLQ, loại quỹ, tần suất định giá).

get_funds_catalog

Độ rộng thị trường trong universe của 1 chỉ số ở phiên hiện tại: số mã tăng / giảm / đứng giá, trần / sàn, tổng số mã — dùng cho câu hỏi "hôm nay bao nhiêu mã tăng trên HOSE" (`VNINDEX`). `limit_up` là TẬP CON của `advancers` và `limit_down` của `decliners`; mã không giao dịch không nằm trong nhóm nào, nên ba nhóm không cộng lại bằng `total`.

get_index_breadth

Bảng so sánh các CHỈ SỐ: điểm số, `change`/`change_percent`, vốn hoá, số mã trong rổ, độ rộng, khối lượng / giá trị khớp, mua ròng khối ngoại. Lọc `exchange`, `window` (mặc định `1D`) cho các field dòng tiền, `sort` (thêm `-` cho giảm dần), `fields` chọn cột, `<field>_gt`/`<field>_lt` lọc số, phân trang `page`/`page_size`. Độ rộng chỉ có ở `window=1D`. Giá realtime của MỘT chỉ số dùng get_index_quote.

list_indices

Danh sách mã trong rổ 1 chỉ số kèm `weight_percent`, `market_cap`, `price`, `change_percent`. VN30 / HNX30 trả đúng rổ chọn lọc; VNINDEX / HNXINDEX / UPCOMINDEX là chỉ số toàn thị trường nên trả MỌI mã niêm yết trên sàn — `total` của hai loại không so sánh trực tiếp được. Chỉ số quốc tế không hỗ trợ. `sort` mặc định `-weight_percent`; phân trang `page`/`page_size` (tối đa 50).

get_index_constituents

Tổng mua / bán / ròng của khối ngoại trên TOÀN universe của 1 chỉ số trong phiên gần nhất — `VNINDEX` ≈ toàn sàn HOSE, `VN30` chỉ gồm 30 mã trong rổ. Trả lời "khối ngoại mua ròng BAO NHIÊU trên sàn hôm nay"; muốn biết MÃ NÀO thì dùng screen_stocks với `index`/`exchange` + `sort=-foreign_net_value`. `net` âm là bán ròng.

get_index_foreign_trading

Chuỗi mua / bán / ròng của khối ngoại theo phiên, cộng dồn trên toàn universe của 1 chỉ số (diễn biến dòng tiền ngoại của cả sàn). `from`/`to` dạng `YYYY-MM-DD` (khoảng tối đa 5 năm); bỏ trống cả hai → 3 tháng gần nhất. Bar nằm trong `data`. Chưa phân trang.

get_index_foreign_trading_history

Lịch sử chỉ số (chỉ hỗ trợ `resolution=1D`). Chỉ số VN trả OHLCV đầy đủ; chỉ số quốc tế chỉ có giá đóng cửa. `from`/`to` Unix GIÂY.

get_index_history

Giá trị realtime của 1 chỉ số (vd VNINDEX, HNXINDEX, SP500). Dùng field `value` thay `price`.

get_index_quote

Danh mục chỉ số thị trường (VN + quốc tế).

get_indices_catalog

Giao dịch công bố của người nội bộ, cổ đông lớn và người có liên quan của 1 mã. Đây là DANH SÁCH SỰ KIỆN công bố, KHÔNG phải chuỗi số liệu theo phiên — dòng tiền khối ngoại dùng get_stock_foreign_flow, cơ cấu sở hữu hiện tại dùng get_stock_ownership.

get_stock_insider_trading

Giá trị của một chỉ tiêu vĩ mô cho một quốc gia. Bỏ trống `from`/`to` → kỳ mới nhất; truyền cả cặp → chuỗi theo kỳ.

get_macro_indicator

Danh mục các chỉ tiêu vĩ mô khả dụng (GDP, CPI, lãi suất…) kèm mã quốc gia và slug. Gọi tool này trước để tra slug hợp lệ cho get_macro_indicator.

list_macro_indicators

Sự kiện thị trường theo lịch, KHÔNG gắn mã cổ phiếu: công bố số liệu vĩ mô (FOMC/lãi suất, CPI, GDP, PMI) kèm số `actual`/`previous`/`consensus`/`forecast` trong `detail` — `null` khi chưa công bố. Lọc `country`; khoảng thời gian `from`/`to` (Unix GIÂY, bỏ trống = từ hôm nay trở đi); phân trang `page`/`page_size`. Sự kiện nằm trong `results`.

list_calendar_events

Toàn văn một bài tin theo id lấy từ kết quả list_news. Chỉ gọi cho những bài thật sự cần đọc chi tiết — tóm tắt trong list_news thường đã đủ để trả lời.

get_news_detail

Lấy dòng tin tức tài chính quốc tế và Việt Nam. Hỗ trợ lọc theo topic và symbol (chỉ áp dụng khi topic=stock), cùng phân trang qua `page`/`page_size`. Tin nằm trong `results`; mỗi kết quả là bản tóm tắt — dùng `id` với get_news_detail để lấy toàn văn.

list_news