HODL Lab · Hướng dẫnMở Lab

Tham chiếuSDK Python

SDK Python

SDK hodlvn chạy cùng lõi Lab trên máy riêng của bạn (Jupyter, script, cron…). Kết quả giống trên web tới đồng. Cần API key hạng Loyalty.

Cài đặt

text
pip install hodlvn
export HODL_API_KEY=hodl_...        # tạo ở hodl.vn/tai-khoan/ket-noi-ai

Chạy một script

text
import hodl
lab = hodl.Client()                 # đọc HODL_API_KEY; hoặc hodl.Client(api_key="hodl_...")

res = lab.run('universe("HX-BANK")\nperiod("5Y")\nrebalance("M")\npick(top(momentum(63), 3))', kind="portfolio")
print(res["summary"])               # return_pct, cagr_pct, sharpe, max_drawdown_pct, ...
print(res["equity"][-1])            # [ngày, giá trị danh mục, giá trị VN-Index]

lab.run(code, kind, symbol=None, start=None, params=None, capital=100_000_000, fee_pct=0.15)

Tham số Nghĩa
code Script, viết y như trên web
kind "indicator", "strategy", "portfolio" hoặc "dca"
symbol · start Ghi đè ticker() / period() trong code (để trống thì dùng giá trị trong code)
params Giá trị cho các input, theo nhãn: {"Holdings": 5}
capital · fee_pct Vốn ban đầu, phí % mỗi chiều
  • kind="dca" chỉ trả kế hoạch (res["plan"]). Mô phỏng tích sản chạy ở Tích sản.
  • Lấy dữ liệu thô: lab.bars(...), xem Dữ liệu thô.

Bộ nhớ đệm

SDK lưu dữ liệu đã tải trong ngày ra đĩa, nên chạy lại cùng script không tốn thêm lượt. Tắt bằng biến môi trường HODL_NO_CACHE=1.