Thông tin công ty
Cập nhật lần cuối:
Thảo luậnMục lục
Gợi ý
Các hàm trong mục thông tin công ty chỉ áp dụng với mã chứng khoán của các doanh nghiệp trong nước. Khuyến nghị sử dụng KBS làm nguồn dữ liệu mặc định (ổn định hơn cho Google Colab/Kaggle). Các hàm truy xuất thông tin công ty không cần nhập tham số sau khi đã tạo đối tượng company.
Chọn nguồn dữ liệu
Bạn có thể sử dụng hai nguồn dữ liệu: KBS (khuyến nghị), VCI (không chạy được trên dịch vụ Google Cloud như Google Colab, Kaggle). Thông tin nguồn dữ liệu được cài đặt khi khởi tạo đối tượng python trước khi gọi các hàm truy xuất từng loại thông tin cụ thể.
from vnstock import Company
# Khuyến nghị - Ổn định hơn cho Google Colab/Kaggle
company = Company(symbol='VCB', source='KBS')
# Hoặc sử dụng VCI (dữ liệu đầy đủ hơn)
company = Company(symbol='VCB', source='VCI')
# ⚠️ TCBS đã deprecated, sẽ bị loại bỏ trong v3.5.0
# company = Company(symbol='VCB', source='TCBS')So Sánh Nguồn Dữ Liệu
| Phương Thức | KBS | VCI | Ghi Chú |
|---|---|---|---|
| overview() | ✅ | ✅ | KBS: 30 columns, VCI: 10 columns |
| shareholders() | ✅ | ✅ | KBS: 1 dòng, VCI: nhiều dòng |
| officers() | ✅ | ✅ | VCI có filter_by |
| subsidiaries() | ✅ | ✅ | Cấu trúc khác nhau |
| affiliate() | ✅ | ✅ | Cả hai đều hỗ trợ |
| news() | ✅ | ✅ | KBS có lọc theo trang |
| events() | ✅ | ✅ | KBS có thể rỗng |
| ownership() | ✅ | ❌ | KBS độc quyền |
| capital_history() | ✅ | ❌ | KBS độc quyền |
| insider_trading() | ✅ | ❌ | KBS độc quyền |
| reports() | ❌ | ✅ | VCI độc quyền |
| trading_stats() | ❌ | ✅ | VCI độc quyền |
| ratio_summary() | ❌ | ✅ | VCI độc quyền |
Nguồn dữ liệu KBS (Khuyến nghị)
Thông tin công ty
Gọi hàm
company = Company(symbol='VCI', source='KBS')
company.overview()Dữ liệu mẫu (KBS):
>>> company.overview()
Shape: (1, 30)
Columns: ['business_model', 'symbol', 'founded_date', 'charter_capital',
'number_of_employees', 'listing_date', 'par_value', 'exchange', ...]
>>> company[['symbol', 'charter_capital', 'exchange']].head()
business_model symbol founded_date charter_capital exchange
0 \n- Môi giới chứng khoán và giao dịch cho vay ... VCI 06/08/2007 8501000000000 HOSECổ đông lớn
Gọi hàm
company.shareholders()Dữ liệu mẫu (KBS):
>>> company.shareholders()
name update_date shares_owned ownership_percentage
0 Tô Hải 2025-06-30T00:00:00 128889403 17.95Ban lãnh đạo
Gọi hàm
company.officers()Dữ liệu mẫu (KBS):
>>> company.officers()
Shape: (12, 5)
Columns: ['from_date', 'position', 'name', 'position_en', 'owner_code']
>>> company.officers()[['name', 'position', 'from_date']].head(3)
name position from_date
0 Bà Nguyễn Thanh Phượng CTHĐQT 2007
1 Ông Đinh Quang Hoàn TVHĐQT/Phó TGĐ 2007
2 Ông Tô Hải TGĐ/TVHĐQT 2007Công ty con
Gọi hàm
company.subsidiaries()Dữ liệu mẫu (KBS):
>>> company.subsidiaries()
Shape: (1, 6)
name charter_capital ownership_percent
0 CTCP Quản lý Quỹ Đầu tư Chứng khoán Bản Việt 130000000000 51Tin tức
Gọi hàm
company.news()Dữ liệu mẫu (KBS):
>>> company.news()
Shape: (1, 5)
Columns: ['head', 'article_id', 'publish_time', 'url', ...]
>>> company.news()[['head', 'publish_time']].head()
head article_id publish_time
0 VCI- Thông báo về ngày đăng ký cuối cùng... 1386720 2025-12-31T14:03:26Sự kiện
Gọi hàm
company.events()⚠️ Lưu ý: KBS có thể trả về dữ liệu rỗng, nên dùng VCI nếu cần dữ liệu sự kiện đầy đủ
Cơ cấu cổ đông
Gọi hàm
company.ownership()Dữ liệu mẫu (KBS):
>>> company.ownership()
Shape: (3, 4)
Columns: ['owner_type', 'ownership_percentage', 'shares_owned', 'update_date']
>>> company.ownership()
owner_type ownership_percentage shares_owned update_date
0 CĐ nắm trên 5% số CP 17.95 128889403 2024-12-31T00:00:00
1 CĐ nắm từ 1% - 5% số CP 39.65 284754680 2024-12-31T00:00:00
2 CĐ nắm dưới 1% số CP 42.40 304455397 2024-12-31T00:00:00Lịch sử vốn điều lệ
Gọi hàm
company.capital_history()Dữ liệu mẫu (KBS):
>>> company.capital_history()
Shape: (19, 3)
Columns: ['date', 'charter_capital', 'currency']
>>> company.capital_history().head()
date charter_capital currency
0 2025-12-17 8501000000000 VND
1 2025-03-07 7226000000000 VND
2 2024-06-12 7180994800000 VND
3 2024-10-10 5744694800000 VND
4 2024-05-08 4419000000000 VNDGiao dịch nội bộ
Gọi hàm
company.insider_trading(page=1, page_size=10)Tham số:
page(int, tùy chọn): Số trang (mặc định: 1)page_size(int, tùy chọn): Kích thước trang (mặc định: 10)
⚠️ Lưu ý: Có thể trả về dữ liệu rỗng nếu không có giao dịch nội bộ
Nguồn dữ liệu VCI
Thông tin công ty
Gọi hàm
company.overview()Dữ liệu mẫu:
>>> company.overview()
symbol id issue_share history ... icb_name2 icb_name4 financial_ratio_issue_share charter_capital
0 ACB 67505 4466657912 - Ngày 24/04/1993: Ngân hàng Thương mại Cổ ph... ... Ngân hàng Ngân hàng 4466657900 44666579120000
[1 rows x 10 columns]Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 symbol 1 non-null object
1 id 1 non-null object
2 issue_share 1 non-null int64
3 history 1 non-null object
4 company_profile 1 non-null object
5 icb_name3 1 non-null object
6 icb_name2 1 non-null object
7 icb_name4 1 non-null object
8 financial_ratio_issue_share 1 non-null int64
9 charter_capital 1 non-null int64 Cổ đông lớn
Gọi hàm
company.shareholders()Dữ liệu mẫu:
>>> company.shareholders().head()
id share_holder quantity share_own_percent update_date
0 76437158 Vietnam Enterprise Investments Limited 212880184 0.054809 2024-09-13
1 76432034 Sather Gate Investments Limited 193907186 0.049900 2024-05-15
2 76413536 Estes Investments Limited 83010435 0.049900 2024-05-15
3 76429810 Phạm Thị Thu Hà 285000 0.049900 2016-05-20
4 76434014 Trần Hùng Huy 153062159 0.039400 2025-01-24Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 id 5 non-null object
1 share_holder 5 non-null object
2 quantity 5 non-null int64
3 share_own_percent 5 non-null float64
4 update_date 5 non-null object Ban lãnh đạo
Gọi hàm
company.officers(filter_by='working')Tham số
filter_by: Lọc dữ liệu trả về theo danh sách lãnh đạo đang làm việc hay đã từ nhiệm.working: đang làm việc (mặc định)resigned: đã nghỉ.all: toàn bộ
Dữ liệu mẫu:
>>> company.officers(filter_by='all').head()
id officer_name officer_position position_short_name update_date officer_own_percent quantity type
0 6 Trần Hùng Huy Chủ tịch Hội đồng Quản trị Chủ tịch HĐQT 2025-01-24 0.0394 153062159 đang làm việc
1 7 Đặng Thu Thủy Thành viên Hội đồng Quản trị TV HĐQT 2025-01-24 0.0137 53350036 đang làm việc
2 11 Đặng Phú Vinh Giám đốc khối GĐ Khối 2025-01-24 0.0042 16454507 đang làm việc
3 13 Đỗ Minh Toàn Tổng Giám đốc TGĐ 2025-01-24 0.0008 3202886 đang làm việc
4 8 Nguyễn Thành Long Phó Chủ tịch Hội đồng Quản trị Phó Chủ tịch HĐQT 2025-01-24 0.0004 1647067 đang làm việc2025-01-24 0.0004 1647067Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 id 5 non-null object
1 officer_name 5 non-null object
2 officer_position 5 non-null object
3 position_short_name 5 non-null object
4 update_date 5 non-null object
5 officer_own_percent 5 non-null float64
6 quantity 5 non-null int64
7 type 5 non-null objectCông ty con
Gọi hàm
company.subsidiaries()Tham số
filter_by: Chọn chế độ chỉ lấy thông tinall: gộp kết quả công ty con và công ty liên kết (mặc định)- 'subsidiary': chỉ lấy thông tin công ty con (sở hữu từ 50% trở lên), không bao gồm công ty liên kết (sở hữu < 50%)
Dữ liệu mẫu:
>>> company.subsidiaries()
id sub_organ_code ownership_percent organ_name type
0 21632918 ACBA 1 Công Ty TNHH Quản Lý Nợ Và Khai Thác Tài Sản N... công ty con
1 21632919 ACBL 1 Công Ty TNHH Một Thành Viên Cho Thuê Tài Chính... công ty con
2 21632920 ACBS 1 Công ty TNHH Chứng khoán ACB công ty con
0 21632922 ACBD None CÔNG TY CỔ PHẦN DỊCH VỤ BẢO VỆ NGÂN HÀNG Á CHÂU công ty liên kết
1 21632921 SGGS None Công ty Cổ phần Sài Gòn Kim hoàn ACB- SJC công ty liên kếtKiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 id 5 non-null object
1 sub_organ_code 5 non-null object
2 ownership_percent 3 non-null object
3 organ_name 5 non-null object
4 type 5 non-null objectSự kiện
Gọi hàm
company.events()Dữ liệu mẫu:
>>> company.events().head(3)
id event_title en__event_title ... exright_date event_list_name en__event_list_name
0 18149 ACB- Niêm yết bổ sung 498.821.183 cổ phiếu ACB- Lists additional 498,821,183 shares ... 1753-01-01 Niêm yết thêm Additional Listing
1 18128 Trả cổ tức bằng tiền mặt ... 2010-11-08 Trả cổ tức bằng tiền mặt Cash Dividend
2 18133 Trả cổ tức bằng tiền mặt ... 2012-01-03 Trả cổ tức bằng tiền mặt Cash Dividend
[3 rows x 13 columns]Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 id 3 non-null object
1 event_title 3 non-null object
2 en__event_title 3 non-null object
3 public_date 3 non-null object
4 issue_date 3 non-null object
5 source_url 3 non-null object
6 event_list_code 3 non-null object
7 ratio 1 non-null float64
8 value 1 non-null float64
9 record_date 3 non-null object
10 exright_date 3 non-null object
11 event_list_name 3 non-null object
12 en__event_list_name 3 non-null objectTin tức
Gọi hàm
company.news()Dữ liệu mẫu:
>>> company.news().head(3)
id news_title news_sub_title friendly_sub_title ... ref_price floor ceiling price_change_pct
0 6944486 ACB: Công ty TNHH MTV Nhật Quân HQ đăng ký bá... ... 26200 24400 28000 0.003817
1 6944221 ACB: Nghị quyết HĐQT về phương án phát hành t... ... 26000 24200 27800 0.007692
2 6894216 ACB: Thông báo tổ chức ĐHĐCĐ thường niên năm ... ... 26450 24600 28300 -0.005671
[3 rows x 18 columns]Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 id 3 non-null object
1 news_title 3 non-null object
2 news_sub_title 3 non-null object
3 friendly_sub_title 3 non-null object
4 news_image_url 3 non-null object
5 news_source_link 3 non-null object
6 created_at 0 non-null object
7 public_date 3 non-null int64
8 updated_at 0 non-null object
9 lang_code 3 non-null object
10 news_id 3 non-null object
11 news_short_content 3 non-null object
12 news_full_content 3 non-null object
13 close_price 3 non-null int64
14 ref_price 3 non-null int64
15 floor 3 non-null int64
16 ceiling 3 non-null int64
17 price_change_pct 3 non-null float64Báo cáo phân tích
Gọi hàm
company.reports()Dữ liệu mẫu:
>>> company.reports()
date ... name
0 2025-01-22T00:00:00Z ... ACB - Tập trung vào tăng trưởng tín dụng hơn t...
1 2024-10-24T00:00:00Z ... ACB – NOII thấp hơn dự kiến, ảnh hưởng tiêu cự...
2 2024-09-09T00:00:00Z ... ACB [MUA +35,0%] - Tăng dự báo tăng trưởng tín...
[3 rows x 4 columns]Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 date 3 non-null object
1 description 3 non-null object
2 link 3 non-null object
3 name 3 non-null objectTình hình tài chính
Gọi hàm
company.ratio_summary()Dữ liệu mẫu:
>>> company.ratio_summary()
symbol year_report length_report update_date revenue revenue_growth net_profit net_profit_growth ... rtq10 dividend ebitda ebit le de ccc rtq17
0 ACB 2024 5 1741199572843 50902749000000 -0.027586 16789768000000 0.046435 ... 0 0 0 0 0 0 None 0
[1 rows x 46 columns]Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 symbol 1 non-null object
1 year_report 1 non-null int64
2 length_report 1 non-null int64
3 update_date 1 non-null int64
4 revenue 1 non-null int64
5 revenue_growth 1 non-null float64
6 net_profit 1 non-null int64
7 net_profit_growth 1 non-null float64
8 ebit_margin 1 non-null int64
9 roe 1 non-null float64
10 roic 1 non-null int64
11 roa 1 non-null float64
12 pe 1 non-null float64
13 pb 1 non-null float64
14 eps 1 non-null float64
15 current_ratio 1 non-null int64
16 cash_ratio 1 non-null int64
17 quick_ratio 1 non-null int64
18 interest_coverage 0 non-null object
19 ae 1 non-null float64
20 fae 1 non-null float64
21 net_profit_margin 1 non-null float64
22 gross_margin 1 non-null int64
23 ev 1 non-null int64
24 issue_share 1 non-null int64
25 ps 1 non-null float64
26 pcf 1 non-null float64
27 bvps 1 non-null float64
28 ev_per_ebitda 1 non-null int64
29 at 1 non-null int64
30 fat 1 non-null int64
31 acp 0 non-null object
32 dso 1 non-null int64
33 dpo 1 non-null int64
34 eps_ttm 1 non-null float64
35 charter_capital 1 non-null int64
36 rtq4 1 non-null int64
37 charter_capital_ratio 1 non-null float64
38 rtq10 1 non-null int64
39 dividend 1 non-null int64
40 ebitda 1 non-null int64
41 ebit 1 non-null int64
42 le 1 non-null int64
43 de 1 non-null int64
44 ccc 0 non-null object
45 rtq17 1 non-null int64 Thống kê giao dịch
Gọi hàm
company.trading_stats()Dữ liệu mẫu:
>>> company.trading_stats()
symbol exchange ev ceiling floor ... foreign_room avg_match_volume_2w foreign_holding_room current_holding_ratio max_holding_ratio
0 ACB HOSE 117249769875000 28000 24400 ... 1339997373 8108407 1339997373 0.3 0.3Kiểu dữ liệu
# Column Non-Null Count Dtype
--- ------ -------------- -----
0 symbol 1 non-null object
1 exchange 1 non-null object
2 ev 1 non-null int64
3 ceiling 1 non-null int64
4 floor 1 non-null int64
5 ref_price 1 non-null int64
6 open 1 non-null int64
7 match_price 1 non-null int64
8 close_price 1 non-null int64
9 price_change 1 non-null int64
10 price_change_pct 1 non-null float64
11 high 1 non-null int64
12 low 1 non-null int64
13 total_volume 1 non-null int64
14 high_price_1y 1 non-null int64
15 low_price_1y 1 non-null int64
16 pct_low_change_1y 1 non-null float64
17 pct_high_change_1y 1 non-null float64
18 foreign_volume 1 non-null int64
19 foreign_room 1 non-null int64
20 avg_match_volume_2w 1 non-null int64
21 foreign_holding_room 1 non-null int64
22 current_holding_ratio 1 non-null float64
23 max_holding_ratio 1 non-null float64
Thảo luận