Metadata-Version: 2.4
Name: hodlvn
Version: 0.1.0
Summary: HODL Lab — chỉ báo, chiến lược, backtest danh mục cổ phiếu Việt Nam trên dữ liệu HODL (cần API key hạng Loyalty)
License: Proprietary
Project-URL: Homepage, https://hodl.vn/lab
Project-URL: Documentation, https://hodl.vn/lab/docs
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.0
Requires-Dist: numpy>=1.24

# hodlvn — HODL Lab SDK

Viết chỉ báo, chiến lược và backtest danh mục cổ phiếu Việt Nam trên dữ liệu của HODL. Lõi này cũng là thứ chạy trong
trình duyệt ở [hodl.vn/lab](https://hodl.vn/lab), nên kết quả ở SDK và trên web giống nhau tới đồng.

```bash
pip install hodlvn
export HODL_API_KEY=hodl_...        # tạo ở hodl.vn/tai-khoan/ket-noi-ai (hạng Loyalty)
```

```python
import hodl
lab = hodl.Client()
res = lab.run('universe("HX-BANK")\nrebalance("M")\npick(top(momentum(63), 3))', kind="portfolio", start="2021-01-04")
print(res["summary"])
```

Backtest đã áp sẵn luật thị trường Việt Nam: lô 100, biên độ trần / sàn theo sàn, T+2,5, phí 0,15%, thuế bán 0,1%,
cổ tức tiền (thuế 5%) và cổ phiếu thưởng theo đúng ngày GDKHQ, khớp lệnh ở giá mở phiên sau tín hiệu, giá thật.

Hướng dẫn đầy đủ: https://hodl.vn/lab/docs
