A professional-grade financial analysis tool for calculating stock performance metrics including annualized returns, Sharpe ratios, and maximum drawdowns.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install stock01
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install stock01 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is BitSoul Stock Skill?
The BitSoul Stock Skill is a robust analytical engine designed for investors and developers to evaluate the performance of individual stocks or entire investment portfolios. By leveraging the BitSoul API, it provides precise calculations for critical financial metrics like total return, annualized return, and risk-adjusted performance indicators.
This skill is a vital component of the Openclaw Skills ecosystem, offering two primary modes of operation: an automated Stock Mode that fetches real-time K-line data based on symbols and dates, and a manual Fund Mode for quick calculations based on known entry and exit values. It ensures institutional-grade reporting with mandatory inclusion of risk metrics like volatility-adjusted returns.
BitSoul Stock Skill Use Cases
- Calculating the annualized return of a specific stock over a custom date range.
- Evaluating the performance of a trading strategy based on initial and final capital.
- Generating comprehensive performance reports including Sharpe Ratio and Max Drawdown for risk assessment.
- Comparing personal portfolio growth against market benchmarks (standard 8-12%).
- Quick validation of investment gains over a specific number of trading days.
How BitSoul Stock Skill Works
- The user provides a stock code and date range, or specific capital values and duration.
- In Stock Mode, the skill uses the BitSoul API to fetch daily K-line data and build an equity curve.
- The engine calculates the total return based on the initial and final price or capital provided.
- It applies the standard financial formula $(1 + total_return)^{(252 / trading_days)} - 1$ to determine the annualized return.
- Advanced metrics like Sharpe Ratio and Maximum Drawdown are derived from the equity curve.
- A structured performance report is generated, including a qualitative conclusion based on market averages.
BitSoul Stock Skill Setup
To use this skill within the Openclaw Skills framework, ensure you have the following prerequisites:
- Environment Variables: Obtain a
BITSOUL_TOKENfrom aicodingyard.com and set it in your environment.
export BITSOUL_TOKEN="your_token_here"
- Dependencies: Ensure Python 3 is installed along with the required libraries:
pip install pandas numpy requests sqlalchemy
- Network Access: The skill requires outbound access to
info.aicodingyard.comto fetch financial data.
BitSoul Stock Skill Data Schema & Taxonomy
The skill processes and returns data structured for financial clarity:
| Field | Description | Type |
|---|---|---|
| Stock Name | Fetched via get_symbol_basic_infomation |
String |
| Analysis Period | Start date to End date with total trading days | Date Range |
| Annualized Return | Percentage return normalized to a 252-day trading year | Percentage |
| Max Drawdown | The largest peak-to-trough decline | Percentage |
| Sharpe Ratio | Risk-adjusted return metric | Float |
| Conclusion | Performance rating (Excellent, Good, Average, Poor) | String |
BitSoul Stock Skill Advanced Features
- Automated K-line fetching: Automatically retrieves historical price data using stock codes.
- Equity Curve Construction: Builds a normalized equity curve to calculate complex risk metrics.
- Comprehensive Backtesting: Supports full performance reports for strategies with multiple trade records.
- Intelligent Benchmarking: Automatically compares results against the standard 8-12% market average for context.
- Error Handling: Includes safeguards for insufficient data (requires at least 5 trading days).
SKILL.md
Loading
Related Openclaw Skills
Lodgify Skill for AI Agents
A powerful integration skill for AI agents to programmatically manage vacation rental properties, bookings, and guest communications via the Lodgify platform.
ORBIT Platform Operational Skill
An advanced agentic intelligence platform that orchestrates specialized AI agents to generate analytical dossiers and premium HTML presentations via Telegram or Web.
Voice Wake Say
A specialized skill for macOS that triggers local speech synthesis when voice recognition input is detected.
PowerMem Memory Minimal Install
A streamlined, minimal installation guide for adding long-term memory capabilities to OpenClaw using PowerMem without complex environment configurations.
High-Agency AI Engine
A high-performance agency framework that transforms AI agents into self-driving owners through internalized quality standards and robust self-recovery protocols.
Firecrawl Scrape
A powerful tool for extracting clean, LLM-optimized Markdown content from any URL, including JavaScript-heavy single-page applications.
Featured*
