tdx2db: Skill for Claude Code

tdx2db 数据库查询手册

数据库由 tdx2db sync 写入（PostgreSQL / MySQL / SQLite，连接配置见项目 .env）。查询前先读 AGENTS.md 的 schema 与陷阱清单；本 skill 提供可直接套用的操作模板。

第一步永远是确认数据状态

tdx2db status --json

关注三点：daily_data.latest 是否为预期交易日；rows/codes 是否符合常识（全市场约 4000+ 只）；warnings 是否为空。任何分析在数据不新鲜/不完整时都是白做。

SQL 模板

单票日线（含缠论均线族）

SELECT date, open, high, low, close, volume, amount,
       ma5, ma13, ma21, ma34, ma55, ma89, ma144, ma233
FROM daily_data
WHERE code = :code6      -- 6 位纯数字，如 '600036'，不带 sh/sz 前缀！
  AND date BETWEEN :start AND :end
ORDER BY date;

某日全市场截面（成熟股票）

SELECT code, close, ma5, ma13, ma21, ma34, ma55, ma89, ma144, ma233
FROM daily_data
WHERE date = :d AND ma233 IS NOT NULL;   -- ma233 非空 ≈ 上市满一年，天然剔除次新股

最新可用交易日

SELECT MAX(date) FROM daily_data WHERE ma5 IS NOT NULL;

分钟线（表按周期选：minute5_data / minute15_data / minute30_data / minute60_data）

SELECT datetime, open, high, low, close, volume, amount
FROM minute30_data
WHERE code = :code6 AND datetime BETWEEN :start AND :end
ORDER BY datetime;

周线/月线：无独立表，取日线后 pandas resample('W')/resample('ME') 聚合（open=first, high=max, low=min, close=last, volume/amount=sum）。

板块成分 / 个股板块归属（block_type ∈ 行业/概念/指数/地区/风格/特殊）

-- 板块 → 成分（行业为 881 研究行业，一/二/三级各一行，按名或 block_code 定位）
SELECT code FROM block_stock_relation
WHERE block_type = '行业' AND block_name = '煤炭开采';

-- 全部二级行业（≈ 通达信导出 CSV 的行业口径，板块强弱迭代用这个）
SELECT DISTINCT block_name FROM block_stock_relation
WHERE block_type = '行业' AND block_level = 2;

-- 个股 → 全部板块归属
SELECT block_type, block_code, block_name FROM block_stock_relation WHERE code = :code6;

-- 板块成分 JOIN 行情（北交所成员在行情表无数据，JOIN 自然过滤）
SELECT d.code, d.close, d.ma233
FROM block_stock_relation b JOIN daily_data d ON d.code = b.code
WHERE b.block_type = '概念' AND b.block_name = '人形机器人' AND d.date = :d;

板块表为全量快照（随 sync 更新，无历史版本）；板块名以 tdxzs.cfg 官方全名为准，跨口径对齐用 block_code。

换手率 / 次新股过滤（股本与上市日期在 stock_info，万股，快照口径）

-- 换手率(%)：volume(手)/ltag(万股) 单位差恰好抵消；股本变动点前的历史值失真
SELECT d.date, d.volume / s.ltag AS turnover_pct
FROM daily_data d JOIN stock_info s ON RIGHT(s.code, 6) = d.code
WHERE d.code = :code6 ORDER BY d.date DESC LIMIT 20;

-- 剔除次新股（上市不足 500 天）
SELECT RIGHT(code, 6) FROM stock_info WHERE list_date < CURRENT_DATE - 500;