akshare-finance

What This Skill Does

The akshare-finance skill provides the OpenClaw AI agent with a powerful interface to the AKShare ecosystem, a comprehensive open-source library for financial data. It allows users to fetch a vast array of global financial information directly through natural language instructions. This includes real-time and historical stock market data for A-shares, Hong Kong stocks, and US stocks, as well as macroeconomic indicators (GDP, CPI, PMI, M2), cryptocurrency market performance, foreign exchange rates, precious metals, and detailed corporate fundamental/financial metrics. The skill empowers the AI to act as a quantitative analyst or market research assistant, transforming raw market data into actionable insights, investment monitoring, and economic reporting.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/benangel65/akshare-finance

Ensure that you have the necessary system dependencies installed, specifically pandas and akshare. You can verify the installation by running pip install akshare pandas in your terminal.

Use Cases

1. Automated Investment Tracking: Configure your agent to monitor specific tickers daily. The agent can aggregate historical K-line data to calculate moving averages or performance trends, alerting you when a stock hits a specific price point.
2. Macroeconomic Briefing: Instead of browsing multiple news sites, ask the AI to compile a report on current Chinese economic health by fetching the latest GDP, CPI, and M2 growth rates via the macro indicators module.
3. Cryptocurrency Analysis: Rapidly retrieve market trends for various assets on Binance, compare current prices against historical moving averages, and analyze volume volatility.
4. Corporate Fundamental Analysis: Extract PE, PB ratios, and profitability metrics to build comparative tables of similar companies within a specific industry sector.

Example Prompts

1. "Check the current stock price and recent K-line trends for 000001.SZ and tell me if the price is above its 20-day moving average."
2. "Retrieve the latest monthly GDP and CPI data for China and explain how these figures reflect current inflationary pressures."
3. "List the top 5 gainers in the current A-share market and calculate their performance against the general market index."

Tips & Limitations

• Data Integrity: AKShare aggregates data from various public finance portals; always cross-reference critical financial decisions with primary brokerage tools or official financial statements.
• Performance: Financial data interfaces may experience latency during peak market hours. When running complex long-term historical data queries, ensure your local network connection is stable to prevent partial data fetches.
• API Changes: Financial APIs are subject to website source changes. If you encounter data retrieval errors, check the official AKShare documentation or GitHub repository for potential library updates.