Supported assets

Built-in instruments, their Yahoo Finance symbol mappings, timeframe limits, and how to add custom assets.

QuantAgent fetches all market data from Yahoo Finance via yfinance. Each built-in asset has an internal code used throughout the UI and API, which maps to the corresponding Yahoo Finance ticker at fetch time.

Built-in assets

Code	Display name	Yahoo Finance symbol
SPX	S&P 500	^GSPC
BTC	Bitcoin	BTC-USD
GC	Gold Futures	GC=F
NQ	Nasdaq Futures	NQ=F
CL	Crude Oil	CL=F
ES	E-mini S&P 500	ES=F
DJI	Dow Jones	^DJI
QQQ	Invesco QQQ Trust	QQQ
VIX	Volatility Index	^VIX
DXY	US Dollar Index	DX-Y.NYB
AAPL	Apple Inc.	AAPL
TSLA	Tesla Inc.	TSLA

Timeframe limits

Yahoo Finance imposes per-interval lookback limits. The UI enforces these automatically; the programmatic API validates them via validate_date_range().

Timeframe	Max lookback
1m	7 days
5m	60 days
15m	60 days
30m	60 days
1h	730 days
4h	730 days
1d	730 days
1w	730 days
1mo	730 days

Yahoo Finance data availability varies by symbol and interval. Futures contracts (GC=F, NQ=F, CL=F, ES=F) carry limited historical depth and roll between contract months, which can introduce gaps at expiry dates. Index symbols (^GSPC, ^DJI, ^VIX) do not have intraday data older than a few weeks.

Adding custom assets

Any ticker that Yahoo Finance recognises can be added to the UI as a custom asset. Custom assets are stored server-side in data/custom_assets.json and persist across server restarts.

Via the web interface

1. Open the Asset dropdown in the UI.
2. Click Add custom asset (or the equivalent input field).
3. Enter the Yahoo Finance ticker symbol exactly as it appears on Yahoo Finance (e.g. NVDA, ETH-USD, SI=F).
4. Confirm. The symbol is saved via POST /api/save-custom-asset and immediately appears in the dropdown.

Via the API

curl -X POST http://127.0.0.1:5000/api/save-custom-asset \
  -H "Content-Type: application/json" \
  -d '{"symbol": "NVDA"}'

A successful response looks like:

{ "success": true, "symbol": "NVDA" }

List all saved custom assets at any time:

curl http://127.0.0.1:5000/api/custom-assets

{ "custom_assets": ["NVDA", "ETH-USD"] }

Programmatically

from web_interface import analyzer

analyzer.save_custom_asset("NVDA")

Custom assets bypass the built-in symbol-to-ticker mapping table. The symbol you provide is passed directly to yfinance.download(). If Yahoo Finance does not recognise the ticker, the fetch returns an empty DataFrame and the analysis will fail with a “No data available” error.

Data availability notes

• Short intraday windows: The 1-minute interval is capped at 7 days. Plan date ranges accordingly when analysing high-frequency strategies.
• Futures roll gaps: Continuous futures symbols (=F suffix) may show price discontinuities around contract expiry. These are an artefact of Yahoo Finance’s data and not a QuantAgent issue.
• Crypto: BTC-USD and similar crypto pairs trade 24/7 and have no market-hours gaps, but Yahoo Finance may lag real-time prices by a few minutes.
• Limited history for new listings: Recently IPO’d stocks or newly listed ETFs may not have enough historical data to satisfy larger timeframe windows.