Skip to content

About

Research on quarterly fundamental stock and sector ranking, statistical validation, and portfolio construction, with a roadmap toward ML ranking and reranking.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Fundamental Ranking Lab

Nghiên cứu định lượng về việc sử dụng dữ liệu tài chính doanh nghiệp để xếp hạng cổ phiếu và ngành tại thị trường Mỹ, xây dựng danh mục cập nhật hàng quý và kiểm chứng hiệu quả ngoài mẫu sau chi phí.

Trạng thái: Toàn bộ 100% Roadmap từ Stage 00 đến Stage 07 đã hoàn thiện baseline thực thi (Stage 00/01 đạt cổng). Repository có foundation code, CLI pilot, offline replay, persistent cache index, workflow Google Colab, bộ Open Dataset trên Hugging Face, pipeline Universe lịch sử, CLI frl rank xếp hạng 4 trục, CLI frl portfolio xây dựng danh mục theo water-filling caps, CLI frl evaluate kiểm định thống kê Q1–Q3 và CLI frl quarterly / frl replay phục vụ vận hành tái cân bằng định kỳ và khôi phục thảm họa. Đã có công cụ trực quan hóa và báo cáo danh mục tại reports/portfolio/PORTFOLIO_REPORT.md.

Mục tiêu nghiên cứu

Doanh nghiệp có fundamentals tốt chưa chắc tạo ra khoản đầu tư hấp dẫn ở mọi mức giá. Fundamental Ranking Lab kết hợp chất lượng, tăng trưởng, sức khỏe tài chính và định giá để kiểm tra ba câu hỏi:

Câu hỏi Nội dung Cách đánh giá chính
Q1 — Cổ phiếu Score cao có liên hệ với lợi nhuận quý tiếp theo tốt hơn sau khi kiểm soát ngành? Hệ số Fama–MacBeth
Q2 — Ngành Ngành được xếp hạng cao có vượt nhóm ngành xếp hạng thấp? Chênh lệch lợi nhuận nhóm trên và dưới
Q3 — Danh mục Phương pháp có cải thiện kết quả sau chi phí so với danh mục tham chiếu? Lợi nhuận ròng trừ universe equal-weight

Nghiên cứu hướng tới một quy trình có thể tái lập, giải thích được cách chấm điểm và công bố độ bất định. Kết luận âm hoặc chưa đủ bằng chứng vẫn là kết quả nghiên cứu hợp lệ.

Phạm vi v1

Thành phần Thiết kế hiện tại
Thị trường Cổ phiếu phổ thông Mỹ trên NYSE/NASDAQ/AMEX; một share class mỗi doanh nghiệp
Ngành SIC lịch sử ánh xạ sang Ken French 17 ngành
Chu kỳ Đánh giá và tái cân bằng hàng quý; horizon một quý
Phương pháp Factor ranking theo công thức; bốn trục Quality, Growth, Financial Health, Valuation
Chọn mã Top-100 theo score lõi chung; lấy hết mã bằng điểm ở ranh giới, lấy hết nếu dưới 100
Danh mục Long-only, không leverage; score-weight kết hợp điều chỉnh tỷ trọng theo hạng ngành
Giới hạn mặc định Tối đa 20% NAV mỗi ngành, 5% mỗi doanh nghiệp tại rebalance; phần dư giữ tiền mặt
Đối chiếu chính Toàn bộ cổ phiếu đủ điều kiện, tỷ trọng bằng nhau, cùng lịch và chi phí

Score lõi chung dùng để so ngành, chọn mã và tính tỷ trọng. Score đặc thù phục vụ xếp hạng và giải thích trong từng nhóm; chỉ sử dụng khi định nghĩa và dữ liệu đã được kiểm chứng. Bank, insurance, REIT và Other Financials phải vượt cổng kiểm tra riêng trước khi vào kết quả chính.

ML ranking/reranking, news, clustering động, mô hình market impact và triển khai giao dịch thực được để cho giai đoạn sau.

