1.5. Lấy dữ liệu room NĐTNN

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.

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.

data = client.PriceStatistics().get_foreign(
    tickers=tickers,
    time_filter=time_filter,
    from_date=from_date,
    to_date=to_date
).get_data()

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ó
time_filter	Tần suất lấy dữ liệu, có thể lấy dữ liệu theo Ngày, Tuần, Tháng, Quý, Năm. Truyền vào 1 trong 5 giá trị "Daily", "Weekly", "Monthly", "Quarterly", "Yearly".	str		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_Foreign()

data = client.PriceStatistics().get_foreign(
    tickers=tickers,
    time_filter="Daily",
    from_date="2025-08-20",
    to_date="2025-08-27"
)
print(data)

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

• time_filter="Daily"

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
foreignBuyVolumeTotal	Khối lượng NĐTNN mua vào	float
foreignSellVolumeTotal	Khối lượng NĐTNN bán ra	float
foreignBuyValueTotal	Giá trị NĐTNN mua vào	int
foreignSellValueTotal	Giá trị NĐTNN bán ra	int
foreignNetVolumeTotal	Khối lượng NĐTNN mua/bán ròng	float
foreignNetValueTotal	Giá trị NĐTNN mua/bán ròng	int
foreignBuyVolumeMatched	Khối lượng NĐTNN mua khớp lệnh	float
foreignSellVolumeMatched	Khối lượng NĐTNN bán khớp lệnh	float
foreignBuyValueMatched	Giá trị NĐTNN mua khớp lệnh	int
foreignSellValueMatched	Giá trị NĐTNN bán khớp lệnh	int
foreignBuyVolumeDeal	Khối lượng NĐTNN mua thỏa thuận	float
foreignSellVolumeDeal	Khối lượng NĐTNN bán thỏa thuận	float
foreignBuyValueDeal	Giá trị NĐTNN mua thỏa thuận	int
foreignSellValueDeal	Giá trị NĐTNN bán thỏa thuận	int
foreignCurrentRoom	Giá trị room hiện hại của NĐTNN	int
foreignTotalRoom	Giá trị room tối đa của NĐTNN	int
percentForeignTotalRoom	% room hiện tại của NĐTNN	float
foreignOwned	Giá trị sở hữu của NĐTNN	int
percentForeignOwned	% sở hữu của NĐTNN	float

• time_filter="Weekly"

Tên thuộc tính	Mô tả	Kiểu dữ liệu
ticker	Tên mã.	str
week	Tuần trong năm	int
year	Năm	int
foreignBuyVolumeTotal	Khối lượng NĐTNN mua vào	float
foreignSellVolumeTotal	Khối lượng NĐTNN bán ra	float
foreignBuyValueTotal	Giá trị NĐTNN mua vào	int
foreignSellValueTotal	Giá trị NĐTNN bán ra	int
foreignNetVolumeTotal	Khối lượng NĐTNN mua/bán ròng	float
foreignNetValueTotal	Giá trị NĐTNN mua/bán ròng	int
foreignBuyVolumeMatched	Khối lượng NĐTNN mua khớp lệnh	float
foreignSellVolumeMatched	Khối lượng NĐTNN bán khớp lệnh	float
foreignBuyValueMatched	Giá trị NĐTNN mua khớp lệnh	int
foreignSellValueMatched	Giá trị NĐTNN bán khớp lệnh	int
foreignBuyVolumeDeal	Khối lượng NĐTNN mua thỏa thuận	float
foreignSellVolumeDeal	Khối lượng NĐTNN bán thỏa thuận	float
foreignBuyValueDeal	Giá trị NĐTNN mua thỏa thuận	int
foreignSellValueDeal	Giá trị NĐTNN bán thỏa thuận	int
foreignCurrentRoom	Giá trị room hiện hại của NĐTNN	int
foreignTotalRoom	Giá trị room tối đa của NĐTNN	int
percentForeignTotalRoom	% room hiện tại của NĐTNN	float
foreignOwned	Giá trị sở hữu của NĐTNN	int
percentForeignOwned	% sở hữu của NĐTNN	float

• time_filter="Monthly"

