使用清华源安装（推荐） 如官方源下载较慢，推荐使用清华镜像源： pip install cmesdata -U -i https://pypi.tuna.tsinghua.edu.cn/simple 接口介绍 展示国内股票数据接口的功能说明、调用样例和注意事项。 股票接口提供实时行情、历史K线、分笔tick等多种数据获取方式。 实时行情：支持获取沪深股票、ETF、指数、可转债的五档订单薄实时行情数据。 历史数据：支持获取日线、分钟线等不同频率的历史K线数据，可盘中更新。 分笔数据：提供股票、ETF、可转债的分笔成交tick历史行情数据，盘后更新。 登录、登出接口 登录 / token 登录接口，传参为个人token。 #登录接口 login("c79cesdffwerfer56422f9sdffgrtg35ec8") #退出登录 login_out() *注意事项： 1、token可在权限申请处复制，开通权限后即可使用。 2、登录接口在程序启动后，只需要调用一次，建立长连接即可，请不要频繁调用登录接口 五档订单薄实时行情 五档 / 实时 盘中提供沪深股票、ETF、指数的五档订单薄实时行情数据。 *入参为列表，返回为DataFrame格式数据 3、接口仅盘中提供实时行情，盘后返回空 df = get_real_hq(['SH.600000', 'SZ.000001']) # 注意:品种入参是列表，不要忘记[] *注意事项： 1、单次可获取80只股票（超过请分批获取） 2、单次请求，股票代码列表中不能有错误或者停牌的代码，否则返回空数据。 代码 价格 昨收价 开盘价 最高价 最低价 时间 成交量 成交额 总卖 总买 买一价 卖一价 买一量 卖一量 买二价 卖二价 买二量 卖二量 买三价 卖三价 买三量 卖三量 买四价 卖四价 买四量 卖四量 买五价 卖五价 买五量 卖五量 0 600000 11.37 11.62 11.60 11.65 11.35 2025-11-17 21:51:54 984855 1.127109e+09 644410 340445 11.36 11.37 4767 944 11.35 11.38 9624 4537 11.34 11.39 1696 3879 11.33 11.40 3259 1090 11.32 11.41 1176 422 1 000001 11.67 11.75 11.75 11.75 11.62 2025-11-17 21:51:54 995232 1.161416e+09 531978 463255 11.67 11.68 1559 1312 11.66 11.69 6836 6015 11.65 11.70 11362 5688 11.64 11.71 5905 2062 11.63 11.72 5870 4163 可转债五档订单薄实时行情 五档 / 实时 提供可转债的五档订单薄实时行情数据。 *入参为列表，返回为DataFrame格式数据 df = get_real_kzz(['SH.113634', 'SZ.127071']) # 注意:品种入参是列表，不要忘记[] *注意事项： 1、单次可获取80只可转债（超过请分批获取） 2、单次请求，代码列表中不能有错误或者停牌的可转债代码，否则返回空数据。 3、接口仅盘中提供实时行情，盘后返回空 代码 价格 昨收价 开盘价 最高价 最低价 时间 成交量 成交额 总卖 总买 买一价 卖一价 买一量 卖一量 买二价 卖二价 买二量 卖二量 买三价 卖三价 买三量 卖三量 买四价 卖四价 买四量 卖四量 买五价 卖五价 买五量 卖五量 0 113634 126.930 127.587 127.398 127.648 126.704 2025-11-17 21:54:26 21831 27720952.0 10838 10993 126.900 127.001 645 4 126.843 127.002 1 99 126.800 127.040 200 2 126.78 127.043 4 99 126.763 127.094 1 28 1 127071 135.413 136.074 136.670 139.000 135.101 2025-11-17 21:54:26 29663 40522148.0 17221 12442 135.348 135.413 2 2 135.300 135.414 1 13 135.211 135.415 1 2 135.21 135.416 3 30 135.209 135.458 3 8 历史K线数据 股票 / K线 提供沪深股票、ETF、可转债日线、分钟线等近5个月历史行情数据，可盘中实时更新。 *入参为代码、起始日期、结束日期、频率，返回为DataFrame格式数据 频率：1min、5min、15min、30min、60min、D(日线)、W(周线)、M(月线) df = get_history_data("SZ.000001", "2025-01-01", "2025-11-13", "1min") 注意：上海和深圳股票、ETF、可转债代码前缀分别为SH和SZ。 时间 开盘价 最高价 最低价 收盘价 成交量 成交额 0 2025-07-07 09:31:00 12.60 12.65 12.60 12.65 5170900.0 65207856.0 1 2025-07-07 09:32:00 12.64 12.68 12.60 12.62 3552900.0 44927408.0 2 2025-07-07 09:33:00 12.62 12.67 12.60 12.67 2450600.0 30951484.0 3 2025-07-07 09:34:00 12.66 12.66 12.63 12.64 1479900.0 18712490.0 4 2025-07-07 09:35:00 12.64 12.64 12.61 12.61 1256700.0 15860039.0 ... ... ... ... ... ... ... ... 21115 2025-11-13 14:56:00 11.70 11.71 11.69 11.70 875500.0 10241476.0 21116 2025-11-13 14:57:00 11.69 11.71 11.69 11.69 207700.0 2430150.0 21117 2025-11-13 14:58:00 11.70 11.70 11.70 11.70 1300.0 15210.0 21118 2025-11-13 14:59:00 11.70 11.70 11.70 11.70 0.0 0.0 21119 2025-11-13 15:00:00 11.70 11.70 11.70 11.70 1150500.0 13460850.0 指数历史K线数据 指数 / K线 提供指数日线、分钟线等近5个月历史行情数据，可盘中实时更新。 *入参为代码、起始日期、结束日期、频率，返回为DataFrame格式数据 频率：1min、5min、15min、30min、60min、D(日线)、W(周线)、M(月线) df = get_index_data("SH.000001", "2025-01-01", "2025-11-13", "1min") 注意： 上海指数00开头，例如：SH.000001（上证指数） 深圳指数399开头，例如：SZ.399001（深证指数） 时间 开盘价 最高价 最低价 收盘价 成交量 成交额 0 2025-07-07 09:31:00 3467.98 3467.98 3466.68 3466.68 212590960.0 2.125910e+10 1 2025-07-07 09:32:00 3466.52 3468.88 3466.32 3467.20 126269952.0 1.262700e+10 2 2025-07-07 09:33:00 3467.32 3469.01 3465.88 3468.71 86889384.0 8.688939e+09 3 2025-07-07 09:34:00 3469.52 3469.52 3467.25 3467.40 74650608.0 7.465062e+09 4 2025-07-07 09:35:00 3467.20 3467.20 3464.09 3464.17 70837960.0 7.083796e+09 ... ... ... ... ... ... ... ... 21115 2025-11-13 14:56:00 4029.80 4030.13 4029.43 4029.93 60431156.0 6.043117e+09 21116 2025-11-13 14:57:00 4030.20 4030.40 4029.53 4029.53 67377768.0 6.737778e+09 21117 2025-11-13 14:58:00 4030.11 4030.33 4030.11 4030.28 4642201.0 4.642203e+08 21118 2025-11-13 14:59:00 4030.28 4030.28 4030.28 4030.28 0.0 0.000000e+00 21119 2025-11-13 15:00:00 4029.99 4029.99 4029.50 4029.50 102880552.0 1.028806e+10 分笔成交tick 高频 / tick 提供股票、ETF、可转债分笔成交tick近5个月历史行情数据，盘后更新。 *入参为代码、日期，返回为DataFrame格式数据 df = get_tick("SZ.000001", "2025-11-17") *注意事项：返回结果中的买卖方向:0(买)1(卖)2(中性) 时间 价格 成交量 买卖方向 0 09:25 11.68 5277 2 1 09:30 11.70 1806 0 2 09:30 11.68 4927 1 3 09:30 11.68 993 1 4 09:30 11.69 265 1 ... ... ... ... ... 4223 14:56 11.70 51 0 4224 14:56 11.70 11 0 4225 14:56 11.69 78 1 4226 14:57 11.70 13 2 4227 15:00 11.70 11505 2 完整代码展示 样例 / demo 使用接口前，请先安装库：cmesdata（参考接口安装页面指导）以下为样例代码展示，如未获取到数据，请先检查入参是否正确，实时行情接口入参中不能有错误代码和停盘股票 from cmesdata import * # 使用自己的token登录 login("c79cesab1a56422h9a920fe0aad35e38") # 实时股票五档订单薄 df = get_real_hq(['SH.600000', 'SZ.000001']) # 注意:品种入参是列表，不要忘记[] print(df) # 实时可转债五档订单薄 df = get_real_kzz(['SH.113634', 'SZ.127071']) # 注意:品种入参是列表，不要忘记[] print(df) # 历史行情数据 df = get_history_data("SZ.000001", "2026-03-12", "2026-03-13", "1min") print(df) # 指数历史行情 df = get_index_data("SH.000001", "2026-03-12", "2026-03-13", "D") print(df) # 历史分笔tick df = get_tick("SH.600000", "2026-03-13") print(df) # 程序结束退出登录 login_out()