Quy trình dự kiến

  1. Dựng universe lịch sử: xác minh chứng khoán, trạng thái niêm yết, ngành và thay đổi identifier theo thời gian.
  2. Tạo snapshot point-in-time: chỉ dùng thông tin đã công bố tại cutoff, giữ nguồn và phiên bản để truy nguyên.
  3. Lọc điều kiện: kiểm tra thanh khoản, lịch sử báo cáo và độ phủ raw ratios trước chuẩn hóa.
  4. Chấm điểm và xếp hạng: tính bốn trục, score lõi chung, ranking ngành và ranking trong nhóm.
  5. Xây dựng danh mục: chọn khoảng 100 mã, tính trọng số, áp trần và giữ tiền mặt chưa phân bổ.
  6. Kiểm chứng ngoài mẫu: so với baseline, phân tích chi phí, rủi ro, đóng góp của từng thành phần và độ bất định.

Cutoff là 16:00 America/New_York vào ngày giao dịch cuối quý; giao dịch mô phỏng tại mở phiên kế tiếp. Lịch sử mục tiêu gồm tín hiệu 2010Q1–2025Q4, với outcome cuối đến mở phiên quý II/2026. Phạm vi thực tế phải được xác nhận qua audit dữ liệu trước khi đánh giá performance.

Đầu ra dự kiến

Đầu ra Nội dung
Ranking ngành mỗi quý Điểm tổng hợp và từng trục, thay đổi hạng, độ phủ và quy mô ngành
Danh sách cổ phiếu Candidate pool, scores, thứ hạng, lý do chọn/loại và cờ dữ liệu
Danh mục Holdings, tỷ trọng trước/sau giới hạn, tiền mặt và chi phí
Báo cáo nghiên cứu Ranking metrics, lợi nhuận gross/net, rủi ro, turnover, concentration, kiểm định và giới hạn kết luận
Báo cáo trực quan Visual Portfolio Report (biểu đồ phân bổ tròn, bar chart điểm số composite và bảng hạch toán caps)

Các đầu ra này hiện đã có baseline thực thi và artifact minh chứng trong repository.

Dữ liệu và nguyên tắc kiểm chứng

Ngân sách dữ liệu v1 là 0 USD. Nguồn dự kiến gồm SEC EDGAR as-filed cho fundamentals, yfinance/Stooq cho giá và SEC SIC/Ken French cho phân ngành; Ken French factors phục vụ phân tích bổ trợ. Chi tiết nguồn và tài liệu gốc nằm trong quyết định và nguồn.

Các nguyên tắc chi phối nghiên cứu:

  • Dữ liệu đúng thời điểm: không dùng filing hoặc bản sửa đổi chưa công bố tại cutoff; không ghi đè lịch sử bằng dữ liệu mới nhất.
  • Universe có bằng chứng lịch sử: không dựng backtest chỉ từ các mã còn tồn tại hôm nay; chưa tuyên bố loại được survivorship bias trước audit.
  • Xử lý giá thiếu rõ nguyên nhân: không mặc định mất giá 100%; sự kiện chưa xác minh có thể chặn kết luận performance chính.
  • Khóa thiết kế trước final test: tách research, validation và test; không chọn cấu hình bằng kết quả test.
  • Báo cáo cả tiền mặt và chi phí: tiền mặt nằm trong NAV; giả định chi phí và giới hạn tập trung phải được công bố.

Trần 20%/5% và các tham số khác là mặc định nghiên cứu, chưa được chứng minh tối ưu. Nguồn miễn phí có thể không đủ lịch sử, đặc biệt với mã hủy niêm yết và corporate actions; khi đó cần giới hạn phạm vi hoặc dừng ở kết luận về khả năng xây dựng dữ liệu.

Lộ trình và bước tiếp theo

Giai đoạn Kết quả cần đạt Trạng thái
Thiết kế nghiên cứu Câu hỏi, quy tắc, tham số và tiêu chí kiểm chứng được ghi rõ Đã ghi nhận; một số giả định chờ kiểm chứng
Pilot dữ liệu 40 doanh nghiệp × 4 cutoff cuối năm 2012/2018/2022/2025; đối chiếu filing gốc ít nhất 10 doanh nghiệp Code/replay offline có; ingestion và cổng dữ liệu bị chặn
Audit universe Xác minh membership, identity, ngành, giá và corporate actions trên sample Implementation offline có; audit dữ liệu thật chưa thực hiện
Pipeline và baseline Tái lập snapshots, scores, ranking và danh mục Chưa triển khai
Validation và final test Báo cáo ngoài mẫu, độ bất định và kết luận Q1–Q3 Chưa thực hiện
Mở rộng ML Đánh giá giá trị tăng thêm so với factor baseline Hoãn