Tên thuộc tính	Mô tả	Kiểu dữ liệu
ticker	Tên mã.	str
month	Tháng trong năm	int
year	Năm	int
foreignBuyVolumeTotal	Khối lượng NĐTNN mua vào	float
foreignSellVolumeTotal	Khối lượng NĐTNN bán ra	float
foreignBuyValueTotal	Giá trị NĐTNN mua vào	int
foreignSellValueTotal	Giá trị NĐTNN bán ra	int
foreignNetVolumeTotal	Khối lượng NĐTNN mua/bán ròng	float
foreignNetValueTotal	Giá trị NĐTNN mua/bán ròng	int
foreignBuyVolumeMatched	Khối lượng NĐTNN mua khớp lệnh	float
foreignSellVolumeMatched	Khối lượng NĐTNN bán khớp lệnh	float
foreignBuyValueMatched	Giá trị NĐTNN mua khớp lệnh	int
foreignSellValueMatched	Giá trị NĐTNN bán khớp lệnh	int
foreignBuyVolumeDeal	Khối lượng NĐTNN mua thỏa thuận	float
foreignSellVolumeDeal	Khối lượng NĐTNN bán thỏa thuận	float
foreignBuyValueDeal	Giá trị NĐTNN mua thỏa thuận	int
foreignSellValueDeal	Giá trị NĐTNN bán thỏa thuận	int
foreignCurrentRoom	Giá trị room hiện hại của NĐTNN	int
foreignTotalRoom	Giá trị room tối đa của NĐTNN	int
percentForeignTotalRoom	% room hiện tại của NĐTNN	float
foreignOwned	Giá trị sở hữu của NĐTNN	int
percentForeignOwned	% sở hữu của NĐTNN	float

• time_filter="Quarterly"

Tên thuộc tính	Mô tả	Kiểu dữ liệu
ticker	Tên mã.	str
quarter	Quý trong năm	int
year	Năm	int
foreignBuyVolumeTotal	Khối lượng NĐTNN mua vào	float
foreignSellVolumeTotal	Khối lượng NĐTNN bán ra	float
foreignBuyValueTotal	Giá trị NĐTNN mua vào	int
foreignSellValueTotal	Giá trị NĐTNN bán ra	int
foreignNetVolumeTotal	Khối lượng NĐTNN mua/bán ròng	float
foreignNetValueTotal	Giá trị NĐTNN mua/bán ròng	int
foreignBuyVolumeMatched	Khối lượng NĐTNN mua khớp lệnh	float
foreignSellVolumeMatched	Khối lượng NĐTNN bán khớp lệnh	float
foreignBuyValueMatched	Giá trị NĐTNN mua khớp lệnh	int
foreignSellValueMatched	Giá trị NĐTNN bán khớp lệnh	int
foreignBuyVolumeDeal	Khối lượng NĐTNN mua thỏa thuận	float
foreignSellVolumeDeal	Khối lượng NĐTNN bán thỏa thuận	float
foreignBuyValueDeal	Giá trị NĐTNN mua thỏa thuận	int
foreignSellValueDeal	Giá trị NĐTNN bán thỏa thuận	int
foreignCurrentRoom	Giá trị room hiện hại của NĐTNN	int
foreignTotalRoom	Giá trị room tối đa của NĐTNN	int
percentForeignTotalRoom	% room hiện tại của NĐTNN	float
foreignOwned	Giá trị sở hữu của NĐTNN	int
percentForeignOwned	% sở hữu của NĐTNN	float

• time_filter="Yearly"

Tên thuộc tính	Mô tả	Kiểu dữ liệu
ticker	Tên mã.	str
year	Năm	int
foreignBuyVolumeTotal	Khối lượng NĐTNN mua vào	float
foreignSellVolumeTotal	Khối lượng NĐTNN bán ra	float
foreignBuyValueTotal	Giá trị NĐTNN mua vào	int
foreignSellValueTotal	Giá trị NĐTNN bán ra	int
foreignNetVolumeTotal	Khối lượng NĐTNN mua/bán ròng	float
foreignNetValueTotal	Giá trị NĐTNN mua/bán ròng	int
foreignBuyVolumeMatched	Khối lượng NĐTNN mua khớp lệnh	float
foreignSellVolumeMatched	Khối lượng NĐTNN bán khớp lệnh	float
foreignBuyValueMatched	Giá trị NĐTNN mua khớp lệnh	int
foreignSellValueMatched	Giá trị NĐTNN bán khớp lệnh	int
foreignBuyVolumeDeal	Khối lượng NĐTNN mua thỏa thuận	float
foreignSellVolumeDeal	Khối lượng NĐTNN bán thỏa thuận	float
foreignBuyValueDeal	Giá trị NĐTNN mua thỏa thuận	int
foreignSellValueDeal	Giá trị NĐTNN bán thỏa thuận	int
foreignCurrentRoom	Giá trị room hiện hại của NĐTNN	int
foreignTotalRoom	Giá trị room tối đa của NĐTNN	int
percentForeignTotalRoom	% room hiện tại của NĐTNN	float
foreignOwned	Giá trị sở hữu của NĐTNN	int
percentForeignOwned	% sở hữu của NĐTNN	float

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_foreign(
    tickers=tickers,
    time_filter="Daily",
    from_date="2025-08-20",
    to_date="2025-08-27"
)
print(data)