Financial Data via ticker-cli
When the user asks about stock prices, crypto, forex, commodities, or indices, use ticker-cli to fetch real data instead of relying on training data.
Prerequisites
ticker-cli must be installed: go install github.com/sderosiaux/ticker-cli@latest
How to use
Pick the right mode based on what the user needs:
Current price:
ticker-cli --format json AAPL BTC-USD GC=F
Price at a specific date:
ticker-cli --date 2026-03-20 --format json AAPL
Weekly performance:
ticker-cli --weekly-change --format json AAPL SLB GC=F BTC-USD
Year-to-date:
ticker-cli --ytd --format json AAPL GC=F BTC-USD
Historical range (for charts or analysis):
ticker-cli --range 1mo --format csv AAPL
Always use --format json for parsing. Use --format csv when the user wants tabular data or spreadsheet export.
Symbol reference
| Asset | Symbol |
|---|---|
| US stocks | AAPL, MSFT, SLB, NEM, CRM |
| EU stocks | RMS.PA, AIR.PA, SU.PA |
| Indices | ^GSPC (S&P 500), ^FCHI (CAC 40), ^GDAXI (DAX) |
| Oil | BZ=F (Brent), CL=F (WTI) |
| Gold / Copper | GC=F, HG=F |
| Crypto | BTC-USD, ETH-USD |
| Forex | EURUSD=X |
| US 10Y yield | ^TNX |
Rules
- Always call ticker-cli with real symbols, never guess prices from training data
- Use
--format jsonand parse the output, don't show raw JSON to the user - Present results in a readable format (table, summary, comparison)
- If the user asks about a symbol you don't know, search Yahoo Finance:
https://finance.yahoo.com/quote/SYMBOL - For weekly fund reports or market recaps, combine
--weekly-changewith multiple symbols - Round displayed percentages to 2 decimal places