Vnstock Logo

Phân tích tài chính

Cập nhật lần cuối:

Thảo luận

Mục lục

Unified UI

Kể từ phiên bản 4.0, Vnstock sử dụng kiến trúc Unified UI nhằm mang lại giao diện lập trình nhất quán và dễ sử dụng nhất. Dưới đây là tài liệu chính thức cho phiên bản mới.

Nhóm Fundamental cung cấp bộ công cụ để truy xuất dữ liệu tài chính doanh nghiệp đã được chuẩn hóa, giúp bạn thực hiện phân tích cơ bản một cách nhanh chóng.




1. Khởi tạo

Python
from vnstock import Fundamental

# Khởi tạo đối tượng Fundamental
fun = Fundamental()

2. Các lớp và phương thức chi tiết

A. Lớp equity (Cổ phiếu)

Truy xuất báo cáo tài chính và chỉ số định giá của các doanh nghiệp niêm yết.

Phương thứcTham sốMô tả
income_statement()period='year', orient='report', **kwargsKết quả kinh doanh.
balance_sheet()period='year', orient='report', **kwargsBảng cân đối kế toán.
cash_flow()period='year', orient='report', **kwargsLưu chuyển tiền tệ.
ratio()orient='report', **kwargsCác chỉ số tài chính (P/E, P/B, ROE...).

3. Tham số nâng cao

Tham số period (Kỳ báo cáo)

  • 'year': Báo cáo theo năm (Mặc định).
  • 'quarter': Báo cáo theo quý.

Tham số orient (Định dạng kết quả)

Đây là tính năng độc đáo giúp bạn thay đổi cấu trúc DataFrame trả về để phù hợp với mục đích sử dụng:

  • 'report' (Mặc định):
    • Hàng (Rows): Các chỉ tiêu tài chính (Doanh thu, Lợi nhuận...).
    • Cột (Columns): Các kỳ báo cáo (2023, 2022...).
    • Phù hợp để đọc và so sánh trực quan.
  • 'time_series':
    • Hàng (Rows): Các kỳ báo cáo.
    • Cột (Columns): Các chỉ tiêu tài chính.
    • Phù hợp để vẽ biểu đồ hoặc chạy mô hình machine learning.
Python
# Lấy báo cáo dưới dạng chuỗi thời gian để vẽ biểu đồ cho cổ phiếu VCB
fun.equity("VCB").income_statement(period='quarter')

4. Cấu trúc dữ liệu (Data Schema)

Kết quả trả về của các báo cáo (orient='report')

  • item: Tên chỉ tiêu tiếng Việt.
  • item_en: Tên chỉ tiêu tiếng Anh (nếu có).
  • unit: Đơn vị tính.
  • Các cột năm/quý (ví dụ: 2023, 2022...): Giá trị tương ứng.

Các chỉ số tài chính (ratio)

Bao gồm hơn 50 chỉ số quan trọng, ví dụ:

  • ticker: Mã cổ phiếu.
  • quarter / year: Kỳ báo cáo.
  • priceToEarning: P/E.
  • priceToBook: P/B.
  • roe: Tỷ suất lợi nhuận trên vốn chủ sở hữu.
  • roa: Tỷ suất lợi nhuận trên tổng tài sản.

Lưu ý

Hệ thống tự động làm sạch dữ liệu như loại bỏ các hậu tố tên cột dư thừa (ví dụ: "-Năm") để đảm bảo DataFrame của bạn luôn sạch sẽ và sẵn sàng cho tính toán phân tích.

Dữ liệu tài chính trong Bản cộng đồng được cung cấp đầy đủ cho các nhu cầu phân tích cơ bản. Tuy nhiên, nếu bạn cần truy xuất dữ liệu báo cáo tài chính nhiều hơn 8 kỳ mặc định, hãy tham khảo các tính năng mở rộng của Bản tài trợ.

Thảo luận

Đang tải bình luận...