Top Movers
top_moversRead-onlyIdempotent
Identify stocks with price moves exceeding 20-day standard deviation and get correlated news reasons. Filter by HK/US/CN/SG markets, sort by time, change magnitude, or popularity.
Instructions
Get stocks whose price fluctuation exceeds the 20-trading-day standard deviation, with correlated news reasons. markets: comma-separated HK/US/CN/SG (omit=all). sort: 0=time 1=change-magnitude 2=popularity/heat (default). limit: results per page (default 20). next_params: pass next_params from previous response to paginate. Returns events[]{timestamp(RFC3339), alert_reason, alert_type, stock{symbol, name, change(decimal ratio e.g. 0.0445=+4.45%), last_done, labels[], intro}}, updated_at, next_params.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| markets | No | Market filter: comma-separated list of markets to include. Supported values: "HK", "US", "CN", "SG". Omit to return all markets. Example: "HK,US" | |
| sort | No | Sort order (default: "2"): "0" = by time (most recent first) "1" = by price change magnitude (largest move first) "2" = by popularity (most-viewed first) | |
| date | No | Date to query in "YYYY-MM-DD" format. Omit for today's movers. | |
| limit | No | Number of events to return per page (default: 20, max: 100) | |
| next_params | No | Pagination cursor from previous response next_params field. Pass the entire next_params object returned by the previous call to get the next page. Omit for the first page. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | No | Mover events. | |
| updated_at | No | Last refresh time (RFC3339). | |
| next_params | No | Pagination cursor. Pass back verbatim as `next_params` to fetch the next page. Opaque object — exact fields are an implementation detail. |