📚 Docs & Quick start

Install

Python

pip install lotusmarket==0.5.0

Optional extras:

pip install lotusmarket[fetchers]   # adds httpx for API fetchers
pip install lotusmarket[ai]         # adds anthropic for AI helpers
pip install lotusmarket[all]

Go

go get github.com/ducnhd/lotusmarket/go@v0.5.0

CLI binary:

go install github.com/ducnhd/lotusmarket/go/cmd/lmcli@v0.5.0

lmcli pulse           # daily VN30 markdown
lmcli quote ACB       # real-time quote
lmcli rate ACB        # 6-dim star ratings
lmcli screen --rsi=30-50
lmcli sectors
lmcli global
lmcli dividends VNM
lmcli report --out=today.md

Modules

• fetchers — VPS, Entrade, KBS, Cafef, Yahoo Finance, VCI dividends, FRED macro (all free, no API key)
• technical — RSI, MA, MACD, Bollinger, ATR, momentum, dashboard signal + score
• ratings — 6-dim star ratings (price strength · trend · RSI · money flow · volatility · base range)
• signals — volume surge classifier, domestic flow (bid/ask pressure)
• market — pulse score, regime classifier, sector flow, driver attribution
• portfolio — TWR returns, confidence scoring
• sentiment — Vietnamese keyword analyzer (70+ financial terms)
• nlu — intent parsing, ticker extraction
• exposure — per-ticker external driver mapping (commodity / FX / peer) with 2-year backtest correlations
• backtest — strategy harness (buyhold · momentum · low-vol · dual momentum) with realistic VN retail fees
• historical — generic cohort analysis on (ticker, date, features, fwd_returns) panels
• earnings — Vietnamese earnings headline parser
• ai — optional Claude API helper for narrative summaries

License

MIT — fork, modify, commercialize, no obligation. PRs welcome.

Support

If lotusmarket saved you time, consider supporting:

• Star the GitHub repo
• Subscribe Telegram channel
• Sponsor via PayPal
• Send Telegram Stars to @vnlotusmarketbot /donate