# Top Movers

`POST` `/v1/quote/market/stock-events`

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

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `markets` | array | No | Market list: `HK`, `US`, `CN`, `SG`; returns all markets if omitted |
| `sort` | integer | No | Sort order: `0`=time (newest first), `1`=price change, `2`=hotness (default) |
| `date` | string | No | Target date in `YYYY-MM-DD` format; returns latest data if omitted |
| `limit` | integer | No | Number of results to return, default 20 |

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/quote/market/stock-events' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"markets":[],"sort":0,"date":"<date>","limit":0}'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `events` | object[] | No | List of moving stocks |
| `└ stock` | object | No | Basic stock information |
| `└ ∟ code` | string | No | Ticker code (e.g. `TSLA`) |
| `└ ∟ name` | string | No | Security name |
| `└ ∟ change` | string | No | Price change ratio (e.g. `-0.0388`) |
| `└ ∟ last_done` | string | No | Latest trade price |
| `└ ∟ market` | string | No | Market: `US`, `HK`, `CN`, `SG` |
| `└ ∟ labels` | string[] | No | Industry / theme tags |
| `└ ∟ logo` | string | No | Logo image URL |
| `└ ∟ trade_status` | integer | No | Trading status code |
| `└ timestamp` | string | No | Event time (Unix seconds as string) |
| `└ alert_reason` | string | No | Description of the move reason |
| `└ alert_type` | integer | No | Move type code |
| `└ post` | object | No | Associated news article (complex object with `title`, `description_html`, `published_at` and other fields; `null` when no article is linked) |
| `next_params` | object | No | Pagination cursor object; pass to the next request to get the next page |

### Response JSON Example

```json
{
  "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"
      ]
    }
  }
}
```
