# 龙虎榜

每日龙虎榜统计，收录因涨跌幅、换手率或振幅异常而触发交易所信息披露的个股。每条记录包含上榜原因、龙虎榜买入额、卖出额及净买入等汇总数据，用于捕捉短线资金异动与游资活跃标的。覆盖范围由交易所披露规则决定，仅含触发条件的个股，并非全市场；上榜本身是事后异动信号，需结合席位明细进一步判断资金性质。

`GET /v2/market/top-list`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |
| `trade_date` | string | 否 | 交易日期，YYYYMMDD（查单日） |

## 返回字段

| 字段 | 说明 |
| --- | --- |
| `trade_date` | 交易日期 |
| `symbol` | 股票代码 |
| `name` | 股票名称 |
| `close` | 收盘价 |
| `pct_change` | 涨跌幅（%） |
| `turnover_rate` | 换手率（%） |
| `amount` | 成交额 |
| `l_sell` | 机构卖出额 |
| `l_buy` | 机构买入额 |
| `l_amount` | 机构成交总额 |

## 接口示例

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())
```

## 数据样例

返回 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 |