Tự mang phong bì
Mục lục
Trang này viết cho vnstock v6.0.0rc2, 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à v5.0.1, xem tài liệu bản đó.
Chọn nguồn bạn có khoá, mã trên trang sẽ điền theo. Chưa chọn thì mã giữ chỗ trống <nguồn>. Nguồn xếp theo bảng chữ cái, không phải khuyến nghị.
Connector đọc phong bì dữ liệu có sẵn và chuyển thành bảng chuẩn mà không gọi mạng. Cách này phù hợp
khi bạn muốn lưu phản hồi rồi chuẩn hoá lại để đối chiếu, hoặc đã tự truy xuất dữ liệu bằng mã riêng.
import vnstock_oapi as oapi
from vnstock import Connector
envs = oapi.source("<nguồn>").ohlc("FPT", start="2026-10-01")
envs.save("fpt.jsonl") # lưu phong bì, không chứa khoá
df = Connector("<nguồn>").equity("FPT").ohlcv("fpt.jsonl") # đọc lại, không cần mạngĐọc theo tên hàm bất kỳ
Connector("<nguồn>").read("market.equity.quote", "quote_fpt.jsonl", columns="all")Connector("<nguồn>").read("market.equity.foreign_flow", envs, start="2026-10-01", end="2026-10-30")Connector.reads() # bảng nguồn, thao tác, tên hàm mà thư viện đọc được| Tham số | Ý nghĩa |
|---|---|
route | Tên hàm dạng market.equity.quote |
envelopes | Phong bì: đối tượng của vnstock_oapi, danh sách dict, đường dẫn tệp JSONL, hoặc chuỗi JSON |
symbol | Mã phong bì nói tới, để kiểm |
start, end | Giữ dòng trong khoảng này (hàm có cột thời gian) |
floating, compat, columns | Như ở Thị trường |
Connector.equity, .index, .futures, .warrant có ohlcv(envelopes, ...) cho nến.
Phong bì từ mã của bạn
Lõi cũng đọc được phong bì do mã của bạn tạo nếu đúng đặc tả phong bì v1 của vnstock-oapi.
oapi.wrap(...) bọc phản hồi bạn tự lấy thành phong bì. Phong bì có dấu hiệu chứa khoá hay token thì
lõi từ chối đọc (VNSTOCK_ENVELOPE_SECRET).
Phong bì chứa phản hồi gốc của nguồn và vẫn chịu điều khoản tương ứng. Không commit phong bì vào kho mã; chỉ chia sẻ khi điều khoản của nguồn cho phép.
