| name | stock-insight |
| description | Use when the user asks for real-time stock quotes, price checks, market data, or financial summaries for specific companies or tickers. |
Stock Insight
Overview
This skill provides real-time stock market data using the yfinance Python library. It enables agents to fetch prices for US, HK, CN, and global markets.
Key Capabilities:
- Live Pricing: Fetches real-time data for active markets.
- Extended Hours: Automatically detects and returns Pre-market and After-hours prices for US stocks when available.
- Smart Fallback: Prioritizes the most relevant "last trade" (e.g., Post-market price > Regular close) to ensure actionable insights.
Usage
Fetching Quotes
Use the scripts/quote.py script to fetch data for one or more tickers.
python3 /Users/j/.openclaw/skills/stock-insight/scripts/quote.py TICKER [TICKER ...]
Ticker Suffixes
- US Markets: No suffix (e.g.,
AAPL, NVDA, TSLA)
- Hong Kong:
.HK (e.g., 0700.HK for Tencent, 06809.HK for Montage Tech)
- Shanghai (A-Share):
.SS (e.g., 600519.SS for Moutai, 688008.SS for Montage Tech A)
- Shenzhen (A-Share):
.SZ (e.g., 000001.SZ)
Example Output
{
"MU": {
"symbol": "MU",
"name": "Micron Technology, Inc.",
"price": 398.75,
"market_state": "Pre-market",
"currency": "USD",
"change": 19.09,
"pct_change": 5.03,
"market_cap": 430946254848,
"status": "success"
}
}
- market_state: Indicates if the price is from
Regular, Pre-market, After-hours, or Live trading.
Common Mistakes
- Wrong Suffix: Forgetting
.HK or .SS will often fail or return a different US OTC stock. Always check if the user implies a specific market (e.g., "A-share" -> .SS/.SZ, "Hong Kong" -> .HK).
- Market State Confusion: If
price differs significantly from yesterday's close, check market_state. Pre/Post-market volatility can be high and may not reflect the next official open.