Pilot kiểm tra khả năng lấy và tính đúng dữ liệu; audit toàn universe là cổng riêng trước backtest chính. Tiêu chí qua từng cổng nằm trong portfolio và lộ trình nghiên cứu.

Bản đồ tài liệu

Bắt đầu tại bản đồ docs để phân biệt nội dung nghiên cứu, kế hoạch, kỹ thuật, bằng chứng và hướng dẫn sử dụng. Kế hoạch stage 00–07 chỉ rõ thứ tự triển khai; kế hoạch bổ sung tài liệu gắn từng tài liệu cần bàn giao với stage tương ứng.

Tài liệu Đọc khi cần
Technical Xem kiến trúc, data contracts, config/CLI và lineage đã triển khai
Research Xem source assessment, blocked pilot, audit và giới hạn kết luận
Guides Cài môi trường, cấu hình contact và chạy/replay pilot
Tổng quan bộ idea Theo dõi các quyết định thiết kế chính
Concept và output Hiểu câu hỏi nghiên cứu, vai trò score và phạm vi v1
Universe, factors và ranking Tra eligibility, factor dictionary, missing và chuẩn hóa
Hypothesis testing và đánh giá Tra baseline, split thời gian, kiểm định và cách diễn giải
Thông tin được phép dùng Tra timestamp, versioning, identity và corporate actions
Portfolio và lộ trình Tra construction, accounting, chi phí, pilot và acceptance scenarios
Quyết định và nguồn Phân biệt đã chốt, mặc định, chờ kiểm chứng và hoãn
Bảng tham số tổng hợp Tra nhanh giá trị và vị trí quy tắc gốc

Bắt đầu phát triển

Stage 00 nền tảng đã hoàn tất. Máy phát triển cần CPython 3.13 và uv. Từ thư mục gốc, cài môi trường đã khóa và chạy kiểm tra offline:

uv python install 3.13
uv sync --locked --extra dev
uv run frl doctor --config configs/sample.toml
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run mypy src

frl doctor kiểm tra runtime và config. Hệ thống đã hỗ trợ đầy đủ chuỗi lệnh CLI:

  • uv run frl pilot --config configs/pilot.toml: Thu thập và trích xuất chỉ số Point-in-Time.
  • uv run frl rank --input-run artifacts/<run_id>: Chuẩn hóa percentile và xếp hạng 4 trục.
  • uv run frl portfolio --input-ranking artifacts/<run_id>/ranking: Xây dựng danh mục phân bổ vốn tối ưu.
  • uv run python scripts/generate_report.py --ranking-dir artifacts/<run_id>/ranking: Tự động vẽ biểu đồ và xuất báo cáo danh mục trực quan.

frl doctor kiểm tra runtime và config. Hệ thống hỗ trợ chuỗi lệnh CLI hoàn chỉnh từ đầu đến cuối:

  • uv run frl pilot --config configs/pilot.toml: Thu thập và trích xuất chỉ số Point-in-Time.
  • uv run frl rank --input-run artifacts/<run_id>: Chuẩn hóa percentile và xếp hạng 4 trục.
  • uv run frl portfolio --input-ranking artifacts/<run_id>/ranking: Xây dựng danh mục phân bổ vốn tối ưu.
  • uv run frl evaluate --input-ranking artifacts/<run_id>/ranking: Kiểm định thống kê ngoài mẫu Q1, Q2, Q3.
  • uv run frl quarterly --cutoff YYYY-MM-DD --phase signal|reconcile: Vận hành tái cân bằng hàng quý theo SOP.
  • uv run frl replay --input-run artifacts/<run_id>: Tái lập kết quả offline với xác minh SHA-256.

Xem thêm Sổ tay Vận hành Hàng quý, Báo cáo Danh mục Trực quan, Hugging Face Open Dataset, hướng dẫn chạy pipeline và hướng dẫn cloud execution.

About

Research on quarterly fundamental stock and sector ranking, statistical validation, and portfolio construction, with a roadmap toward ML ranking and reranking.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages