FinAgent là nền tảng hỗ trợ phân tích tài chính và thị trường chứng khoán, cung cấp dữ liệu chi tiết cùng các công cụ mạnh mẽ giúp nhà đầu tư theo dõi, đánh giá và ra quyết định hiệu quả.
Project description
FinAgentVN
FinAgentVN là thư viện Python cung cấp dữ liệu và công cụ hỗ trợ tài chính cho các nhà đầu tư và phân tích thị trường chứng khoán.
Cài đặt
Cài đặt thư viện mới:
pip install finagentvn
Cập nhật phiên bản mới:
pip install --upgrade finagentvn
Sử dụng
from finagentvn import *
Hướng dẫn sử dụng
Thư viện FinAgentVN được chia làm các mảng chính:
_ stock: dữ liệu về cổ phiếu được niêm yết trên các sàn giao dịch chứng khoán Việt Nam.
_ exchange: dữ liệu về các sàn giao dịch chứng khoán Việt Nam.
_ indice: dữ liệu về các chỉ số chứng khoán.
_ fund: dữ liệu về chứng chỉ quỹ trên các sàn giao dịch chứng khoán Việt Nam.
_ macro_economic: dữ liệu về các chỉ số kinh tế vĩ mô của Việt Nam.
_ other: dữ liệu về các chỉ số khác vd: vàng, dầu thô,...
stock : Cổ phiếu Việt Nam
Dữ liệu về cổ phiếu được chia ra làm 4 mục: thị trường, tài chính, cổ đông, tin tức - sự kiện.
market : Dữ liệu thị trường
1. Thông tin mã cổ phiếu:
Cung cấp thông tin về cổ phiếu thuộc sàn giao dịch nào, tên và ngành của cổ phiếu đó.
stock_info()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.stock_info()
hoặc gọi nhanh:
df = stock.get_stock_info(symbol = 'ACB')
2. Lịch sử ohlcv:
Cung cấp dữ liệu lịch sử theo ngày hoặc theo phút của giá đóng cửa, giá mở cửa, giá cao nhất, giá thấp nhất và khối lượng giao dịch của cổ phiếu đó.
history(interval, start, end)
interval:
'minutes''hours''days''months'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.history(interval = 'days', start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = stock.get_history(symbol = 'ACB', interval = 'days', start = '2020-01-01', end = '2023-01-01')
3. Lịch sử khớp lệnh:
Danh sách lịch sử khớp lệnh:
Cung cấp danh sách lịch sử các lệnh giao dịch đã khớp tính theo từng lệnh của cổ phiếu.
intraday()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.intraday()
hoặc gọi nhanh:
df = stock.get_intraday(symbol = 'ACB')
Phân loại khớp lệnh theo nhà đầu tư:
Cung cấp danh sách lịch sử khớp lệnh tính theo nhà đầu tư và phân loại khớp lệnh thành 3 loại: Cá mập, Sói già, và Cừu non.
intraday_order()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.intraday_order()
hoặc gọi nhanh:
df = stock.get_intraday_order(symbol = 'ACB')
4. Thông tin giá cổ phiếu:
Danh sách giá cổ phiếu:
Cung cấp lịch sử dữ liệu chi tiết về giá và khối lượng giao dịch của cổ phiếu theo ngày, tháng, quý, năm.
price_history(interval, start = None, end = None)
interval:
'days': start = 2023-01-01 ; end = 2026-12-31'months': start = 2023-01 ; end = 2026-12'quarters': start = 2023 ; end = 2026'years': start = 2023 ; end = 2026
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.price_history(interval = 'days', start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = stock.get_price_history(symbol = 'ACB', interval = 'days', start = '2020-01-01', end = '2023-01-01')
Tổng hợp giá cổ phiếu:
Cung cấp dữ liệu tổng đến hiện tại và trung bình theo ngày, tháng, quý, năm.
price_history_summary(interval)
interval:
'days''months''quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.price_history_summary(interval = 'days')
hoặc gọi nhanh:
df = stock.get_price_history_summary(symbol = 'ACB', interval = 'days')
5. Nước ngoài:
Lịch sử giao dịch nước ngoài:
Cung cấp dữ liệu giao dịch với nước ngoài của cổ phiếu.
foreign_history(interval, start = None, end = None)
interval:
'days': start = 2023-01-01 ; end = 2026-12-31'months': start = 2023-01 ; end = 2026-12'quarters': start = 2023 ; end = 2026'years': start = 2023 ; end = 2026
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.foreign_history(interval = 'days', start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = stock.get_foreign_history(symbol = 'ACB', interval = 'days', start = '2020-01-01', end = '2023-01-01')
Tổng hợp giao dịch nước ngoài:
Cung cấp dữ liệu tổng đến hiện tại và trung bình theo ngày, tháng, quý, năm.
foreign_history_summary(interval)
interval:
'days''months''quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.foreign_history_summary(interval = 'days')
hoặc gọi nhanh:
df = stock.get_foreign_history_summary(symbol = 'ACB', interval = 'days')
6. Tự doanh
Lịch sử giao dịch tự doanh:
Cung cấp dữ liệu giao dịch tự doanh của cổ phiếu.
proprietary_history(interval, start = None, end = None)
interval:
'days': start = 2023-01-01 ; end = 2026-12-31'months': start = 2023-01 ; end = 2026-12'quarters': start = 2023 ; end = 2026'years': start = 2023 ; end = 2026
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.proprietary_history(interval = 'days', start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = stock.get_proprietary_history(symbol = 'ACB', interval = 'days', start = '2020-01-01', end = '2023-01-01')
Tổng hợp giao dịch tự doanh:
Cung cấp dữ liệu tổng đến hiện tại và trung bình theo ngày, tháng, quý, năm.
proprietary_history_summary(interval)
interval:
'days''months''quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.proprietary_history_summary(interval = 'days')
hoặc gọi nhanh:
df = stock.get_proprietary_history_summary(symbol = 'ACB', interval = 'days')
7. Cung cầu
Cung cấp dữ liệu đặt mua, đặt bán, các giao dịch mua bán chưa khớp.
demand_history(interval, start, end)
interval:
'days': start = 2023-01-01 ; end = 2026-12-31'months': start = 2023-01 ; end = 2026-12'quarters': start = 2023 ; end = 2026'years': start = 2023 ; end = 2026
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.demand_history(interval = 'days', start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = stock.get_demand_history(symbol = 'ACB', interval = 'days', start = '2020-01-01', end = '2023-01-01')
financial : Dữ liệu tài chính
1. Chỉ số tài chính:
finance_ratio(interval)
interval:
'quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.finance_ratio(interval = 'years')
hoặc gọi nhanh:
df = stock.get_finance_ratio(symbol = 'ACB', interval = 'years')
2. Bảng cân đối kế toán:
balance_sheet(interval)
interval:
'quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.balance_sheet(interval = 'years')
hoặc gọi nhanh:
df = stock.get_balance_sheet(symbol = 'ACB', interval = 'years')
3. Kết quả kinh doanh:
income_statement(interval)
interval:
'quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.income_statement(interval = 'years')
hoặc gọi nhanh:
df = stock.get_income_statement(symbol = 'ACB', interval = 'years')
4. Báo cáo lưu chuyển tiền tệ:
cash_flow(interval)
interval:
'quarters''years'
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.cash_flow(interval = 'years')
hoặc gọi nhanh:
df = stock.get_cash_flow(symbol = 'ACB', interval = 'years')
shareholder : Dữ liệu cổ đông
1. Thông tin cổ đông:
Cung cấp danh sách các cổ đông, chức vụ, số lượng cổ phiếu sở hữu,...
shareholders_info()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.shareholders_info()
hoặc gọi nhanh:
df = stock.get_shareholders_info(symbol = 'ACB')
2. Cấu trúc cổ đông:
Cung cấp dữ liệu số lượng cổ phiếu phát hành và số lượng cổ phiếu các bên nắm giữ.
shareholders_structure()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.shareholders_structure()
hoặc gọi nhanh:
df = stock.get_shareholders_structure(symbol = 'ACB')
3. Các công ty liên quan:
Cung cấp dữ liệu về các công ty con và công ty liên kết cũng như tỷ lệ nắm giữ của cổ phiếu đó.
shareholders_relationship()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.shareholders_relationship()
hoặc gọi nhanh:
df = stock.get_shareholders_relationship(symbol = 'ACB')
4. Giao dịch nội bộ:
Cung cấp dữ liệu về các giao dịch cổ phiếu có liên quan đến nội bộ công ty.
insider_trans()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.insider_trans()
hoặc gọi nhanh:
df = stock.get_insider_trans(symbol = 'ACB')
event : Dữ liệu tin tức & sự kiện
1. Tin tức:
Cung cấp dữ liệu tin tức liên quan đến cổ phiếu.
news()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.news()
hoặc gọi nhanh:
df = stock.get_news(symbol = 'ACB')
2. Cổ tức:
Cung cấp dữ liệu về cổ tức, lịch trả cổ tức, ... của cổ phiếu.
dividend()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.dividend()
hoặc gọi nhanh:
df = stock.get_dividend(symbol = 'ACB')
3. Đại hội đồng cổ đông:
Cung cấp thông tin về lịch tổ chức Đại hội đồng cổ đông thường niên.
general_meeting()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.general_meeting()
hoặc gọi nhanh:
df = stock.get_general_meeting(symbol = 'ACB')
4. Sự kiện khác:
Cung cấp thông tin niêm yết và các sự kiện khác của cổ phiếu.
other_event()
Cách gọi hàm sử dụng:
cp = stock(symbol = 'ACB')
df = cp.other_event()
hoặc gọi nhanh:
df = stock.get_other_event(symbol = 'ACB')
exchange : Sàn chứng khoán Việt Nam
Danh sách top cổ phiếu tăng/giảm:
get_top_stock(exchange, up_down)
exchange:
'HOSE''HNX''UPCOM'
up_down:
'up''down'
Cách gọi hàm sử dụng:
ex = exchange(exchange = 'HOSE')
df = ex.top_stock(up_down = 'up')
hoặc gọi nhanh:
df = exchange.get_top_stock(exchange = 'HOSE', up_down = 'up')
indice : chỉ số chứng khoán Việt Nam
Dữ liệu chỉ số chứng khoán Việt Nam:
overview_market(start, end)
Cách gọi hàm sử dụng:
ind = indice(indice = 'VNINDEX')
df = ind.overview_market(start = '2024-01-01', end = '2025-01-01')
hoặc gọi nhanh:
df = indice.get_overview_market(indice = 'VNINDEX', start = '2024-01-01', end = '2025-01-01')
indice:
'VNINDEX''VN30''HNXINDEX''UPCOMINDEX'...
fund : chứng chỉ quỹ
1. Danh sách các chứng chỉ quỹ:
fund_listing()
Cách gọi hàm sử dụng:
df = fund.fund_listing()
2. Tăng trưởng tài sản ròng (NAV) của quỹ:
nav_history(start = None, end = None)
Cách gọi hàm sử dụng:
Dùng tên quỹ:
f = fund(fund = 'BMFF')
df = f.nav_history(start = '2020-01-01', end = '2023-01-01')
hoặc id quỹ:
f = fund(fund = '87') hoặc f = fund(fund = 87)
df = f.nav_history(start = '2020-01-01', end = '2023-01-01')
hoặc gọi nhanh:
df = fund.get_nav_history(fund = 'BMFF', start = '2020-01-01', end = '2023-01-01')
df = fund.get_nav_history(fund = '87', start = '2020-01-01', end = '2023-01-01')
df = fund.get_nav_history(fund = 87, start = '2020-01-01', end = '2023-01-01')
fund: Xem ở fund_listing()
3. Danh mục đầu tư lớn:
top_holding()
Cách gọi hàm sử dụng:
Dùng tên quỹ:
f = fund(fund = 'BMFF')
df = f.top_holding()
hoặc id quỹ:
f = fund(fund = '87') hoặc f = fund(fund = 87)
df = f.top_holding()
hoặc gọi nhanh:
df = fund.get_top_holding(fund = 'BMFF')
df = fund.get_top_holding(fund = '87')
df = fund.get_top_holding(fund = 87)
fund: Xem ở fund_listing()
4. Phân bổ quỹ theo tài sản nắm giữ:
asset_holding()
Cách gọi hàm sử dụng:
Dùng tên quỹ:
f = fund(fund = 'BMFF')
df = f.asset_holding()
hoặc id quỹ:
f = fund(fund = '87') hoặc f = fund(fund = 87)
df = f.asset_holding()
hoặc gọi nhanh:
df = fund.get_asset_holding(fund = 'BMFF')
fund: Xem ở fund_listing()
5. Phân bổ quỹ theo ngành:
industries_holding()
Cách gọi hàm sử dụng:
Dùng tên quỹ:
f = fund(fund = 'BMFF')
df = f.industries_holding()
hoặc id quỹ:
f = fund(fund = '87') hoặc f = fund(fund = 87)
df = f.industries_holding()
hoặc gọi nhanh:
df = fund.get_industries_holding(fund = 'BMFF')
df = fund.get_industries_holding(fund = '87')
df = fund.get_industries_holding(fund = 87)
fund: Xem ở fund_listing()
macro_economic: Chỉ số kinh tế vĩ mô Việt Nam
general(interval, start, end)
interval:
'days': start = 2023-01-01 ; end = 2026-12-31'months': start = 2023-01 ; end = 2026-12'quarters': start = 2023 ; end = 2026'years': start = 2023 ; end = 2026
indicator:
'GDP','CPI', ...- hoặc ID:
43,52, ...
Danh sách chỉ số vĩ mô
| ID | Indicator | Symbol | interval |
|---|---|---|---|
| 43 | GDP | GDP | quarters , years |
| 52 | CPI | CPI | months , years |
| 46 | Sản xuất công nghiệp | IIP | months , years |
| 47 | Bán lẻ | RET | months , quarters , years |
| 48 | Xuất nhập khẩu | TRADE | months , years |
| 50 | FDI | FDI | months , years |
| 51 | Tín dụng | CREDIT | months , years |
| 53 | Tỷ giá | FX | days , years |
| 55 | Dân số và lao động | LABOR | years |
Cách gọi hàm sử dụng:
Dùng id:
m = macro_economic(indicator = 51)
df = m.general(interval = 'years', start = '2021', end = '2024')
hoặc dùng tên chỉ số:
m = macro_economic(indicator = 'Tín dụng')
df = m.general(interval = 'years', start = '2021', end = '2024')
hoặc dùng symbol:
m = macro_economic(indicator = 'CREDIT') # Tín dụng
df = m.general(interval = 'years', start = '2021', end = '2024')
hoặc gọi nhanh:
df = macro_economic.get_general(indicator = 'GDP', interval = 'years', start = '2021', end = '2024')
df = macro_economic.get_general(indicator = 43, interval = 'quarters', start = '2020', end = '2023')
df = macro_economic.get_general(indicator = 'CREDIT', interval = 'quarters', start = '2020', end = '2023')
other : các chỉ số khác
Dữ liệu các chỉ số khác:
exchange_other()
Cách gọi hàm sử dụng:
df = other.exchange_other()
Giấy phép
Thư viện này được phát hành theo giấy phép MIT. Vui lòng xem tệp LICENSE để biết thêm chi tiết.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file finagentvn-0.0.5.tar.gz.
File metadata
- Download URL: finagentvn-0.0.5.tar.gz
- Upload date:
- Size: 36.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c595b74be532adde568b175181c88a8b2b03b02ad2861c47fcc3ed62098f316d
|
|
| MD5 |
70a1c432c4eb7c32f4f1674ea984e63c
|
|
| BLAKE2b-256 |
40482f3a08fb4834b43efaf0cb3f40a4684479c2bbfdc5c472366517b56e170f
|
File details
Details for the file finagentvn-0.0.5-py3-none-any.whl.
File metadata
- Download URL: finagentvn-0.0.5-py3-none-any.whl
- Upload date:
- Size: 33.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
59066bb95ec72ee95ec40691d427162702264ac484b105222d2aac5978e20d31
|
|
| MD5 |
359a7033382722a35bdb80d46e66a028
|
|
| BLAKE2b-256 |
33a6f291868dc91035757f1e4fc0fca4c83474c8dd82cfa507f8e1d2f12d16ff
|
