Skip to content
Market Widgets

Get market catalysts

Returns catalyst events that affect markets or securities, including impact direction, summary, information sources, and related securities, for the Catalysts widget on the Markets page. The widget shows one event per selected market (limit is 1 and scn_id is 2).

The operation also powers the catalyst list page (scn_id is 1). When paginating, add every returned fact_id to filter_ids; fewer items than limit means there is no more data. Use market_catalyst_count for the count badges on market tabs.

Event charts are not included. Request daily candlesticks of the related security for start_time to end_time separately and show the latest line_num candlesticks.

POSThttps://api.lbkrs.com/v1/facts/recommend

Request body application/json

filter_idsarray<string>required

Event IDs to exclude, used for pagination. Pass an empty array on the first request

counter_idsarray<string>required

Filter by securities. Pass an empty array for market-level queries

limitintegerrequired

Number of events to return. When scn_id is 2, it is the number per market

marketarray<string>

Filter by markets, such as ["US", "HK"]

scn_idinteger

Scene:

  • 1 - Catalyst list page
  • 2 - Markets page widget, returning limit events per market
Values
1
2

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get market catalysts” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
fact_listarray<object>

Catalyst events

Child attributes
fact_idstring

Event ID. Add it to filter_ids in the next request when paginating

directionstring

Impact direction:

  • long - Bullish
  • short - Bearish
  • Other values - Neutral
titlestring

Event title

sub_titlestring

Event summary

data_sourcearray<object>

Information sources

Child attributes
typestring

Source type, such as News

source_namestring

Source name, such as the publisher

urlstring

Link to the original source. It can be empty

iconstring

Source icon URL

occur_timestring

Occurrence time in ISO 8601 UTC format

occur_timestampinteger

Occurrence time as a Unix timestamp in seconds. It also marks the base price on the candlestick chart

start_timeinteger

Chart start time as a Unix timestamp in seconds. Request daily candlesticks for this range separately

end_timeinteger

Chart end time as a Unix timestamp in seconds

line_numinteger

Number of candlesticks to show, taking the latest ones in the range. 0 means all

symbols_infoarray<object>

Related securities

Child attributes
counter_idstring

Security ID

symbolstring

Symbol with a market suffix, such as NVDA.US

security_namestring

Security name

current_valuestring

Current value. It can be empty

marketstring

Market. For multi-market requests, the Broker App assigns each event to a market page by this field

market_catalyst_countobject

Total catalyst count per market, keyed by market code

Whale Docs