← tickerbot.io
View as markdown
Endpoints › Events

News (events)

GEThttps://api.tickerbot.io/v2/events?kind=news

Headlines as events on the timeline, one per article × tagged ticker. Opt in by naming news in kind.

Query parameters

stringrequiredfixed by this page

Include news explicitly — e.g. kind=news alone, or the full merge kind=earnings,dividend,split,insider,analyst,signal,news.

string

Single symbol. Beats tickers when both are passed.

string[]

Comma-separated symbols, up to 50. Not combinable with universe; ticker wins when both are passed.

string

System or caller-owned universe slug.

string

YYYY-MM-DD or ISO timestamp (inclusive). since is accepted as an alias.

string

YYYY-MM-DD or ISO timestamp — a bare YYYY-MM-DD means through the end of that day; timestamps are exclusive. until is accepted as an alias.

string

SQL filter. This kind's payload fields are first-class typed columns here: sentiment_score (numeric), title, source, url, sentiment (text) — e.g. sentiment_score < -0.35. payload->>'…' works too. Base columns: ticker, ts, kind, payload. See the signals catalog for columns + flags you can compose.

integerdefault 50

Rows per page. Max 1000.

string

Opaque cursor from the previous response.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

queryobject

Your filters, echoed.

countnumber

Rows in this page.

next_cursorstring

Opaque token for the next page; `null` on the last page. Pass it back as `cursor`.

resultsarray

One row per event, newest first.

tickerstring

A tagged symbol — an article with several tags appears once per tag.

tsstring

Publication time.

kindstring

Always `news` on this view.

payloadobject

The headline.

titlestring

Headline text.

sourcestring

Publisher.

urlstring

Article link.

sentiment_scorenumberoptional

Per-ticker sentiment, signed.

sentimentstringoptional

Label for the score (bullish/bearish/neutral bands).

Notes

  • This is GET /v2/events with kind=news; it has its own page because the payload is its own contract. The full query grammar lives there and applies here unchanged.
  • This kind is the timeline mirror, not a replacement: for search, publisher metadata, topic filters, and rollups use /v2/news. An unfiltered /v2/events stays the five corporate kinds. Latency: within 15 minutes via the live news feed.
  • Event webhooks don't cover this kind — for push, watch the live news_volume / news_volume_weighted_sentiment signals with a scan or ticker trigger.

More examples

A ticker's full timeline, headlines included
curl "https://api.tickerbot.io/v2/events?ticker=AAPL&kind=earnings,dividend,split,insider,analyst,signal,news&from=2026-09-14" \
  -H "Authorization: Bearer YOUR_KEY"
Response
// One merged, newest-first timeline across all seven kinds.