Skip to content
K-Lines and Intraday

Get K-line Event Markers V3

Returns corporate event markers of a security in the new format. Each marker includes icons in several sizes, and each event includes a display date, time zone, and key data (such as revenue, net profit, and EPS for an earnings release). Use it to overlay event icons on the K-line chart and show event details. Call it at the same times as GET /v3/stock/activity/klines. The Broker App uses this endpoint when the new event icons are enabled, and V2 otherwise.

GEThttps://api.lbkrs.com/v3/stock/activity/klines

Parameters

counter_idstringqueryRequired

Security ID (counter_id), for example ST/US/AAPL or ST/HK/700

categoryintegerquery

K-line period; same values as line_type in GET /v3/quote/kline. The server groups events onto the K-lines of this period

1515306010002000300035004000

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get K-line Event Markers V3” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
counter_idstring

Security ID

categoryinteger

K-line period of this response

activity_listarray<object>

Event markers; an empty array when there are no events

Child attributes
timestampstring

Time of the K-line that carries the marker, as a Unix timestamp in seconds

mine_icon_extobject

Marker icon set; an empty field means no icon at that size

Child attributes
regularstring

Regular-size icon URL

regular_hoverstring

Regular-size icon URL for the selected state

ministring

Small icon URL

mini_hoverstring

Small icon URL for the selected state

activitiesarray<object>

Events in this marker

Child attributes
idstring

Event ID

actionstring

Event type, such as FinancialReport (earnings release), DividendExDate (ex-dividend), StockSplit, or ReverseStockSplit

act_typestring

Display name of the event type

act_titlestring

Event title

act_descstring

Event description

datestring

Event date in YYYYMMDD format

date_strstring

Event date for display

date_zonestring

Display label of the time zone of the event date, such as “(ET)”

data_kvarray<object>

Key event data, such as revenue, net profit, and EPS for an earnings release

Child attributes
keystring

Display name of the metric

valuestring

Formatted metric value

typestring

Metric type, such as eps, revenue, or profit

iconstring

Event icon URL

urlstring

Destination URL on tap; empty means no navigation

Whale Docs