🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › 通达信TDX股票查询技能
🦀 ClawHub

通达信TDX股票查询技能

by @bensema

基于TDX API的股票数据查询技能，提供全面的A股市场数据查询功能，包括实时行情、K线数据、分时数据、分时成交、股票搜索、指数数据、ETF数据、市场统计、个股新闻、股票公告等31个API接口。当用户询问股票相关信息时调用。

Versionv1.0.0
Downloads796
#clawhub
TERMINAL
clawhub install tdx-api-skill

📖 About This Skill

name: "tdx-stock-query" description: "基于TDX API的股票数据查询技能，提供全面的A股市场数据查询功能，包括实时行情、K线数据、分时数据、分时成交、股票搜索、指数数据、ETF数据、市场统计、个股新闻、股票公告等31个API接口。当用户询问股票相关信息时调用。"

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')

    返回数据包含:

  • code: 股票代码
  • name: 股票名称

    • 6. 获取股票综合信息

    接口: get_stock_info(code)

    参数: code - 股票代码，如 '000001'

    示例: 

    result = stock_query.get_stock_info('000001')

    返回数据包含:

  • quote: 五档行情
  • kline_day: 最近30天日K线
  • minute: 今日分时数据

    • 7. 获取股票详细信息列表

    接口: get_codes(exchange='all')

    参数: exchange - 交易所代码，默认all

    交易所代码: sh, sz, bj, all

    示例: 

    result = stock_query.get_codes()
result = stock_query.get_codes('sh')

    返回数据包含:

  • total: 总数量
  • exchanges: 各交易所数量
  • codes: 股票详细信息列表（包含代码、名称、交易所）

    • 8. 批量获取行情

    接口: batch_quote(codes)

    参数: codes - 股票代码列表，最多50只

    示例: 

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

    9. 获取历史K线

    接口: get_kline_history(code, ktype='day', start_date=None, end_date=None, limit=100)

    参数:

  • code - 股票代码
  • ktype - K线类型
  • start_date - 开始日期（YYYYMMDD）
  • end_date - 结束日期（YYYYMMDD）
  • limit - 返回条数，默认100，最大800

    • 示例: 

    result = stock_query.get_kline_history('000001', 'day', limit=30)
result = stock_query.get_kline_history('000001', 'day', start_date='20241001', end_date='20241101')

    10. 获取指数数据

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

    参数:

  • code - 指数代码，如 'sh000001'
  • ktype - K线类型，默认day

    • 常用指数代码:

  • sh000001 - 上证指数
  • sz399001 - 深证成指
  • sz399006 - 创业板指
  • sh000300 - 沪深300

    • 示例: 

    result = stock_query.get_index('sh000001', 'day')

    11. 获取服务状态

    接口: get_server_status()

    示例: 

    result = stock_query.get_server_status()

    返回数据包含:

  • status: 服务状态
  • connected: 连接状态
  • version: 版本号
  • uptime: 运行时间

    • 12. 健康检查

    接口: health_check()

    示例: 

    result = stock_query.health_check()

    13. 创建批量K线入库任务

    接口: create_pull_kline_task(codes=None, tables=None, dir=None, limit=1, start_date=None)

    参数:

  • codes - 股票代码数组，默认全部A股
  • tables - K线类型列表，默认['day']
  • dir - 存储目录，默认'data/database/kline'
  • limit - 并发协程数量，默认1
  • start_date - 起始日期阈值

    • K线类型: minute, 5minute, 15minute, 30minute, hour, day, week, month, quarter, year

    示例: 

    result = stock_query.create_pull_kline_task(
    codes=['000001', '600519'],
    tables=['day', 'week', 'month'],
    limit=4,
    start_date='2020-01-01'
)

    返回数据包含:

  • task_id: 任务ID

    • 14. 创建分时成交入库任务

    接口: create_pull_trade_task(code, dir=None, start_year=2000, end_year=None)

    参数:

  • code - 股票代码
  • dir - 输出目录，默认'data/database/trade'
  • start_year - 起始年份，默认2000
  • end_year - 结束年份，默认当年

    • 示例: 

    result = stock_query.create_pull_trade_task(
    code='000001',
    start_year=2015,
    end_year=2023
)

    15. 查询任务列表

    接口: get_tasks()

    示例: 

    result = stock_query.get_tasks()

    16. 查询任务详情

    接口: get_task_detail(task_id)

    参数: task_id - 任务ID

    示例: 

    result = stock_query.get_task_detail('9b0d1b1b-7c3d-4ce6-9a0e-bd9f5e0dcf3b')

    17. 取消任务

    接口: cancel_task(task_id)

    参数: task_id - 任务ID

    示例: 

    result = stock_query.cancel_task('9b0d1b1b-7c3d-4ce6-9a0e-bd9f5e0dcf3b')

    18. 获取ETF列表

    接口: get_etf(exchange='all', limit=None)

    参数:

  • exchange - 交易所，默认all
  • limit - 返回条数限制

    • 示例: 

    result = stock_query.get_etf()
