Vnstock Logo

Tự mang phong bì

Thử nghiệm

Mục lục

Bản thử nghiệm, chưa phát hành chính thứ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 đó.

Nguồn của 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.

Python
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ỳ

Python
Connector("<nguồn>").read("market.equity.quote", "quote_fpt.jsonl", columns="all")
Python
Connector("<nguồn>").read("market.equity.foreign_flow", envs, start="2026-10-01", end="2026-10-30")
Python
Connector.reads()        # bảng nguồn, thao tác, tên hàm mà thư viện đọc được
Tham sốÝ nghĩa
routeTên hàm dạng market.equity.quote
envelopesPhong bì: đối tượng của vnstock_oapi, danh sách dict, đường dẫn tệp JSONL, hoặc chuỗi JSON
symbolMã phong bì nói tới, để kiểm
start, endGiữ dòng trong khoảng này (hàm có cột thời gian)
floating, compat, columnsNhư ở 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.