Common Parameters
Shared parameters across all endpoints
| Parameter | Type | Description |
|---|---|---|
ticker | string | Asset symbol (e.g. AAPL, BTCUSD, SPY). Required on per-asset endpoints. Uppercase. Crypto tickers require a USD suffix (e.g. BTCUSD, ETHUSD). |
timeframe | string | daily or weekly. Default: daily. |
asset_class | string | Filter by asset class: stock, crypto, etf, or all. Auto-detected on per-asset endpoints. |
date | string | ISO 8601 date (YYYY-MM-DD) for historical snapshot. Default: latest. Free 30 days. Plus 2 years. Pro 5 years. |
limit | integer | Max results returned. Default: 20, max: 100. Applies to endpoints that return lists. |
Data Status
All responses include a data_status field. Currently always "eod" (end-of-day). Data refreshes daily at ~00:30 UTC.
Asset Classes
TickerDB covers three asset classes. Fundamental data (valuation, growth, earnings, analyst consensus) applies to stocks only. Fundamental fields are omitted entirely from crypto and ETF responses — keys are absent, not null.
Crypto Tickers
Crypto tickers require a USD suffix — e.g. BTCUSD, ETHUSD, SOLUSD. Using just BTC will return an error.
| Asset Class | Technical Data | Fundamental Data |
|---|---|---|
stock | All indicators | Valuation, growth, earnings, analyst consensus |
crypto | All indicators | Not available — fields omitted |
etf | All indicators | Not available — fields omitted |