Events
News
Headlines as events on the unified timeline — kind=news on GET /v2/events. Opt-in: name it in kind and articles merge chronologically with dividends, downgrades, and signal flips — one article row per tagged ticker. For news search (publisher metadata, topic filters, rollups, its own SQL surface), use /v2/news — this kind is the timeline mirror, not a replacement.
Payload
A summary projection of the article — the full object lives on /v2/news.
| field | meaning |
|---|---|
title | Headline |
source | Publisher |
url | Link to the article |
sentiment_score | Overall sentiment, −1 to 1 |
sentiment | Label (Bullish / Somewhat-Bullish / Neutral / …) |
Recipes
Merge headlines into a ticker's timeline, or filter on sentiment via the payload.
# AAPL's full timeline this week — corporate events, signal flips, AND headlines
curl "https://api.tickerbot.io/v2/events?ticker=AAPL&kind=dividend,split,insider,analyst,signal,news&since=2026-07-23" \
-H "Authorization: Bearer YOUR_KEY"
# Strongly bearish headlines across the top 100, today
curl -G "https://api.tickerbot.io/v2/events" \
-H "Authorization: Bearer YOUR_KEY" \
--data-urlencode "kind=news" \
--data-urlencode "universe=top_100" \
--data-urlencode "since=2026-07-30" \
--data-urlencode "q=(payload->>'sentiment_score')::numeric < -0.35"Latency: ≤ 15 minutes (the live news feed). An article tagged with several tickers appears once per tagged ticker. The live ticker object also carries news_volume and news_volume_weighted_sentiment for scans.