Skip to content
Stock Events and Daily Reports

List Stock Events

Lists stock events, that is, unusual price movements with an explanation of the cause and an associated news article, by market, date, and sort order, with page support. Use it for the market Stock Events page and the stock events module on the market home page (sorted by popularity, first page only). This is a read-only query that uses POST to pass filters.

Pass an empty object as next_params for the first page; to load the next page, pass back the next_params returned by the previous page unchanged.

POSThttps://api.lbkrs.com/newmarket/stock_events

Request body application/json

limitintegerrequired

Number of items per page

marketsarray<string>required

Market codes, for example ["US"]; pass multiple markets to query all of them

sortintegerrequired

Sort order:

  • 0 - By time
  • 1 - By change rate
  • 2 - By popularity
Values
0
1
2
datestring

Date to query; omit it or pass an empty string for the latest data

next_paramsobject

Pagination parameters; pass an empty object for the first page, then the next_params returned by the previous page

Responses

HTTP 200The request succeeded. The response body contains the result of the “List Stock Events” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
eventsarray<object>

Stock events

Child attributes
stockobject

Security associated with a stock event

Child attributes
counter_idstring

Security ID

namestring

Security name

codestring

Ticker symbol, for example AAPL

marketstring

Market, for example US or HK

trade_statusstring

Trading status code of the security; when not empty, you can show the status next to the name

labelsarray<string>

Tag labels

changestring

Price change rate as a decimal, for example 0.0523 for +5.23%

timestampinteger

Event time as a Unix timestamp

alert_reasonstring

Explanation of the cause of the movement

postobject

News article associated with a stock event

Child attributes
idstring

Article ID

titlestring

Article title; when empty, show the plain text of description_html

description_htmlstring

Article summary in HTML

source_urlstring

Original article URL

next_paramsobject

Pagination parameters for the next page; pass them unchanged as next_params in the next request

updated_atinteger

Time the data was last updated, as a Unix timestamp

Whale Docs