change_ ytd_ pct
Percent change since the last close of the previous calendar year, as a whole percent. A stock listed this year is measured from its first close.
Facts
A numeric signal: screen on it with a comparison operator (change_ytd_pct > 270). It's null on tickers it doesn't apply to.
| definition | (price / base − 1) × 100, where base is the last daily close of the previous calendar year, or the first daily close for a stock listed this year. Live, price is the current price; on a past date, that session's close. |
| type | numeric |
| unit | % |
| refresh | post-close daily · 8:05 PM ET |
| grains | 1m 1h 1d |
| asset classes | US equities, Rates, Crypto, FX |
| history | 1d full · since 2003; 1h full · since 2004; 1m full · since 2003 |
Examples
Screen on it
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "change_ytd_pct > 270",
"order": "change_ytd_pct"
}'Backtest it on a past date
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "change_ytd_pct > 270",
"asof": "2026-08-17",
"order": "change_ytd_pct"
}'Get an alert when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "change_ytd_pct > 270",
"target_url": "https://example.com/hooks/tickerbot"
}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.
Its history
curl "https://api.tickerbot.io/v2/tickers/NVDA/history?select=close,change_ytd_pct" \
-H "Authorization: Bearer YOUR_KEY"