| name | stock |
| description | Live stock quotes, historical prices, multi-stock comparison. Use for stock prices, market data, or portfolio tracking. Outputs CSV for chart pipeline. |
| metadata | {"nessi":{"command":"stock","enabled":true}} |
Stock
Live stock market data via Twelve Data API. Look up current quotes, pull historical prices as CSV, and compare multiple stocks.
Requires an API key — the user can get a free one at twelvedata.com and add it in Settings → API Keys.
Commands
Current quote
stock AAPL
stock MSFT
stock BTC/USD
Returns: price, change, percent change, open, high, low, volume, 52-week range.
Historical prices (CSV output for chart pipeline)
stock history AAPL --range 1mo --output /output/aapl.csv
stock history TSLA --range 3mo --interval 1wk --output /output/tsla_weekly.csv
stock history BTC/USD --range 1y --output /output/btc.csv
Ranges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y
Intervals: 1day (default), 1week, 1month
Compare multiple stocks
stock compare AAPL,MSFT,GOOGL --range 1mo --output /output/tech.csv
Outputs a single CSV with columns: date, AAPL, MSFT, GOOGL (close prices).
Pipeline: stock → chart
stock history AAPL --range 3mo --output /output/aapl.csv
chart line /output/aapl.csv --x "date" --y "close" --title "AAPL 3 Months"
present /output/line-chart.svg
stock compare AAPL,MSFT --range 6mo --output /output/compare.csv
chart line /output/compare.csv --x "date" --y "AAPL,MSFT" --title "AAPL vs MSFT"
present /output/line-chart.svg
What to ask the user
If the user asks about a stock but doesn't specify a ticker symbol, ask them. Common examples:
- Apple → AAPL
- Microsoft → MSFT
- Tesla → TSLA
- Google/Alphabet → GOOGL
- Amazon → AMZN
- Bitcoin → BTC/USD
- Ethereum → ETH/USD
Presenting results
For current stock quotes, use the card tool (metric layout) to display the result visually. The card tool is a direct tool — call it by name, not via bash.
- Single stock: metric card with price as value, change as subtitle. Use
ti-trending-up or ti-trending-down based on direction.
- Multiple stocks compared: metric card with items array, one per ticker.
For historical data and charts, use the chart pipeline (stock → chart → present) as shown above.
Notes
- All data from Twelve Data API (free tier: 800 requests/day, 8 per minute)
- Prices cached for 60 seconds to avoid rate limits
- If you get an API key error, tell the user to add their key in Settings → API Keys → Twelve Data
