- name
- stock-unlock-by-stock
- description
- 按证券代码查询限售解禁批次及股东明细(market.ft.tech)。用户问某只股票限售解禁、解禁日期、解禁股东、解禁市值时使用。
# 限售解禁 - 按证券代码查询
## 1. 接口描述
| 项目 | 说明 |
|------|------|
| 接口名称 | 按证券代码查询限售解禁 |
| 外部接口 | `GET /api/v1/market/data/unlock/stock-unlock` |
| 请求方式 | GET |
| 适用场景 | 按证券代码分页查询限售解禁批次及股东明细 |
## 2. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| stock_code | string | 是 | 证券代码(6 位) | `000001` | - |
| page | int | 否 | 页码,从 1 开始 | `1` | 默认 1 |
| page_size | int | 否 | 每页条数 | `50` | 默认 50,最大 200 |
## 3. 响应说明
返回 `PaginatedApiResponse` 包装的 JSON 对象。
```json
{
"code": 0,
"message": "success",
"data": {
"pageNum": 1,
"pageSize": 50,
"total": 1,
"pages": 1,
"records": [
{
"stockCode": "000001",
"stockName": "平安银行",
"unlockDate": "2025-06-15",
"holderCount": "3",
"ableFreeShares": "1000000",
"currentFreeShares": "500000",
"nonFreeShares": "500000",
"liftMarketCap": "50000000",
"totalRatio": "0.05",
"freeRatio": "0.02",
"newPrice": "12.50",
"freeSharesType": "首发原股东限售股份",
"b20Adjchrate": "0.03",
"a20Adjchrate": "-0.01",
"crawlDate": "20250601",
"source": "eastmoney",
"holders": [
{
"holderName": "张三",
"addListingShares": "200000",
"actualListedShares": "200000",
"addListingCap": "2500000",
"lockMonth": "12",
"residualLimitedShares": "0",
"freeSharesType": "首发原股东限售股份",
"planFeature": "已实施"
}
]
}
]
}
}
```
### data.records 元素结构(批次)
| 字段名 | 类型 | 说明 |
|--------|------|------|
| stockCode | string | 证券代码 |
| stockName | string | 证券名称 |
| unlockDate | string | 解禁日期 |
| holderCount | string | 股东数量 |
| ableFreeShares | string | 可解禁股份 |
| liftMarketCap | string | 解禁市值 |
| totalRatio | string | 占总股本比例 |
| freeRatio | string | 占流通股本比例 |
| newPrice | string | 最新价 |
| freeSharesType | string | 限售股份类型 |
| b20Adjchrate | string | 解禁前20日涨跌幅 |
| a20Adjchrate | string | 解禁后20日涨跌幅 |
| holders | array | 股东明细列表 |
### holders 元素结构(股东明细)
| 字段名 | 类型 | 说明 |
|--------|------|------|
| holderName | string | 股东名称 |
| addListingShares | string | 新增上市股份 |
| actualListedShares | string | 实际上市股份 |
| addListingCap | string | 新增上市市值 |
| lockMonth | string | 锁定期(月) |
| residualLimitedShares | string | 剩余限售股份 |
| freeSharesType | string | 限售股份类型 |
| planFeature | string | 方案进度 |
## 4. 用法
通过主目录 `run.py` 调用:
```bash
python <RUN_PY> stock-unlock-by-stock --stock_code 000001
python <RUN_PY> stock-unlock-by-stock --stock_code 000001 --page 1 --page_size 50
```
## 5. 请求示例
```
GET /api/v1/market/data/unlock/stock-unlock?stock_code=000001&page=1&page_size=50
```
GitHubで見る