# FinLens Docs > Tài liệu hướng dẫn hệ sinh thái FinLens: nền tảng web finlens.vn, thư viện Python finlens và FinLens MCP cho trợ lý AI. Dữ liệu chứng khoán Việt Nam cho nhà đầu tư và lập trình viên. ## Hệ sinh thái - **FinLens Web** (https://finlens.vn) — nền tảng phân tích chứng khoán trên trình duyệt. - **FinLens Python SDK** (https://pypi.org/project/finlens/) — thư viện Python `pip install finlens` lấy dữ liệu chứng khoán Việt Nam (giá cổ phiếu OHLCV, chỉ số VNINDEX, dòng tiền nhà đầu tư, báo cáo tài chính các sàn HOSE/HNX/UPCOM) về pandas DataFrame. In English: a Python library for Vietnamese stock market data as pandas DataFrames. - **FinLens MCP** (https://mcp.finlens.vn/mcp) — MCP server (Model Context Protocol) cho Claude, ChatGPT và Gemini truy vấn dữ liệu tài chính Việt Nam theo thời gian thực: giá và thanh khoản hơn 1.700 cổ phiếu trên HOSE/HNX/UPCOM, báo cáo tài chính và chỉ tiêu cơ bản, dòng tiền khối ngoại và tự doanh, chứng quyền, phái sinh, quỹ đầu tư, trái phiếu doanh nghiệp, kinh tế vĩ mô và xuất nhập khẩu, cùng tin tức đã được AI phân tích. Kết nối bằng OAuth, cần gói FinLens Pro hoặc Premium. Hướng dẫn: https://docs.finlens.vn/mcp — bắt đầu tại https://docs.finlens.vn/mcp/bat-dau In English: FinLens MCP is a Model Context Protocol server that gives Claude, ChatGPT and Gemini live access to Vietnamese stock market and financial data — prices, financial statements, investor cash flows, warrants, funds, corporate bonds, and macroeconomic indicators. Toàn văn tài liệu: https://docs.finlens.vn/llms-full.txt Mỗi trang đều có bản Markdown thuần: thêm ".md" vào cuối URL bất kỳ, ví dụ https://docs.finlens.vn/mcp.md ## Tài liệu FinLens - Nền tảng: Khái niệm chung, quy ước dữ liệu và khóa API dùng cho mọi sản phẩm FinLens. - [Quy ước dữ liệu FinLens](/platform): Đơn vị giá, mã ngành ICB, quy ước thời gian và khóa API — những điều cần nắm trước khi dùng bất kỳ sản phẩm nào của FinLens. - FinLens Web: Hướng dẫn sử dụng nền tảng phân tích chứng khoán finlens.vn. - [Hướng dẫn dùng FinLens Web — phân tích cổ phiếu Việt Nam](/webapp): Cách dùng nền tảng finlens.vn: sắp xếp widget trên Dashboard, đọc độ rộng thị trường, dòng tiền nhóm nhà đầu tư, kỹ thuật, báo cáo tài chính và bộ lọc cổ phiếu. - [Dashboard FinLens: sắp xếp widget và đồng bộ mã cổ phiếu](/webapp/bat-dau): Cách dùng Dashboard FinLens: kéo thả và phóng to widget, chia ô so sánh, đồng bộ mã cùng ngày cho mọi widget, và lưu bố cục riêng bằng Workspace. - **Thị trường** - [Độ rộng thị trường & P/E VNINDEX: đọc sức khỏe thật](/webapp/thi-truong-tong-quan): Chỉ số tăng chưa chắc thị trường khỏe. Cách đọc độ rộng MA, độ rộng RSI, tỷ lệ tăng giảm trong phiên và P/E VNINDEX để biết đà tăng có nội lực hay không. - [Dòng tiền chứng khoán: khối ngoại, tự doanh và lệnh lớn](/webapp/thi-truong-dong-tien): Cách đọc dòng tiền thị trường trên FinLens: khối ngoại và tự doanh lũy kế theo ngành, dòng tiền Shark lọc lệnh lớn, mua bán chủ động và thanh khoản trong phiên. - [Xếp hạng RS, RRG và top cổ phiếu ảnh hưởng chỉ số](/webapp/thi-truong-xep-hang): Tìm cổ phiếu dẫn dắt bằng RS Rating và Relative Rotation Graph, xem mã nào đang kéo hoặc kéo tụt VNINDEX, và bóc tách ảnh hưởng bluechip khỏi định giá chỉ số. - **Cổ phiếu** - [Sổ lệnh 3 bước giá và bảng khớp lệnh thời gian thực](/webapp/co-phieu-terminal): Đọc Trading Terminal của FinLens: sổ lệnh ba bước giá mua bán, bảng khớp lệnh chạy realtime, phân bố khối lượng theo giá và bubble volume trong phiên. - [Dòng tiền một mã cổ phiếu: ai đang mua, ai đang bán](/webapp/co-phieu-dong-tien): Đọc dòng tiền lũy kế của một mã trên FinLens: bóc tách theo nhóm nhà đầu tư, mua bán chủ động trong phiên và so sánh dòng tiền của mã với cả ngành. - [Phân tích kỹ thuật cổ phiếu: Trend MA, Pivot và mùa vụ](/webapp/co-phieu-ky-thuat): Công cụ kỹ thuật cho một mã trên FinLens: tín hiệu Trend MA, backtest chiến lược SMA cắt nhau, Pivot Points, chỉ số rủi ro và thống kê lợi nhuận theo mùa vụ. - [Đọc báo cáo tài chính doanh nghiệp niêm yết và cổ tức](/webapp/co-phieu-tai-chinh): Xem kết quả kinh doanh và lợi nhuận TTM, cân đối kế toán, lưu chuyển tiền tệ, lịch sử cổ tức tiền mặt cùng cổ phiếu thưởng và sự kiện doanh nghiệp trên FinLens. - **Công cụ** - [Khuyến nghị đồng thuận CTCK và giá mục tiêu cổ phiếu](/webapp/khuyen-nghi): Xem đồng thuận của các công ty chứng khoán cho từng mã trên FinLens: phân bổ Mua Nắm giữ Bán, giá mục tiêu bình quân theo trọng số thời gian và kỳ vọng tăng giá. - [Bộ lọc cổ phiếu Screener và danh mục theo dõi Watchlist](/webapp/watchlist-screener): Lọc cổ phiếu theo tiêu chí cơ bản, kỹ thuật và dòng tiền khối ngoại trên FinLens, tạo danh mục Watchlist theo dõi giá realtime và nối kết quả lọc vào widget khác. - Python SDK: Thư viện `finlens` trên PyPI — dữ liệu chứng khoán Việt Nam dưới dạng pandas DataFrame. - [Thư viện Python lấy dữ liệu chứng khoán Việt Nam](/python-sdk): Thư viện Python finlens trả dữ liệu chứng khoán Việt Nam về pandas DataFrame: giá cuối ngày, dữ liệu trong phiên, dòng tiền nhà đầu tư và báo cáo tài chính. - [Cài đặt thư viện Python finlens và lấy khoá API](/python-sdk/cai-dat): Cài finlens bằng pip trên Python 3.11+, tạo khoá API dạng flk_, đặt biến môi trường FINLENS_API_KEY và chạy truy vấn đầu tiên với client.eod.stock.ohlcv(). - **Tham chiếu API** - [Giá lịch sử cổ phiếu Việt Nam bằng Python (EOD)](/python-sdk/eod): Dùng finlens lấy OHLCV cuối ngày, sổ lệnh đặt, khối lượng chủ động, chênh lệch phái sinh và dòng tiền nhóm nhà đầu tư của chứng khoán Việt Nam về pandas DataFrame. - [Dữ liệu trong phiên (intraday) cổ phiếu Việt Nam](/python-sdk/intraday): Lấy dữ liệu trong phiên cổ phiếu, chỉ số, phái sinh Việt Nam về pandas DataFrame: thanh giá 1min đến 4h, từng lệnh khớp, dòng tiền chủ động và basis bước 1 phút. - [Báo cáo tài chính Python: lấy BCTC cổ phiếu Việt Nam](/python-sdk/bao-cao-tai-chinh): Dùng finlens lấy báo cáo tài chính doanh nghiệp niêm yết Việt Nam theo năm hoặc quý về pandas DataFrame: cân đối kế toán, kết quả kinh doanh, lưu chuyển tiền tệ. - [Tra cứu danh mục mã chứng khoán Việt Nam bằng Python](/python-sdk/tra-cuu-danh-muc): Dùng finlens lấy danh sách mã chứng khoán HOSE, HNX, UPCOM, cây ngành ICB và danh mục chứng quyền có bảo đảm về pandas DataFrame, kèm bộ lọc theo sàn và ngành. - [Kiểu dữ liệu finlens.typing: WhoAmI, Limits, FrameMeta](/python-sdk/kieu-du-lieu): Tham chiếu kiểu dữ liệu finlens.typing của thư viện Python finlens: WhoAmI, Limits, FrameMeta, EodInterval và cách đọc đơn vị từng cột trong df.attrs. - [Xử lý lỗi finlens: FinLensError và cây ngoại lệ Python](/python-sdk/xu-ly-loi): Cách bắt lỗi khi lấy dữ liệu chứng khoán bằng finlens: except FinLensError bắt trọn cây ngoại lệ, rẽ nhánh theo mã FL_*, dùng on_error cho lời gọi nhiều mã. - **Khác** - [Changelog finlens Python: nhật ký thay đổi thư viện](/python-sdk/changelog): Nhật ký thay đổi thư viện Python finlens: bản 1.1.1 thêm supply_demand, active_volume và basis; kèm mọi thay đổi phá vỡ tương thích khi nâng từ 0.1.x lên 1.x. - FinLens MCP: Kết nối Claude, ChatGPT và các trợ lý AI vào dữ liệu chứng khoán Việt Nam. - [FinLens MCP: Phân tích chứng khoán Việt Nam bằng AI](/mcp): Tổng quan FinLens MCP: cách kết nối Claude và ChatGPT với dữ liệu tài chính Việt Nam, cùng 18 bài hướng dẫn phân tích cổ phiếu bằng AI theo chủ đề. - [Kết nối FinLens MCP với Claude AI và ChatGPT dưới 2 phút](/mcp/bat-dau): Hướng dẫn kết nối FinLens MCP vào Claude Desktop, Claude.ai và ChatGPT qua OAuth trong dưới 2 phút để hỏi AI về giá và báo cáo tài chính cổ phiếu Việt Nam. - [Cẩm nang 107 công cụ FinLens MCP phân tích chứng khoán](/mcp/cam-nang-cong-cu): Danh sách đầy đủ 107 công cụ FinLens MCP theo 12 nhóm: giá, báo cáo tài chính, dòng tiền, kỹ thuật, chứng quyền, vĩ mô, cổ tức, tin tức — kèm câu hỏi mẫu. - **Phân tích doanh nghiệp** - [Phân tích cơ bản cổ phiếu bằng AI: P/E, ROE, BCTC, DuPont](/mcp/phan-tich-co-ban): Hỏi AI để tra 7 nhóm KPI kèm TTM, đọc BCTC đầy đủ, phân rã DuPont và quét 8 mục chất lượng kế toán, so sánh toàn ngành ICB qua FinLens MCP. - [Thuyết minh BCTC, cơ cấu chi phí & định giá DCF bằng AI](/mcp/cong-ty-thuong): FinLens MCP giúp AI bóc tách thuyết minh BCTC doanh nghiệp phi tài chính: cơ cấu chi phí, nợ vay, vốn lưu động, doanh thu và định giá DCF tự tính WACC. - [Phân tích cổ phiếu ngân hàng bằng AI: NPL, CASA, NII, CIR](/mcp/ngan-hang): Hướng dẫn dùng AI phân tích cổ phiếu ngân hàng Việt Nam qua ba công cụ FinLens MCP: chất lượng tài sản (NPL, bao phủ dự phòng), CASA và NII/CIR/PPOP. - [Phân tích cổ phiếu chứng khoán bằng AI: tự doanh, margin](/mcp/chung-khoan): Dùng AI phân tích cổ phiếu công ty chứng khoán: bóc tách danh mục tự doanh, cơ cấu doanh thu, tài sản khách hàng giữ hộ và margin toàn ngành. - **Dòng tiền & thị trường** - [Dòng tiền smart money và khối ngoại: hỏi AI qua FinLens MCP](/mcp/dong-tien): Hỏi AI về smart money, khối ngoại, dòng tiền chủ động và dòng tiền theo ngành của cổ phiếu Việt Nam bằng công cụ flows_get_stock_flow của FinLens MCP. - [Sức mạnh ngành và RS: tìm cổ phiếu dẫn dắt bằng AI](/mcp/suc-manh-nganh): Xếp hạng sức mạnh RS của 19 ngành cấp 2 và ~78 ngành cấp 4, phát hiện dẫn dắt hẹp qua độ phân kỳ breadth và lọc cổ phiếu leader bằng câu hỏi tiếng Việt. - [Thị trường hôm nay & dòng tiền chủ động: đọc phiên bằng AI](/mcp/phien-truc-tiep): Cách dùng FinLens MCP để hỏi AI về thị trường hôm nay: chỉ số, độ rộng, dòng tiền chủ động, VWAP từng mã và cung-cầu đặt lệnh trong phiên. - [Tin tức chứng khoán AI: điểm tin sáng, sentiment theo mã](/mcp/tin-tuc-ai): Tin tức chứng khoán Việt Nam được FinLens MCP phân tích bằng AI mỗi ~10 phút: tóm tắt, sentiment theo tác động giá, độ quan trọng và trọng số mã liên quan. - **Công cụ đầu tư** - [Phân tích kỹ thuật & backtest chiến lược chứng khoán bằng AI](/mcp/ky-thuat-backtest): Hướng dẫn dùng AI đọc 141 chỉ báo kỹ thuật, quét tín hiệu trên 1.700 mã, nhận diện 61 mẫu nến và backtest chiến lược với mô phỏng T+2.5 Việt Nam. - [Tối ưu danh mục đầu tư bằng AI: Max Sharpe, HRP, VaR](/mcp/danh-muc): Hướng dẫn dùng FinLens MCP để tính tỷ trọng tối ưu theo Max Sharpe, Min Volatility, HRP, backtest danh mục so với VNINDEX và đo VaR, CVaR, max drawdown. - [Chứng quyền có bảo đảm (CW): Định giá & So sánh bằng AI](/mcp/chung-quyen): Định giá chứng quyền có bảo đảm bằng AI: điểm hòa vốn, premium, đòn bẩy hiệu dụng, Greeks và IV, so sánh mọi CW trên cùng mã cơ sở để chọn mã tối ưu. - [Phân tích cổ tức bằng AI: lợi suất, payout, lịch GDKHQ](/mcp/co-tuc): Phân tích cổ tức bằng AI với FinLens MCP: tra lịch chốt quyền (GDKHQ) sắp tới, xem lịch sử cổ tức từng mã, đánh giá lợi suất, tỷ lệ chi trả và độ đều. - [Quỹ đầu tư Việt Nam: tra cứu danh mục & smart money bằng AI](/mcp/quy-dau-tu): Dùng FinLens MCP hỏi AI về 185 quỹ đầu tư Việt Nam: danh mục nắm giữ, NAV, hiệu suất và cổ phiếu nào đang được khối quỹ gom hay xả. - [Dữ liệu trái phiếu doanh nghiệp Việt Nam hỏi bằng AI](/mcp/trai-phieu): Tra cứu trái phiếu doanh nghiệp Việt Nam trên HNX bằng Claude hoặc ChatGPT: lịch đáo hạn, dư nợ theo ngành, hồ sơ tổ chức phát hành và trái phiếu chuyển đổi. - **Nguồn tham khảo** - [Báo cáo phân tích CTCK & giá mục tiêu đồng thuận bằng AI](/mcp/bao-cao-ctck): Hỏi AI để tra báo cáo phân tích từ 20+ CTCK như SSI, VND, MBS, đọc tóm tắt PDF và xem đồng thuận giá mục tiêu, upside %, tỷ lệ MUA/NẮM GIỮ/BÁN của từng mã. - [Phân tích kinh tế vĩ mô và xuất nhập khẩu Việt Nam bằng AI](/mcp/vi-mo): Tra cứu CPI, IIP, FDI, GDP từ Tổng cục Thống kê và số liệu xuất nhập khẩu Hải quan theo mặt hàng bằng AI, rồi ánh xạ thẳng sang cổ phiếu ngành liên quan. - [Phân tích cổ phiếu đa góc nhìn: chia nhỏ prompt cho AI](/mcp/nang-cao): Hướng dẫn chia nhỏ prompt thành chuỗi bước và soi cổ phiếu qua 6 lăng kính — định giá, chất lượng, dòng tiền, kỹ thuật, cổ tức, ngành — với FinLens MCP.