result = stock_query.get_etf('sh', limit=10)

    返回数据包含:

  • code: ETF代码
  • name: ETF名称
  • exchange: 交易所
  • last_price: 最新价格

    • 19. 获取历史分时成交（分页）

    接口: get_trade_history(code, date, start=0, count=2000)

    参数:

  • code - 股票代码
  • date - 交易日期（YYYYMMDD）
  • start - 起始游标，默认0
  • count - 返回条数，默认2000，最大2000

    • 示例: 

    result = stock_query.get_trade_history('000001', '20241108')
result = stock_query.get_trade_history('000001', '20241108', start=0, count=1000)

    20. 获取全天分时成交

    接口: get_minute_trade_all(code, date=None)

    参数:

  • code - 股票代码
  • date - 交易日期（YYYYMMDD），默认当天

    • 示例: 

    result = stock_query.get_minute_trade_all('000001')
result = stock_query.get_minute_trade_all('000001', '20241108')

    21. 查询交易日信息

    接口: get_workday(date=None, count=1)

    参数:

  • date - 查询日期（YYYYMMDD），默认当天
  • count - 返回的前后交易日数量，范围1-30，默认1

    • 示例: 

    result = stock_query.get_workday()
result = stock_query.get_workday('20241108', count=3)

    返回数据包含:

  • date: 查询日期
  • is_workday: 是否交易日
  • next: 后续交易日
  • previous: 前续交易日

    • 22. 获取市场证券数量

    接口: get_market_count()

    示例: 

    result = stock_query.get_market_count()

    返回数据包含:

  • total: 总数量
  • exchanges: 各交易所数量

    • 23. 获取全部股票代码

    接口: get_stock_codes(limit=None, prefix=True)

    参数:

  • limit - 返回条数限制
  • prefix - 是否包含交易所前缀，默认true

    • 示例: 

    result = stock_query.get_stock_codes()
result = stock_query.get_stock_codes(limit=100, prefix=False)

    返回数据包含:

  • count: 代码总数
  • list: 股票代码列表

    • 24. 获取全部ETF代码

    接口: get_etf_codes(limit=None, prefix=True)

    参数:

  • limit - 返回条数限制
  • prefix - 是否包含交易所前缀，默认true

    • 示例: 

    result = stock_query.get_etf_codes()
result = stock_query.get_etf_codes(limit=50, prefix=False)

    返回数据包含:

  • count: 代码总数
  • list: ETF代码列表

    • 25. 获取股票全部历史K线

    接口: get_kline_all(code, ktype='day', limit=None)

    参数:

  • code - 股票代码
  • ktype - K线类型，默认day
  • limit - 返回条数限制

    • 示例: 

    result = stock_query.get_kline_all('000001')
result = stock_query.get_kline_all('000001', 'day', limit=100)

    26. 获取指数全部历史K线

    接口: get_index_all(code, ktype='day', limit=None)

    参数:

  • code - 指数代码
  • ktype - K线类型，默认day
  • limit - 返回条数限制

    • 示例: 

    result = stock_query.get_index_all('sh000001')
