ytdx 是一个用于连接同花顺Level2数据服务器、获取A股市场实时数据的 Python 库。本文将以获取可转债 K 线数据为例，手把手教你完成操作。

📦 1. 安装 pytdx 首先需要安装 pytdx：

pip install pytdx

如果你使用的是较新的 Python 环境（如 Python 3.11+），建议用以下方式安装兼容分支：

pip install git+https://github.com/rainx/pytdx.git

⚙️ 2. 导入相关模块

from pytdx.hq import TdxHq_API

TdxHq_API 是 pytdx 提供的行情接口对象，用于连接行情服务器并请求各种行情数据。

🌐 3. 连接行情服务器 使用同花顺 Level2 的免费服务器之一，例如：

api = TdxHq_API()
with api.connect('119.147.212.81', 7709):
'119.147.212.81' 是服务器地址（广东电信）
7709 是行情端口号
with 语法表示自动管理连接的打开与关闭

✅ 建议使用 with 语法，这样在退出代码块时会自动关闭连接，防止资源泄露。

📈 4. 获取K线数据 核心函数是 get_security_bars，它的函数签名如下：

get_security_bars(category, market, code, start, count)

参数说明： 参数名 含义 示例

category	K线类型（见下方详细解释）	9
market	市场代码：0 表示深圳，1 表示上海	1
code	股票或可转债代码（如 113043 表示沪市可转债）	'113043'
start	起始位置（0 表示从最新数据开始）	0
count	请求的K线数量（最大为800）	10

常用 K 线类型一览表：

category	类型	说明
0	5分钟K线	intraday
1	15分钟K线	intraday
2	30