# Top List

Daily Dragon-Tiger List statistics, covering stocks that triggered exchange disclosure due to abnormal price moves, turnover, or amplitude. Each record includes the trigger reason and aggregated list buy amount, sell amount, and net buy, used to capture short-term capital anomalies and hot-money targets. Coverage is defined by exchange disclosure rules and includes only qualifying stocks, not the whole market; an appearance is an after-the-fact anomaly signal, so pair it with seat-level detail to characterize the money behind it.

`GET /v2/market/top-list`

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | Stock code, e.g. 000001.SZ |
| `start_date` | string | No | Start date (YYYYMMDD) |
| `end_date` | string | No | End date (YYYYMMDD) |
| `trade_date` | string | No | Trading date YYYYMMDD (single day) |

## Response Fields

| Field | Type | Description |
| --- | --- | --- |
| `trade_date` | string | Trading date |
| `symbol` | string | Stock code |
| `name` | string | Stock name |
| `close` | number | Closing price |
| `pct_change` | number | Price change % |
| `turnover_rate` | number | Turnover rate % |
| `amount` | number | Total turnover (CNY) |
| `l_sell` | number | Institutional sell (CNY) |
| `l_buy` | number | Institutional buy (CNY) |
| `l_amount` | number | Institutional total (CNY) |

## API Example

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/market/top-list?symbol=000001.SZ"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.top_list(symbol="000001.SZ")
print(df.head())
```

## Sample Data

returns a pandas.DataFrame

| trade_date | symbol | name | close | pct_change | turnover_rate | amount | l_sell | l_buy | l_amount |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 20240221 | 000001.SZ | 平安银行 | 10.8 | 9.98 | 2.61 | 5295259397 | 429200090.1 | 994426871.29 | 1423626961.39 |
| 20221129 | 000001.SZ | 平安银行 | 12.99 | 9.99 | 2.45 | 6026006642 | 556437446.3 | 1260957497.18 | 1817394943.48 |