result = stock_query.get_index_all('sh000001', 'day', limit=200)

    27. 获取上市以来分时成交

    接口: get_trade_history_full(code, before=None, limit=None)

    参数:

  • code - 股票代码
  • before - 截止日期（YYYYMMDD），默认今天
  • limit - 返回条数限制

    • 示例: 

    result = stock_query.get_trade_history_full('000001')
result = stock_query.get_trade_history_full('000001', before='20241108', limit=5000)

    28. 获取交易日范围

    接口: get_workday_range(start, end)

    参数:

  • start - 起始日期（YYYYMMDD）
  • end - 结束日期（YYYYMMDD）

    • 示例: 

    result = stock_query.get_workday_range('20241101', '20241130')

    29. 计算收益区间指标

    接口: get_income(code, start_date)

    参数:

  • code - 股票代码
  • start_date - 基准日期（YYYYMMDD）

    • 示例: 

    result = stock_query.get_income('000001', '20241101')

    30. 个股新闻查询

    接口: get_stock_news(symbol)

    参数:

  • symbol - 股票代码或关键词，如 '603777' 或 '宁德时代'

    • 示例: 

    # 查询股票代码相关新闻
result = stock_query.get_stock_news('603777')
    查询关键词相关新闻
    
result = stock_query.get_stock_news('宁德时代')

    返回数据包含:

  • 关键词: 搜索关键词
  • 新闻标题: 新闻标题
  • 新闻内容: 新闻内容摘要
  • 发布时间: 新闻发布时间
  • 文章来源: 新闻来源
  • 新闻链接: 新闻详情链接

    • 注意:

  • 需要配置环境变量 AKSHARE_API_URL 才能使用此功能
  • 当查询关键词包含中文时，API会自动进行URL编码
  • 新闻数据来自东方财富网

    • 31. 股票公告查询

    接口: get_stock_disclosure(symbol, start_date, end_date, market='沪深京', category=None, keyword=None)

    参数:

  • symbol - 股票代码，如 '300058'
  • start_date - 起始日期，格式YYYYMMDD，如 '20260101'
  • end_date - 结束日期，格式YYYYMMDD，如 '20260314'
  • market - 市场，默认'沪深京'
  • category - 公告分类，如 '年报'、'董事会'、'权益分派' 等（可选）
  • keyword - 关键词搜索，在公告标题中进行搜索（可选）

    • 公告分类选项:

  • 定期报告: '年报'、'半年报'、'一季报'、'三季报'
  • 业绩相关: '业绩预告'
  • 公司治理: '董事会'、'监事会'、'股东大会'、'公司治理'
  • 股本权益: '权益分派'、'股权变动'、'股权激励'、'解禁'
  • 融资相关: '增发'、'配股'、'公司债'、'可转债'
  • 重大事项: '资产重组'、'日常经营'、'风险提示'
  • 其他: '中介报告'、'首发'、'补充更正'、'澄清致歉'等

    • 示例: 

    # 查询股票300058在2026年第一季度发布的所有类型公告
result = stock_query.get_stock_disclosure('300058', '20260101', '20260331')
    查询股票300058在2026年发布的"董事会"相关公告
    
result = stock_query.get_stock_disclosure('300058', '20260101', '20261231', category='董事会')
    查询股票300058近期关于"权益分派"的公告
    
result = stock_query.get_stock_disclosure('300058', '20250101', '20260314', category='权益分派')
    查询股票300058在2025年全年标题中包含"担保"关键词的公告
    
