Quy ước dữ liệu FinLens
Đơ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.
Các quy ước dưới đây áp dụng cho mọi sản phẩm FinLens: web, Python SDK, MCP và mobile. Nắm trước sẽ tránh được phần lớn lỗi khi ghép dữ liệu từ nhiều nguồn.
Đơn vị giá
| Loại tài sản | Đơn vị | Ví dụ |
|---|---|---|
| Cổ phiếu, chỉ số | Nghìn đồng | 23.4 = 23.400 VND |
| Chứng quyền | Đồng | 1250 = 1.250 VND |
| Giá trị giao dịch | Tỷ đồng | 1234.5 = 1.234,5 tỷ VND |
Khi so sánh giá chứng quyền với giá cổ phiếu cơ sở, phải quy đổi trước. Nhân giá cổ phiếu với 1.000 để đưa về đơn vị đồng.
Giá điều chỉnh
Toàn bộ dữ liệu giá lịch sử đã được điều chỉnh theo cổ tức và chia tách. Nghĩa là chuỗi giá dùng trực tiếp để tính lợi suất mà không cần xử lý thêm.
Phân ngành
FinLens dùng chuẩn ICB (Industry Classification Benchmark). Các hàm thống kê theo ngành mặc định lấy ICB cấp 2.
Chọn cách truy cập dữ liệu
| Bạn muốn | Dùng |
|---|---|
| Xem biểu đồ, bảng giá, bộ lọc trên trình duyệt | FinLens Web |
| Hỏi Claude, ChatGPT hoặc Gemini bằng tiếng Việt | FinLens MCP |
Lấy dữ liệu thô về pandas.DataFrame để tự tính | Python SDK |
Trang này là khung nội dung khởi tạo. Các mục chi tiết (khóa API, hạn mức, mã lỗi) sẽ được bổ sung khi migrate nội dung từ các repo sản phẩm.
Cập nhật lần cuối