# 1.8. Lấy dữ liệu giao dịch theo nhà đầu tư Mô tả cách sử dụng thư viện sau khi người dùng đã đăng nhập. Các ví dụ chi tiết được nêu ra ở cuối chương này. ```python data = client.PriceStatistics().get_value_by_investor( tickers=tickers, from_date=from_date, to_date=to_date ) ``` **Tham số:** | Tên tham số | Mô tả | Kiểu dữ liệu | Mặc định | Bắt buộc | | ----------- | ----------------------------------- | ------------- | -------------- | -------- | | tickers | Danh sách mã được viết in hoa. | str hoặc list | | Có | | from\_date | Mốc thời gian lấy dữ liệu xa nhất. | str | | Có | | to\_date | Mốc thời gian lấy dữ liệu gần nhất. | str | datetime.now() | Không | Class nhận dữ liệu là PriceStatistics và có phương thức nhận dữ liệu là get\_value\_by\_investor() ```python data = client.PriceStatistics().get_value_by_investor( tickers=tickers, from_date="2025-10-01", to_date="2025-10-08" ) print(data) ``` Dữ liệu có các thuộc tính: | Tên thuộc tính | Mô tả | Kiểu dữ liệu | | ------------------------------------------ | -------------------------------------------- | ------------ | | ticker | Tên mã. | str | | timestamp | Thời gian giao dịch | str | | totalTrade | Tổng số lệnh giao dịch | int | | totalBuyTrade | Tổng số lệnh mua | int | | totalSellTrade | Tổng số lệnh bán | int | | totalBuyTradeVolume | Tổng khối lượng mua | int | | totalSellTradeVolume | Tổng khối lượng bán | int | | foreignBuyVolumeMatched | KL mua khớp lệnh của NĐT nước ngoài | int | | foreignBuyValueMatched | Giá trị mua khớp lệnh của NĐT nước ngoài | int | | foreignSellVolumeMatched | KL bán khớp lệnh của NĐT nước ngoài | int | | foreignSellValueMatched | Giá trị bán khớp lệnh của NĐT nước ngoài | int | | foreignBuyVolumeDeal | KL mua thỏa thuận của NĐT nước ngoài | int | | foreignBuyValueDeal | Giá trị mua thỏa thuận của NĐT nước ngoài | int | | foreignSellVolumeDeal | KL bán thỏa thuận của NĐT nước ngoài | int | | foreignSellValueDeal | Giá trị bán thỏa thuận của NĐT nước ngoài | int | | foreignIndividualBuyTradingMatchValue | Giá trị mua khớp lệnh của cá nhân nước ngoài | int | | foreignInstitutionalBuyTradingMatchValue | Giá trị mua khớp lệnh của tổ chức nước ngoài | int | | foreignIndividualSellTradingMatchValue | Giá trị bán khớp lệnh của cá nhân nước ngoài | int | | foreignInstitutionalSellTradingMatchValue | Giá trị bán khớp lệnh của tổ chức nước ngoài | int | | foreignIndividualBuyTradingMatchVolume | KL mua khớp lệnh của cá nhân nước ngoài | int | | foreignInstitutionalBuyTradingMatchVolume | KL mua khớp lệnh của tổ chức nước ngoài | int | | foreignIndividualSellTradingMatchVolume | KL bán khớp lệnh của cá nhân nước ngoài | int | | foreignInstitutionalSellTradingMatchVolume | KL bán khớp lệnh của tổ chức nước ngoài | int | | localIndividualBuyValue | Giá trị mua của cá nhân trong nước | int | | localIndividualBuyVolume | KL mua của cá nhân trong nước | int | | localIndividualSellVolume | KL bán của cá nhân trong nước | int | | localIndividualSellValue | Giá trị bán của cá nhân trong nước | int | | localInstitutionalBuyVolume | KL mua của tổ chức trong nước | int | | localInstitutionalBuyValue | Giá trị mua của tổ chức trong nước | int | | localInstitutionalSellVolume | KL bán của tổ chức trong nước | int | | localInstitutionalSellValue | Giá trị bán của tổ chức trong nước | int | | localIndividualBuyMatchVolume | KL mua khớp lệnh của cá nhân trong nước | int | | localIndividualBuyMatchValue | Giá trị mua khớp lệnh của cá nhân trong nước | int | | localIndividualSellMatchVolume | KL bán khớp lệnh của cá nhân trong nước | int | | localIndividualSellMatchValue | Giá trị bán khớp lệnh của cá nhân trong nước | int | | localIndividualSellMatchValue | Giá trị bán khớp lệnh của cá nhân trong nước | int | | localInstitutionalBuyMatchVolume | KL mua khớp lệnh của tổ chức trong nước | int | | localInstitutionalBuyMatchValue | Giá trị mua khớp lệnh của tổ chức trong nước | int | | localInstitutionalSellMatchVolume | KL bán khớp lệnh của tổ chức trong nước | int | | localInstitutionalSellMatchValue | Giá trị bán khớp lệnh của tổ chức trong nước | int | | proprietaryTotalMatchBuyTradeVolume | KL mua khớp lệnh của tự doanh | int | | proprietaryTotalMatchBuyTradeValue | Giá trị mua khớp lệnh của tự doanh | int | | proprietaryTotalMatchSellTradeValue | Giá trị bán khớp lệnh của tự doanh | int | | proprietaryTotalMatchSellTradeVolume | KL bán khớp lệnh của tự doanh | int | | proprietaryTotalBuyTradeVolume | Tổng KL mua của tự doanh | int | | proprietaryTotalBuyTradeValue | Tổng giá trị mua của tự doanh | int | | proprietaryTotalSellTradeValue | Tổng giá trị bán của tự doanh | int | | proprietaryTotalSellTradeVolume | Tổng KL bán của tự doanh | int | | proprietaryTotalDealBuyTradeVolume | KL mua thỏa thuận của tự doanh | int | | proprietaryTotalDealBuyTradeValue | Giá trị mua thỏa thuận của tự doanh | int | | proprietaryTotalDealSellTradeValue | Giá trị bán thỏa thuận của tự doanh | int | | proprietaryTotalDealSellTradeVolume | KL bán thỏa thuận của tự doanh | int | Ví dụ: 
from FiinQuantX import FiinSession

username = 'REPLACE_WITH_YOUR_USER_NAME'
password = 'REPLACE_WITH_YOUR_PASS_WORD'

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

tickers = ["HPG", "MWG"]

data = client.PriceStatistics().get_value_by_investor(
    tickers=tickers,
    from_date="2025-10-01",
    to_date="2025-10-08"
)
print(data)