news_ volume_ weighted_ sentiment
The sentiment of today's news, scaled by how unusual the volume is. It is the relevance-weighted average sentiment of the last 24 hours' scored articles (relevance 0.6 or higher), times tanh(max(0, news_volume − 1) / 1.5). A normal or quiet day reads 0; the multiplier is 0.58 at twice normal volume and 0.87 at three times. Ranges from −1 to 1; null when there are no such articles.
Facts
A numeric signal: screen on it with a comparison operator (news_volume_weighted_sentiment > 0.23). It's null on tickers it doesn't apply to.
| definition | Relevance-weighted mean sentiment over the last 24 hours, relevance of at least 0.6, × tanh(max(0, news_volume − 1) ÷ 1.5). Close to 0 on a normal day, toward ±1 when news runs well above normal. |
| type | numeric |
| allowed values | -1 to 1 |
| refresh | 15 min · 24/7 |
| asset classes | US equities |
| coverage | all tickers |
| history | live value only |
| nullable | yes |
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": "news_volume_weighted_sentiment > 0.23",
"order": "news_volume_weighted_sentiment"
}'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": "news_volume_weighted_sentiment > 0.23",
"target_url": "https://example.com/hooks/tickerbot"
}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.