Hỏi AI về danh mục và watchlist FinLens của bạn
Đăng nhập FinLens qua OAuth để Claude hoặc ChatGPT đọc danh mục đầu tư, watchlist và bộ lọc đã lưu của bạn: vị thế, lãi lỗ, phân bổ ngành, giá và điểm xếp hạng.
Ba công cụ me_* cho trợ lý AI đọc đúng dữ liệu của tài khoản FinLens của
bạn: danh mục đầu tư, watchlist và bộ lọc đã lưu. Nhờ vậy câu hỏi "danh mục của
tôi đang lãi lỗ thế nào, lệch ngành nào" được trả lời bằng số thật thay vì bạn
phải dán danh sách mã vào khung chat. Cả ba chỉ đọc: không đặt lệnh, không sửa
danh mục hay watchlist, không đánh giá danh mục tốt hay xấu.
Cần đăng nhập FinLens qua OAuth
Dữ liệu cá nhân chỉ đọc được khi kết nối FinLens MCP mang danh tính người dùng, tức bạn đã đăng nhập tài khoản FinLens qua OAuth lúc thêm connector trong Claude hoặc tạo ứng dụng trong ChatGPT — đúng quy trình ở trang Bắt đầu. Nếu AI báo cần đăng nhập FinLens khi hỏi về danh mục, phiên kết nối đã hết hạn hoặc bị thu hồi: đăng xuất rồi kết nối lại. Các phiên đang kết nối xem và thu hồi được tại FinLens → Hồ sơ → mục Kết nối AI. Mọi công cụ dữ liệu thị trường khác không cần bước này.
Danh mục đầu tư: vị thế, lãi lỗ, phân bổ ngành
Công cụ me_portfolio gọi không tham số trả mọi danh mục bạn sở hữu
(access = owner) hoặc được chia sẻ (access = shared, kèm quyền VIEW, TRADE
hay ADMIN): vốn ban đầu, tiền mặt, giá trị cổ phiếu theo giá phiên gần nhất, tài
sản ròng, lãi lỗ từ đầu và số vị thế. Khi chỉ có một danh mục, chi tiết đi kèm
luôn; nhiều danh mục thì truyền portfolio_id để chọn.
Tôi có những danh mục nào trên FinLens, tài sản ròng và lãi lỗ từ đầu của từng danh mục là bao nhiêu?
→ me_portfolio (không tham số): portfolios[].nav_vnd, total_pnl_vnd, total_pnl_pct, n_positions
Trong danh mục chính của tôi, mã nào đang lỗ nhiều nhất so với giá vốn, và tỷ trọng ngành ngân hàng chiếm bao nhiêu phần trăm?
→ me_portfolio: portfolio_id=... — positions[].unrealized_pnl_pct, weight_pct; sectors[] theo ICB cấp 2
Lấy các mã tôi đang giữ rồi kiểm tra tin tức và điểm xếp hạng mới nhất của từng mã
→ me_portfolio trả handoff dựng sẵn → AI gọi tiếp news_get_for_stock, ratings_get... cho các mã đang giữ
Lãi lỗ từ đầu total_pnl_vnd = lãi đã chốt + lãi chưa chốt + cổ tức tiền − phí;
total_pnl_pct chia cho vốn ban đầu nên là lãi lỗ tích luỹ, không phải lợi
suất theo thời gian. Khối lượng đã điều chỉnh theo chia và thưởng cổ phiếu, giá
vốn bình quân không gồm phí. Trường warnings ghi những lệnh bị bỏ qua hoặc điều
chỉnh khi tính — đọc nó trước khi tin con số tổng.
Watchlist: giá và điểm xếp hạng của các mã theo dõi
Công cụ me_watchlist liệt kê các watchlist kèm số mã và thứ tự bạn đã sắp. Khi
chọn một watchlist (hoặc khi bạn chỉ có một), mỗi mã trả giá đóng cửa phiên gần
nhất theo nghìn VND, % thay đổi so với giá tham chiếu, % thay đổi 1 tháng, RS
1–100, Điểm tổng hợp 1–99, Sức mạnh giá 1–99 và mã ngành ICB cấp 4.
Trong watchlist của tôi, mã nào có RS trên 80 và Điểm tổng hợp trên 85? Mã nào giảm hơn 5% trong tháng?
→ me_watchlist: watchlist_id=... — items[].rs_rating, overall_rating, price_strength_rating, chg_1m_pct
Hai điểm cần nhớ khi đọc: rs_rating dùng cùng thang với signals_screen, còn
price_strength_rating là Sức mạnh giá của bảng điểm xếp hạng — hai thước đo
khác nhau, không thay thế nhau. Mã ngoài rổ tính điểm trả None; mã tài chính
không có Điểm tổng hợp. Ý nghĩa từng điểm xem
Điểm xếp hạng tổng hợp.
Bộ lọc đã lưu: chạy lại trong trợ lý AI
Công cụ me_saved_screens liệt kê bộ lọc bạn đã lưu trên FinLens: id, tên, mô
tả, điều kiện {logic, rules}, các trường dùng, bộ lọc mặc định và cờ
runnable. Khi runnable là true, truyền saved_screen_id vào screener_run
là chạy nguyên bộ lọc trên phiên mới nhất; cách dùng ở trang
Bộ lọc cổ phiếu.
Liệt kê các bộ lọc tôi đã lưu, bộ nào chạy được ngay, rồi chạy bộ lọc mặc định
→ me_saved_screens: screens[].runnable, is_default → screener_run: saved_screen_id=...
Chỉ đọc, không thay thế ứng dụng FinLens
Ba công cụ me_* không đặt lệnh, không thêm bớt mã trong watchlist, không sửa
bộ lọc và không nhận xét danh mục tốt hay xấu — mọi thay đổi vẫn làm trên FinLens.
Giá dùng để định giá vị thế là giá cuối ngày của phiên ghi ở price_date hoặc
as_of. Bộ lọc có trường tín hiệu kỹ thuật dạng sự kiện (unsupported_fields)
không chạy được bằng screener_run vì các trường đó thuộc signals_screen.
Bảng công cụ dữ liệu cá nhân
| Công cụ | Việc gì | Tham số chính |
|---|---|---|
me_portfolio | Danh mục của bạn: vốn, tiền mặt, tài sản ròng, lãi lỗ; chi tiết vị thế, phân bổ ngành ICB cấp 2, lãi đã chốt, cổ tức, phí và lời gọi tiếp theo dựng sẵn | portfolio_id (bỏ trống = danh sách) |
me_watchlist | Watchlist của bạn và số liệu từng mã: giá, % ngày và 1 tháng, RS, Điểm tổng hợp, Sức mạnh giá, mã ngành | watchlist_id (bỏ trống = danh sách) |
me_saved_screens | Bộ lọc đã lưu: id, điều kiện, trường dùng, cờ chạy được bằng screener_run | không có |
Bài liên quan
Bắt đầu: kết nối và đăng nhập OAuth
Thêm connector, đăng nhập FinLens và kiểm tra kết nối trong 2 phút.
Bộ lọc cổ phiếu
screener_run chạy bộ lọc đã lưu bằng saved_screen_id.
Rủi ro danh mục: thanh khoản và tương quan
Đo khả năng thoát vị thế và tương quan giữa các mã đang giữ.
Tối ưu danh mục đầu tư
Tỷ trọng tối ưu, backtest tái cân bằng và bộ chỉ số rủi ro cho danh mục.
Câu hỏi thường gặp
Trợ lý AI có xem được danh mục đầu tư cá nhân của tôi không?
Có, nếu danh mục được quản lý trên FinLens và bạn đã kết nối FinLens MCP bằng đăng nhập tài khoản qua OAuth. Công cụ me_portfolio đọc các danh mục bạn sở hữu hoặc được chia sẻ: vốn ban đầu, tiền mặt, giá trị cổ phiếu theo giá phiên gần nhất, tài sản ròng, lãi lỗ từ đầu, và với một danh mục cụ thể là từng vị thế kèm giá vốn bình quân, lãi lỗ chưa chốt, tỷ trọng và phân bổ theo ngành ICB cấp 2. Công cụ chỉ đọc, không đặt lệnh và không sửa danh mục.
Vì sao AI báo cần đăng nhập FinLens khi hỏi về danh mục hay watchlist?
Ba công cụ me_portfolio, me_watchlist và me_saved_screens của FinLens MCP đọc dữ liệu gắn với tài khoản, nên chỉ hoạt động khi kết nối mang danh tính người dùng — tức là bạn đã đăng nhập FinLens qua OAuth trong bước thêm connector ở Claude hay tạo ứng dụng ở ChatGPT. Nếu phiên kết nối đã bị thu hồi hoặc hết hạn, hãy đăng xuất và kết nối lại theo hướng dẫn ở trang Bắt đầu. Các công cụ dữ liệu thị trường khác không cần bước này.
FinLens MCP đọc watchlist của tôi thì trả những số liệu gì?
Công cụ me_watchlist của FinLens MCP liệt kê mọi watchlist kèm số mã và thứ tự mã bạn đã sắp. Khi chọn một watchlist, mỗi mã có giá đóng cửa phiên gần nhất theo nghìn VND, % thay đổi so với giá tham chiếu, % thay đổi 1 tháng với mã thuộc bảng lọc, RS 1–100 cùng thang với signals_screen, Điểm tổng hợp 1–99 và Sức mạnh giá 1–99 của bảng điểm xếp hạng, cùng mã ngành ICB cấp 4. Kết quả kèm lời gọi tiếp theo dựng sẵn để AI phân tích sâu các mã đó.
Lãi lỗ trong danh mục FinLens được tính như thế nào?
Trong me_portfolio của FinLens MCP, total_pnl_vnd là lãi lỗ từ đầu gồm lãi đã chốt từ lệnh bán, lãi chưa chốt theo giá phiên gần nhất, cổ tức tiền đã nhận sau khi trừ tiền mua quyền, trừ tổng phí và trượt giá. total_pnl_pct chia con số đó cho vốn ban đầu, nên là lãi lỗ tích luỹ chứ không phải lợi suất theo thời gian. Khối lượng vị thế đã điều chỉnh theo chia và thưởng cổ phiếu, giá vốn bình quân không gồm phí; trường warnings liệt kê lệnh bị bỏ qua hoặc điều chỉnh khi tính.
Bộ lọc tôi đã lưu trên FinLens dùng lại được trong trợ lý AI không?
Được. Công cụ me_saved_screens của FinLens MCP liệt kê các bộ lọc đã lưu kèm saved_screen_id, tên, mô tả, điều kiện, các trường dùng và cờ runnable. Khi runnable là true, truyền id đó vào screener_run là chạy nguyên bộ lọc trên dữ liệu phiên mới nhất. Bộ lọc có trường tín hiệu kỹ thuật dạng sự kiện thì không chạy được bằng screener_run; các trường đó nằm ở unsupported_fields và thuộc signals_screen. Công cụ không chạy lọc và không sửa bộ lọc.
Cập nhật lần cuối