cb-lists

---
name: cb-lists
description: 可转债全量列表（market.ft.tech）。用户问可转债列表、全部可转债、转债代码列表、有哪些可转债时使用。
---

# 可转债列表 - 获取可转债列表

## 1. 接口描述

| 项目 | 说明 |
|------|------|
| 接口名称 | 获取可转债列表 |
| 外部接口 | `GET /api/v1/market/data/cb/cb-lists` |
| 请求方式 | GET |
| 适用场景 | 获取当前可转债全量列表（全称、债券代码、正股代码、交易所）；仅包含通过可转债号段判断的标的，数据为前一交易日 |

## 2. 请求参数

说明：该接口无需请求参数。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| - | - | - | 无需参数 | - | - |

## 3. 响应说明

返回可转债列表；无数据时 `items` 为空数组 `[]`。

```json
{
  "items": [
    {
      "full_name": "恒逸石化股份有限公司可转换公司债券",
      "cb_id": 110070,
      "stock_id": 703,
      "exchange": 1
    },
    {
      "full_name": "浙江伟明环保股份有限公司可转换公司债券",
      "cb_id": 113643,
      "stock_id": 603568,
      "exchange": 1
    }
  ]
}
```

### CbListsItem 字段

| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|--------|------|------------|------|------|
| full_name | string | 否 | 债券全称 | - |
| cb_id | int | 否 | 债券代码 | - |
| stock_id | int | 否 | 转债对应正股代码 | - |
| exchange | int | 否 | 交易所 | - |

## 4. 用法

通过主目录 `run.py` 调用（无需参数）：

```bash
python <RUN_PY> cb-lists
```

`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON；本接口无需额外请求头。

## 5. 请求示例

```
GET /api/v1/market/data/cb/cb-lists
```

## 6. 注意事项

- 数据为前一交易日可转债列表，具体以接口返回为准
- 无数据时返回 `{"items": []}`

• SKILL.md 2 KB
• scripts/handler.py 2 KB