Market

Top Movers

POSThttps://openapi.longbridge.com/v1/quote/market/stock-events

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

Get stocks whose price movement exceeds the 20-trading-day standard deviation, with automatically correlated news to explain the move.

>_ CLI
longbridge top-movers
longbridge top-movers --market HK --sort time

Request

Request body

NameTypeRequiredDescription
marketsarrayOptionalMarket list: `HK`, `US`, `CN`, `SG`; returns all markets if omitted
sortintegerOptionalSort order: `0`=time (newest first), `1`=price change, `2`=hotness (default)
datestringOptionalTarget date in `YYYY-MM-DD` format; returns latest data if omitted
limitintegerOptionalNumber of results to return, default 20

Response

Response properties

NameTypeRequiredDescription
eventsobject[]OptionalList of moving stocks
└ stockobjectOptionalBasic stock information
└ ∟ codestringOptionalTicker code (e.g. `TSLA`)
└ ∟ namestringOptionalSecurity name
└ ∟ changestringOptionalPrice change ratio (e.g. `-0.0388`)
└ ∟ last_donestringOptionalLatest trade price
└ ∟ marketstringOptionalMarket: `US`, `HK`, `CN`, `SG`
└ ∟ labelsstring[]OptionalIndustry / theme tags
└ ∟ logostringOptionalLogo image URL
└ ∟ trade_statusintegerOptionalTrading status code
└ timestampstringOptionalEvent time (Unix seconds as string)
└ alert_reasonstringOptionalDescription of the move reason
└ alert_typeintegerOptionalMove type code
└ postobjectOptionalAssociated news article (complex object with `title`, `description_html`, `published_at` and other fields; `null` when no article is linked)
next_paramsobjectOptionalPagination cursor object; pass to the next request to get the next page

Response JSON example

{
  "code": 0,
  "message": "success",
  "data": {
    "events": [
      {
        "stock": {
          "code": "TSLA",
          "symbol": "TSLA.US",
          "name": "Tesla, Inc.",
          "change": "-0.0388",
          "last_done": "404.110",
          "market": "US",
          "labels": [
            "Automobile Manufacturers"
          ],
          "logo": "https://assets.lbkrs.com/ticker/ST/US/TSLA.png",
          "trade_status": 0
        },
        "timestamp": "1779202097",
        "alert_reason": "Volatility exceeds 20-day avg",
        "alert_type": 11,
        "post": null
      }
    ],
    "next_params": {
      "visited": [
        "11098290",
        "11098478",
        "11099705"
      ]
    }
  }
}

Error code

See the Error Codes page for the full list of error codes.