TDX股票查询技能

功能描述

本技能基于TDX股票数据API，提供以下全面功能：

基础数据查询

• 股票实时五档行情查询
• K线数据查询（分钟/小时/日/周/月/季/年）
• 分时走势数据查询
• 分时成交明细查询
• 股票代码搜索
• 股票综合信息查询

扩展功能

• 股票代码列表获取
• 批量行情查询
• 历史K线范围查询
• 指数数据查询
• 市场统计数据
• 服务状态查询

数据入库任务

• 批量K线数据入库任务
• 分时成交数据入库任务
• 任务状态查询和控制

高级数据服务

• ETF基金列表查询
• 历史分时成交分页查询
• 全天分时成交汇总
• 交易日信息查询
• 市场证券数量统计
• 全部股票代码查询
• 全部ETF代码查询
• 股票历史K线全集
• 指数历史K线全集
• 上市以来分时成交
• 交易日范围列表
• 收益区间分析
• 个股新闻查询
• 股票公告查询

API地址配置（必须）

重要：使用本技能前，必须先配置API地址！

1. TDX API配置

本技能需要用户自行提供TDX API的服务地址，通过环境变量 TDX_API_URL 进行配置。

环境变量名称: TDX_API_URL

配置方法:

1. 环境变量方式:

   export TDX_API_URL=http://your-api-domain.com
   

2. .env文件方式:

   TDX_API_URL=http://your-api-domain.com
   

2. akshare API配置（可选）

如果需要使用个股新闻查询功能，还需要配置akshare API地址。

环境变量名称: AKSHARE_API_URL

配置方法:

1. 环境变量方式:

   export AKSHARE_API_URL=http://your-akshare-api.com
   

2. .env文件方式:

   AKSHARE_API_URL=http://your-akshare-api.com
   

注意：AKSHARE_API_URL 是可选的，仅当需要使用个股新闻查询功能时才需要配置。

使用方式:

from main import TDXStockQuery

# 初始化时会自动读取TDX_API_URL环境变量
stock_query = TDXStockQuery()

# 查询股票信息
result = stock_query.get_quote(['000001'])

未配置环境变量的错误提示: 如果未配置 TDX_API_URL 环境变量，初始化时会抛出错误：

ValueError: 环境变量 TDX_API_URL 未设置，请先配置API地址

接口说明

1. 获取五档行情

接口: get_quote(codes)

参数: codes - 股票代码列表，如 ['000001', '600519']

示例:

result = stock_query.get_quote(['000001', '600519'])

返回数据包含:

• Exchange: 交易所代码
• Code: 股票代码
• K: 昨收、开盘、最高、最低、收盘价（厘）
• TotalHand: 总手数
• Amount: 成交额
• InsideDish: 内盘
• OuterDisc: 外盘
• BuyLevel: 买五档
• SellLevel: 卖五档

2. 获取K线数据

接口: get_kline(code, ktype='day')

参数:

• code - 股票代码，如 '000001'
• ktype - K线类型，默认day

K线类型: minute1, minute5, minute15, minute30, hour, day, week, month, quarter, year

示例:

result = stock_query.get_kline('000001', 'day')
result = stock_query.get_kline('600519', 'minute30')

返回数据包含:

• Last, Open, High, Low, Close: 价格（厘）
• Volume: 成交量（手）
• Amount: 成交额（厘）
• Time: 时间
• UpCount, DownCount: 上涨下跌数（指数有效）

3. 获取分时数据

接口: get_minute(code, date=None)

参数:

• code - 股票代码，如 '000001'
• date - 日期（YYYYMMDD格式），默认当天

示例:

result = stock_query.get_minute('000001')
result = stock_query.get_minute('000001', '20241103')

返回数据包含:

• date: 实际数据日期
• Count: 数据点数量
• List: 分时数据列表（Time, Price, Number）

4. 获取分时成交

接口: get_trade(code, date=None)

参数:

• code - 股票代码，如 '000001'
• date - 日期（YYYYMMDD格式），默认当天

示例:

result = stock_query.get_trade('000001')
result = stock_query.get_trade('000001', '20241103')

返回数据包含:

• Time: 成交时间
• Price: 成交价（厘）
• Volume: 成交量（手）
• Status: 0=买入, 1=卖出, 2=中性
• Number: 成交单数

5. 搜索股票代码

接口: search_stock(keyword)

参数: keyword - 搜索关键词（代码或名称）

示例:

result = stock_query.search_stock('平安')
result = stock_query.search_stock('000001')