Toàn bộ lệnh

Shell

vnstock-pipeline [--config TỆP] [--base THƯ_MỤC] [--debug] <nhóm> <lệnh> [tham số]

Tham số chung	Ý nghĩa
`--config`	Tệp `pipeline.toml` khác mặc định `~/.vnstock/config/pipeline.toml`
`--base`	Thư mục gốc cho lần chạy này, ghi đè `base_path`
`--debug`	Ghi nhật ký chi tiết; lỗi của nguồn in kèm chi tiết kỹ thuật
`--version`	Phiên bản đang cài

Đầu ra cho script và trợ lý AI

Mọi lệnh in JSON ra đầu ra chuẩn, trừ store tree, head, tail, stats in bảng cho người đọc.
Lời nhắc, cảnh báo, dòng nhắc cập nhật in ra đầu ra lỗi, nên không lẫn vào JSON.
Mã thoát:
- 0: thành công;
- 1: có đơn vị việc lỗi hoặc bị cách ly (lệnh run), lỗi quyền (PIPELINE_…, VNSTOCK_…), hoặc lỗi do nguồn trả về;
- 2: sai cú pháp lệnh.
Lỗi in một dòng: Lỗi [MÃ]: nội dung và cách sửa.

Ví dụ trong script:

Shell

vnstock-pipeline run ohlcv --group VN30 > ket-qua.json || echo "cần xem lại" >&2
jq '.summary.errors' ket-qua.json

account

Lệnh	Tham số	Việc
`account login`	`--key-env TÊN_BIẾN` (mặc định `VNSTOCK_API_KEY`)	Đăng nhập tài khoản Vnstock, đăng ký thiết bị
`account logout`		Xoá khoá, phiên, quyền đã lưu
`account status`		Cấp quyền, quyền dùng, thiết bị, thời hạn bản phát hành
`account policy`		Chính sách quyền và chính sách máy khách
`account telemetry`	`status` \| `on` \| `off`	Đo lượt dùng

config

Lệnh	Tham số	Việc
`config init`	`--force`, `--base`	Tạo `pipeline.toml` mẫu
`config show`		Cấu hình đang có hiệu lực

store

Lệnh	Tham số	Việc
`store init`		Tạo thư mục gốc và mục lục
`store tree`	`--depth` (mặc định 4)	Cây thư mục
`store report`		Số tệp, dung lượng, số dòng từng bộ dữ liệu
`store catalog`	`[bộ dữ liệu]`, `--rebuild`	Xem hoặc dựng lại mục lục
`store audit`	`--interval` (mặc định `1D`), `--stale-days` (mặc định 5)	Kiểm nến đã lưu
`store compact`	`--date`	Gộp tệp phần stream; mặc định mọi ngày trước hôm nay

run

Mọi lệnh run nhận nhóm tham số chọn mã: --symbols, --group, --watchlist, --top, --source, --asset, --strict, --verbose (Tác vụ nạp dữ liệu).

Lệnh	Tham số riêng	Bộ dữ liệu ghi
`run ohlcv`	`--interval` (mặc định `1D`), `--start`, `--end`, `--mode daily\|init\|full`, `--include-today`	`ohlcv`
`run trades`	`--dates` (mặc định phiên gần nhất)	`trades`
`run quote`	`--kinds` (mặc định `quote,order_book`)	`quote`, `order_book`
`run index`	`--symbols` là mã chỉ số	`index_quote`
`run foreign`	`--start`, `--end`, `--mode`	`foreign_flow`
`run session-stats`	`--start`, `--end`, `--mode`	`session_stats`
`run block-trades`		`block_trades`
`run reference`	`--parts equity_list,index_members,price_limits,trading_days,events_calendar`	các bộ tham chiếu
`run company`	`--parts info,shareholders,ownership,insider_trading,all` (mặc định `info`)	`company_*`

universe

Lệnh	Tham số	Việc
`universe build-liquidity`	`--days` (mặc định 20), `--top` (mặc định 300)	Xếp hạng thanh khoản trên nến ngày đã lưu
`universe show`	nhóm tham số chọn mã	In danh sách mã của một lựa chọn

Tra cứu tệp

Lệnh	Tham số	Việc
`inspect`	`<tệp>`	Tổng quan một tệp (JSON)
`head`, `tail`	`<tệp>`, `--rows`	Dòng đầu, dòng cuối
`stats`	`<tệp>`	Thống kê cột
`schema file`	`<tệp>`	Cột và nguồn gốc của một tệp
`schema show`	`<bộ dữ liệu>`	Cấu trúc chuẩn
`schema reset`	`<bộ dữ liệu>`	Xoá cấu trúc chuẩn

quarantine

Lệnh	Tham số	Việc
`quarantine list`	`[bộ dữ liệu]`	Tệp đang cách ly, kèm khác biệt cấu trúc
`quarantine adopt`	`<tệp>`	Nhận cấu trúc mới làm chuẩn, xoá tệp cách ly
`quarantine discard`	`<tệp>`	Bỏ tệp cách ly

export

Lệnh	Tham số	Việc
`export csv\|parquet\|excel\|amibroker`	`--dataset` (mặc định `ohlcv`), `--symbols`, `--interval`, `--start`, `--end`, `--out`, `--kinds` (AmiBroker: `ohlcv,index,foreign`)	Xuất dữ liệu đã lưu

stream

Lệnh	Tham số	Việc
`stream channels`	`<nguồn>`	Kênh khai sẵn của nguồn
`stream run`	`<nguồn> <kênh…>`, `--symbols`, `--seconds`, `--intervals` (mặc định `1m`), `--engine auto\|rust\|python`, `--keep-raw`	Nối, giải mã, dựng nến, ghi
`stream record`	`<nguồn> <kênh…>`, `--symbols`, `--seconds` (bắt buộc), `-o/--output` (bắt buộc)	Chỉ ghi thông điệp ra tệp JSON Lines
`stream replay`	`<tệp>`, `--source`, `--intervals`, `--engine`	Chạy tệp đã ghi vào thư mục lưu trữ

migrate-legacy

Lệnh	Tham số	Việc
`migrate-legacy`	`<thư mục gốc bản 3.x>`, `--dry-run`	Chuyển dữ liệu bản 3.x sang bố cục mới, không xoá tệp cũ

Lệnh nào cần quyền

run …, stream run, stream record cần đăng nhập tài khoản thuộc gói quyền sử dụng từ cấp Golden trở lên. Mọi lệnh khác chạy được khi không có mạng.

Mục lục