YahooClaw - Yahoo Finance API Integration
🔒 Security
- ✅ No shell command execution
- ✅ All API calls use HTTPS
- ✅ Rate limiting implemented
- ✅ Open source and auditable
- ⚠️ API keys must be set via environment variables
- ℹ️ Uses in-memory caching for performance (no database)
Overview
YahooClaw is an OpenClaw skill that integrates Yahoo Finance API, providing real-time stock data queries, financial analysis, historical stock prices, and more.
Permissions
Required Permissions
- ✅ Network Access: Yahoo Finance API (HTTPS)
- ✅ File Access: Local SQLite database storage (optional caching)
- ❌ No Admin/Root Privileges Required
- ❌ No System Command Execution
- ❌ No Access to User Privacy Data
Data Flow
- Stock Data: Yahoo Finance API → Local Processing → Return Results
- No user data uploaded
- Temporary caching only (optional)
Use Cases
1. Real-time Stock Quotes
Query AAPL stock price
How much is Tesla now
NVDA latest stock price
2. Company Information
What is Apple's market cap
Microsoft's P/E ratio
Google's revenue data
3. Historical Data
Show AAPL stock price for the past 30 days
Tesla's trend last month
4. Financial Metrics
Apple's balance sheet
Tencent's income statement
5. Dividends
What is AAPL's dividend
Which stocks have high dividend yields
Usage Examples
Basic Usage
const YahooClaw = require('./src/yahoo-finance.js');
// Get real-time stock quote
const quote = await YahooClaw.getQuote('AAPL');
console.log(quote);
// Get historical data
const history = await YahooClaw.getHistory('TSLA', '1mo');
console.log(history);
// Get company information
const info = await YahooClaw.getCompanyInfo('MSFT');
console.log(info);
OpenClaw Integration
// Call in OpenClaw agent
const result = await tools.yahooclaw.getQuote({symbol: 'AAPL'});
API Parameters
getQuote(symbol)
- symbol: Stock code (e.g., AAPL, TSLA, 0700.HK)
- Returns: Real-time stock price, change, volume, etc.
getHistory(symbol, period)
- symbol: Stock code
- period: Time period (1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max)
- Returns: Historical stock price data
getCompanyInfo(symbol)
- symbol: Stock code
- Returns: Company information, market cap, P/E ratio, P/B ratio, etc.
getDividends(symbol)
- symbol: Stock code
- Returns: Dividend history
Environment Variables
# Optional: Alpha Vantage API (backup data source)
# Get from: https://www.alphavantage.co/support/#api-key
ALPHA_VANTAGE_API_KEY=your_api_key_here
# Optional: Database path for caching
DATABASE_PATH=./yahooclaw.db
Notes
- Data Delay: Yahoo Finance real-time data may have 15-minute delay
- Rate Limiting: Control request frequency to avoid rate limits
- HK/A-Shares: Supports HK stocks (0700.HK), A-shares (600519.SS), etc.
- Error Handling: Network issues or invalid codes will return error messages
Troubleshooting
Common Issues
- Failed to Get Data
- Check network connection
- Verify stock code format
- Check Yahoo Finance service status
- Data Delay
- This is normal, Yahoo Finance real-time data has delay
- Consider using paid API for truly real-time data
- A-Share/HK Stock Code Format
- A-Shares: 600519.SS (Moutai)
- HK Stocks: 0700.HK (Tencent)
- US Stocks: AAPL (Apple)
Resources
Changelog
v1.0.0 (2026-03-12)
- ✅ Security improvements
- ✅ Removed all test/debug files
- ✅ Fixed unicode characters
- ✅ Updated documentation
- ✅ Production ready
v0.1.0 (2026-03-09)
- ✅ Initial release
- ✅ Real-time stock quotes
- ✅ Historical data queries
- ✅ Company information queries
- ✅ Dividend queries
- ✅ OpenClaw integration
License
MIT License
Author
PocketAI for Leo - OpenClaw Community