Tra cứu và xuất dữ liệu
Mục lục
Trang này viết cho vnstock_pipeline v6.0.0rc1, bản thử nghiệm. Tên hàm, tham số và cột dữ liệu có thể còn đổi trước ngày phát hành; khi cài, ghi rõ số phiên bản như ở trang Cài đặt. Bản đang phát hành chính thức là v3.1.1, xem tài liệu bản đó.
Các lệnh trên trang này chỉ đọc tệp trên máy. Chúng không cần mạng, không cần đăng nhập.
Xem nhanh một tệp
| Lệnh | Kết quả |
|---|---|
inspect <tệp> | JSON: số dòng, kiểu từng cột, nguồn gốc trong metadata, dòng đầu, dòng cuối |
head <tệp> [--rows 10] | Các dòng đầu, dạng bảng |
tail <tệp> [--rows 10] | Các dòng cuối, dạng bảng |
stats <tệp> | Thống kê mô tả từng cột |
schema file <tệp> | JSON: kiểu từng cột và nguồn gốc |
Lệnh nhận tệp .parquet hoặc .csv.
vnstock-pipeline inspect ~/stock_db/market/ohlcv/1D/FPT.parquet
vnstock-pipeline tail ~/stock_db/market/ohlcv/1D/FPT.parquet --rows 5
vnstock-pipeline stats ~/stock_db/stream/trades/source=dnse/date=2026-11-04/part-00000.parquetinspect và schema file in JSON nên trợ lý AI hay script đọc được ngay. head, tail, stats in bảng để người đọc.
Xuất dữ liệu
vnstock-pipeline export <định dạng> [--dataset ohlcv] [--symbols] [--interval] [--start] [--end] [--out]| Định dạng | Kết quả | Thư mục mặc định |
|---|---|---|
csv | Mỗi mã một tệp <MÃ>.csv (hoặc một tệp mang tên bộ dữ liệu khi không chia theo mã) | <thư mục gốc>/export/csv/ |
parquet | Như trên, dạng Parquet | <thư mục gốc>/export/parquet/ |
excel | Một sổ Excel, mỗi mã một trang (cần phần cài thêm excel) | <thư mục gốc>/export/<bộ dữ liệu>.xlsx |
amibroker | Tệp nhập ASCII cho AmiBroker (mục dưới) | <thư mục gốc>/export/amibroker/ |
vnstock-pipeline export csv --symbols FPT,HPG --interval 1D --start 2026-01-01
vnstock-pipeline export excel --dataset foreign_flow --symbols FPT,HPG --out ~/bao-cao/khoi-ngoai.xlsx
vnstock-pipeline export parquet --dataset index_members--dataset nhận tên bất kỳ bộ dữ liệu nào ở Cấu hình và lưu trữ,
mặc định ohlcv. Lệnh in danh sách tệp đã ghi dạng JSON. Trước mỗi lần xuất, lệnh in lời nhắc rằng dữ liệu xuất ra vẫn
theo điều khoản của nguồn.
Excel không giữ múi giờ, nên mốc giờ được ghi theo giờ Việt Nam, bỏ phần múi giờ.
AmiBroker
Lệnh xuất tệp nhập ASCII theo đúng bố cục bản 3.x đã ghi. Người đang dùng bản 3.x giữ được tệp .format và quy trình
nhập trong AmiBroker.
vnstock-pipeline export amibroker # nến ngày và chỉ số, toàn bộ lịch sử
vnstock-pipeline export amibroker --kinds ohlcv,index,foreign --start 2026-10-01
vnstock-pipeline export amibroker --interval 1m --symbols FPT,HPG --out "C:/AmiBroker/Import"--kinds | Nội dung |
|---|---|
ohlcv | Nến cổ phiếu, mỗi sàn một tệp (HSX, HNX, UPCOM) |
index | Nến chỉ số, một tệp riêng |
foreign | Khối ngoại theo ngày, đặt vào cột giá như bảng dưới |
Tệp CSV đặt tên <loại>_<sàn>_<khung>_<ngày hoặc khoảng ngày>.csv. Ba tệp định dạng đi kèm:
| Tệp | Cột |
|---|---|
vnstock_ohlcv.format | Ticker, Date_YMD, Open, High, Low, Close, Volume (nến ngày) |
vnstock_ohlcv_intraday.format | Thêm Time (nến phút) |
vnstock_flow.format | Khối ngoại: Open = khối lượng mua, High = khối lượng bán, Low = khối lượng ròng, Close = giá trị ròng, Volume = giá trị mua, OpenInt = giá trị bán |
Giá ghi theo nghìn đồng như dữ liệu đã lưu, giống bản 3.x. Sàn của từng mã lấy từ danh mục mã đã nạp bằng run reference.
Nhập vào AmiBroker bằng File, Import ASCII, chọn tệp CSV và tệp .format tương ứng. Bản này chưa có lệnh nạp thẳng qua
OLE hay cập nhật AmiBroker trong phiên như live_amibroker của bản 3.x
(Mức hoàn thiện).
Xuất từ Python
from vnstock_pipeline import Store, export
from vnstock_pipeline.export.amibroker import AmiBrokerExport
store = Store()
export.export_csv(store, "ohlcv", "~/xuat/csv", ["FPT", "HPG"], interval="1D", start="2026-01-01")
export.export_excel(store, "foreign_flow", "~/xuat/khoi-ngoai.xlsx", ["FPT"])
frames = export.frames(store, "ohlcv", ["FPT"], interval="1D") # {"FPT": DataFrame}
AmiBrokerExport(store, "~/xuat/amibroker", interval="1D").run(("ohlcv", "index", "foreign"), start="2026-10-01")