result = stock_query.get_stock_disclosure('300058', '20250101', '20251231', keyword='担保')

    返回数据包含:

  • 代码: 股票代码
  • 简称: 股票简称
  • 公告标题: 公告的完整标题
  • 公告时间: 公告的发布日期
  • 公告链接: 指向巨潮资讯网公告原文PDF/HTML的直达链接

    • 注意:

  • 需要配置环境变量 AKSHARE_API_URL 才能使用此功能
  • 必须指定日期范围，无法一次性获取"最新100条"
  • 数据来源是巨潮资讯网，具有最高权威性
  • 公告链接可直接访问PDF原文，用于存档或深度分析
  • 建议设定足够长的近期范围（如过去一年），然后按公告时间倒序排列取前100条，即为最新的100条权威公告

    • 使用示例

    查询股票实时行情

    用户提问: 查询平安银行和贵州茅台的实时行情

    调用代码: 

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

    查询股票K线数据

    用户提问: 查询贵州茅台最近30天的日K线数据

    调用代码: 

    result = stock_query.get_kline_history('600519', 'day', limit=30)

    查询股票分时数据

    用户提问: 查询平安银行今天的分时走势

    调用代码: 

    result = stock_query.get_minute('000001')

    查询股票分时成交

    用户提问: 查询贵州茅台今天的分时成交明细

    调用代码: 

    result = stock_query.get_trade('600519')

    搜索股票

    用户提问: 搜索包含"平安"的股票

    调用代码: 

    result = stock_query.search_stock('平安')

    查询指数数据

    用户提问: 查询上证指数的日K线数据

    调用代码: 

    result = stock_query.get_index('sh000001', 'day')

    批量获取行情

    用户提问: 批量获取自选股的实时行情

    调用代码: 

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

    查询ETF列表

    用户提问: 查询所有ETF基金

    调用代码: 

    result = stock_query.get_etf()

    查询交易日信息

    用户提问: 查询2024年11月8日是否为交易日

    调用代码: 

    result = stock_query.get_workday('20241108')

    创建数据入库任务

    用户提问: 创建批量K线数据入库任务

    调用代码: 

    result = stock_query.create_pull_kline_task(
    codes=['000001', '600519'],
    tables=['day', 'week'],
    limit=2
)

    数据说明

    价格单位

  • 所有价格单位为"厘"（1元 = 1000厘）
  • 转换公式：价格（元）= 价格（厘） / 1000

    • 成交量单位

  • 成交量单位为"手"（1手 = 100股）
  • 挂单量单位为"股"

    • 时间格式

  • 分时数据时间格式：HH:MM
  • K线数据时间格式：ISO 8601格式
  • 分时成交时间格式：ISO 8601格式

    • 日期格式

  • API请求日期格式：YYYYMMDD（如20241108）
  • 也支持YYYY-MM-DD格式（如2024-11-08）

    • 响应格式

    所有接口统一返回格式： 
    {
  "code": 0,           // 0=成功, -1=失败
  "message": "success", // 提示信息
  "data": {}           // 数据内容
}

    注意事项

    1. 必须配置环境变量：在使用本技能前，必须先配置 TDX_API_URL 环境变量 2. 股票代码格式：股票代码必须为6位数字，如000001（平安银行）、600519（贵州茅台） 3. 批量查询限制：批量获取行情一次最多查询50只股票 4. 数据回退机制：分时数据查询时，如果指定日期无数据，会自动回退至最近一个有交易数据的工作日 5. K线复权说明：日/周/月K线默认返回同花顺前复权数据 6. 非交易时段：非交易时段查询可能返回最新的收盘数据 7. 任务管理：数据入库任务在后台异步执行，需要通过任务管理接口查询状态 8. 数据量控制：全量数据较大，建议配合limit参数控制响应大小 9. 交易日查询：交易日查询会返回前后若干个最近的交易日信息 10. 错误处理：所有接口都有完善的错误处理机制，返回详细的错误信息

    常用股票代码

    蓝筹股

  • 000001 - 平安银行
  • 600519 - 贵州茅台
  • 601318 - 中国平安
  • 000858 - 五粮液
  • 600036 - 招商银行

    • 科技股

  • 000333 - 美的集团
  • 002415 - 海康威视
  • 300750 - 宁德时代
  • 688981 - 中芯国际

    • 指数代码

  • sh000001 - 上证指数
  • sz399001 - 深证成指
  • sz399006 - 创业板指
  • sh000300 - 沪深300
  • sz399905 - 中证500

    • 技术支持

    如有问题，请参考技术文档或联系技术支持。