Skip to main content

hodlvn — HODL Lab SDK

Write indicators, strategies and portfolio backtests for Vietnamese stocks on HODL data. This is the same core that runs in the browser at hodl.vn/lab, so SDK and web results match to the dong.

pip install hodlvn
export HODL_API_KEY=hodl_...        # create one at hodl.vn/tai-khoan/ket-noi-ai (Loyalty membership)
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"])

Backtests apply Vietnamese market rules out of the box: 100-share lots, per-exchange ceiling / floor bands, T+2.5 settlement, 0.15% fees, 0.1% sell tax, cash dividends (5% tax) and bonus shares on their ex-dates, fills at the next session's open after a signal, real prices.

Full guide: https://hodl.vn/lab/docs

Metadata

Release files for hodlvn 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hodlvn 0.1.1
File Size Uploaded Provenance Actions
hodlvn-0.1.1.tar.gz 21.9 kB Without provenance Details for hodlvn-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hodlvn 0.1.1
File Interpreter ABI Platform Actions
hodlvn-0.1.1-py3-none-any.whl Python 3 none any Details for hodlvn-0.1.1-py3-none-any.whl

Total release size: 43.2 kB

Release files / hodlvn-0.1.1.tar.gz

Download URL hodlvn-0.1.1.tar.gz
Size 21.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f57d490b6cfa93e1dd0bf096412585b36b9cb4b2d128a34f1bed7294ba3ce174
BLAKE2b-256 checksum
How to use checksums
c01fa32bf43e68ef27502a698dedbbe9c3e38c20d1c185727a3561b2196dd471
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / hodlvn-0.1.1-py3-none-any.whl

Download URL hodlvn-0.1.1-py3-none-any.whl
Size 21.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e7750e8580d65db931eb2994d3cd6439508776d8439d882fb37af11254c0e7aa
BLAKE2b-256 checksum
How to use checksums
be907267abc8979dc11e8bbd2949f796564ac8851f78c9a7496108d87d76c0ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for hodlvn 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page