10. Bộ lọc cổ phiếu

Mô tả cách sử dụng thư viện sau khi người dùng đã đăng nhập. Chi tiết được nêu ra ở cuối chương này.

Hàm được sử dụng để lọc nhanh danh sách cổ phiếu dựa trên các điều kiện định nghĩa sẵn, thay vì phải tự xử lý và tính toán dữ liệu từ đầu.

Hàm này đặc biệt hữu ích cho:

• Phân tích đầu tư

• Xây dựng chiến lược screening

• Tạo danh sách cổ phiếu theo tiêu chí định lượng (quant screening)

Cú pháp sử dụng:

from FiinQuantX import FiinSession

username = "REPLACE_WITH_YOUR_USERNAME"
password = "REPLACE_WITH_YOUR_PASSWORD"

client = FiinSession(username=username, password=password).login()

data = client.StockScreening().get(
    filter=filter,
    screenerDate="YYYY-MM-DD",
    exchanges=[...],
    sectors=[...]
)
print(data)

Tham số:

Tên tham số	Mô tả	Kiểu dữ liệu	Mặc định	Bắt buộc
filter	Bộ lọc, là list các điều kiện, mỗi điều kiện là một dict. Chi tiết cách dùng sẽ mô tả ở dưới	list		Có
screenerDate	Ngày sàng lọc (date string có dạng "%Y-%m-%d")	str	datetime.now()	Không
exchanges	Danh sách các sàn cần lọc cổ phiếu	list	Tất cả các sàn	Không
sectors	Danh sách các ngành cần lọc cổ phiếu (Điền các mã ngành như BANKS_L2, OIL_AND_GAS_L2, REAL_ESTATE_L2, CHEMICALS_L2. Chi tiết xem tại bảng tra cứu tên phân ngành truyền vào hàm và ICB Code ở mục 1.2. Danh sách mã theo ngành)	list	Tất cả các ngành	Không

Dữ liệu có các thuộc tính:

Tên thuộc tính	Mô tả	Kiểu dữ liệu
Mã CK	Các mã chứng khoán thỏa mãn điều kiện bộ lọc	str
Tên công ty	Tên gọi doanh nghiệp đầy đủ của các mã chứng khoán tương ứng	str
Sàn	Sàn giao dịch mà các mã chứng khoán tương ứng niêm yết	str
Ngành L2	Tên ngành cấp 2 của các doanh nghiệp tương ứng	str
Các cột động tùy thuộc vào số bộ lọc và kiểu tiêu chí bộ lọc thuộc nhóm Chỉ số chính và Báo cáo tài chính sẽ có cơ chế khác nhau	Số liệu chỉ số tương ứng của từng mã chứng khoán thỏa mãn điều kiện bộ lọc	float

Code mẫu lọc ra các cổ phiếu thuộc sàn HOSE và thuộc các lĩnh vực Hóa chất cấp 2, Bất động sản cấp 2 có tỷ lệ % freefloat trong khoảng từ 0.1 đến 0.5 và số cổ phiếu niêm yết trong khoảng từ 10 đến 200 triệu.

filter = [
    {
        "indicatorName": "% Free Float",
        "conditionValues": [0.1, 0.5]
    },
    {
        "indicatorName": "Số cổ phiếu niêm yết",
        "conditionValues": [10000000, 200000000]
    }
]

data = client.StockScreening().get(
    filter=filter,
    screenerDate="2026-03-17",
    exchanges=["HOSE"],
    sectors=["CHEMICALS_L2","REAL_ESTATE_L2"]
)
print(data)

Kết quả trả ra là 1 dataframe dạng bảng như sau:

Mã CK	Tên công ty	Sàn	Ngành L2	% Free Float 2026-03-17	Số cổ phiếu niêm yết 2026-03-17
PHR	Cao su Phước Hòa	HOSE	Hóa chất	0.3500	135499200.0
SZC	Sonadezi Châu Đức	HOSE	Bất động sản	0.4000	179985860.0
...	...	...	...	...	...
BRC	Cao su Bến Thành	HOSE	Hóa chất	0.1300	12375000.0

Code mẫu lọc ra các cổ phiếu thuộc sàn HOSE và thuộc các lĩnh vực Hóa chất cấp 2, Bất động sản cấp 2 có Doanh thu thuần bán hàng và cung cấp dịch vụ trong cả năm 2025 lớn hơn giá trị doanh thu cao nhất trong 3 năm gần nhất liên tục và Doanh thu thuần bán hàng và cung cấp dịch vụ của riêng quý 4 năm 2025 đạt trên 10.000 tỷ.

filter = [
    {
        "indicatorName":"3. Doanh thu thuần bán hàng và cung cấp dịch vụ",
        "interimCode":"Yearly",
        "indicatorInterimId": "2025",
        "conditionValues":[None,None],
        "additionalCondition": {
            "interimCode": "3_Recent_Continuous_Year",
            "operator": ">",
            "function": "Max"
        }
    },
    {
        "indicatorName":"3. Doanh thu thuần bán hàng và cung cấp dịch vụ",
        "interimCode":"Quarterly",
        "indicatorInterimId": "Q4-2025",
        "conditionValues":[10000000000000,None]
    }
]

data = client.StockScreening().get(
    filter=filter,
    screenerDate="2026-03-17",
    exchanges=["HOSE"],
    sectors=["CHEMICALS_L2","REAL_ESTATE_L2"]
)
print(data)

Kết quả trả ra là 1 dataframe dạng bảng như sau:

Mã CK	Tên công ty	Sàn	Ngành L2	3. Doanh thu thuần bán hàng và cung cấp dịch vụ 2025	3. Doanh thu thuần bán hàng và cung cấp dịch vụ 3 năm liên tiếp trước kỳ sàng lọc Lớn nhất của 2025	3. Doanh thu thuần bán hàng và cung cấp dịch vụ Q4-2025
VIC	VinGroup	HOSE	Bất động sản	3.3277E+14	1.89068E+14	1.63159E+14
VHM	Vinhomes	HOSE	Bất động sản	1.54102E+14	1.03557E+14	1.0301E+14