vnstock-free-expert
Runs an end-to-end vnstock workflow for free-tier-safe Vietnam stock valuation, ranking, and API operations with strict rate-limit control; used when users request Vietnamese stock analysis under free-tier constraints.
Why use this skill?
Analyze Vietnam stocks using the VNStock library with rate-limit protection. Build, rank, and generate professional reports while staying within free-tier limits.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ndtchan/vnstock-free-expertWhat This Skill Does
The vnstock-free-expert is a specialized OpenClaw agent skill designed to perform professional-grade valuation, screening, and analysis of Vietnamese stocks using the vnstock library. It is engineered specifically for users who need high-quality financial insights without exceeding the strict rate limits imposed by free-tier API accounts. The skill automates the entire analytical lifecycle, from building a stock universe to generating comprehensive analyst-style memos, all while maintaining rigorous pacing to ensure reliability.
Installation
To integrate this expert agent into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/ndtchan/vnstock-free-expert
Ensure your local environment has python, pandas, and vnstock installed. You can configure your credentials by creating a .env file in the skill directory containing your VNSTOCK_API_KEY. If no key is provided, the agent automatically throttles requests to adhere to free-tier constraints (typically 20 requests/minute).
Use Cases
- Screening and Valuation: Efficiently filter through the HOSE, HNX, and UPCoM exchanges to identify undervalued stocks based on fundamental metrics.
- Market Analysis: Generate sentiment and financial reports for a watchlist of tickers using the automated reporting pipeline.
- Portfolio Review: Use the
invoke_vnstock.pyscript to pull custom data points on specific holdings, ensuring that your research remains compliant with internal API rate limits.
Example Prompts
- "Perform a valuation analysis on the banking sector in Vietnam; rank them by P/E ratio and report the confidence of the data using the high/medium/low rubric."
- "Use
vnstock-free-expertto generate an analyst-style report for HPG, VCB, and MWG, ensuring you respect free-tier rate limits." - "Run a universe build for the VN30 index and identify any missing fundamental fields that could affect my buy-side analysis."
Tips & Limitations
- Strict Pacing: The skill uses a default 3.2s delay between requests. Do not attempt to override this manually if you are on a free account, as it will cause connection bans.
- Constraint Awareness: The
tcbssource is strictly prohibited. Always rely onkbsas your primary data source andvcias your secondary fallback. - Confidence Rubric: Always review the generated confidence score. If the report returns 'Low' confidence, verify the missing metrics provided in the final output before making investment decisions.
- Self-Contained: All operational knowledge is stored in the
references/directory; you do not need to install additional documentation packages.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ndtchan-vnstock-free-expert": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api, code-execution