daxiapi-cli 2.4.1 → 2.5.0

package/README.md

@@ -1,6 +1,8 @@
 # daxiapi-cli
 
-大虾皮金融数据API命令行工具。需要注册 daxiapi.com 网站，并且获取API Token之后才能使用。
+大虾皮金融数据API命令行工具。需要注册 [daxiapi.com](https://daxiapi.com) 并获取 API Token 后才能使用。
+
+> 💡 `daxiapi` 命令也可以使用简写 `dxp`
 
 ## 安装
 
@@ -8,8 +10,8 @@
 # 全局安装
 npm install -g daxiapi-cli
 
-# 或使用 pnpm
-pnpm add -g daxiapi-cli
+# 或使用 npx（无需安装，始终使用最新版）
+npx daxiapi-cli@latest market index
 ```
 
 ## 配置
@@ -17,164 +19,170 @@ pnpm add -g daxiapi-cli
 首次使用需要配置 API Token（在 daxiapi.com 用户中心申请）：
 
 ```bash
-# 方式一：配置文件
+# 方式一：配置文件（推荐）
 daxiapi config set token YOUR_API_TOKEN
 
 # 方式二：环境变量
 export DAXIAPI_TOKEN=YOUR_API_TOKEN
 ```
 
-## 使用
-
-### 配置管理
+### 配置管理命令
 
 ```bash
-# 设置Token
-daxiapi config set token YOUR_API_TOKEN
-
-# 设置API地址（可选）
-daxiapi config set baseUrl https://daxiapi.com
-
 # 查看所有配置
 daxiapi config get
 
-# 删除配置
+# 设置配置项
+daxiapi config set token YOUR_API_TOKEN
+daxiapi config set baseUrl https://daxiapi.com
+
+# 删除配置项
 daxiapi config delete token
 ```
 
+---
+
+## 命令一览
+
 ### 市场数据
 
 ```bash
-# 市场概览（主流指数）
-daxiapi market
+# 主流指数行情（CS强度、多日涨跌幅）
+daxiapi market index
+
+# 市场三维结构综合判断（趋势+估值+情绪），推荐优先使用
+daxiapi market compass
 
-# 市场温度
+# 市场温度原始数据（估值温度、恐贪指数、趋势温度、动量温度）
 daxiapi market temp
 
-# 市场风格
+# 大小盘风格轮动（中证2000 vs 沪深300 差值及历史百分位）
 daxiapi market style
 
-# 市场估值
+# 主要指数估值（PE、PB、估值温度、历史百分位）
 daxiapi market value
 ```
 
+---
+
 ### 板块数据
 
 ```bash
-# 板块列表
-daxiapi sector
+# 板块热力图（按 CS 强度排序，默认展示前5）
+daxiapi sector heatmap
 
-# 指定排序和数量
-daxiapi sector --order zdf --limit 10
+# 按涨跌幅排序，展示前10
+daxiapi sector heatmap --order zdf --limit 10
 
-# 行业板块数据
+# 行业板块列表（今日涨幅、CS强度、CS均线）
 daxiapi sector bk
 
-# 板块内个股排名
+# 板块内个股排名（按 CS 强度排序）
 daxiapi sector stocks --code BK0457
 
-# 热门股票（各板块领涨股）
+# 板块内个股排名（按涨跌幅排序）
+daxiapi sector stocks --code BK0457 --order zdf
+
+# 热门股票（当日涨幅>7% 且 IBS>50 的强势股，按板块分组）
 daxiapi sector top
 
-# 热门概念板块
+# 热门概念板块（同花顺，默认）
 daxiapi sector gn
 
-# 使用同花顺数据源（默认）
-daxiapi sector gn --type ths
-
-# 使用东方财富数据源
+# 热门概念板块（东方财富数据源）
 daxiapi sector gn --type dfcf
 ```
 
-### 股票数据
+**sector stocks 排序字段**：`cs`（CS强度）、`zdf`（涨跌幅）、`sm`（市值）、`cg`（成交额）、`cr`（换手率）、`sctr`（SCTR排名）
 
-```bash
-# 搜索股票或板块
-daxiapi search 平安
-daxiapi search 锂电 --type bk
+---
 
-# 查询单个股票
+### 个股数据
+
+```bash
+# 查询单只股票详情
 daxiapi stock info 000001
 
-# 查询多个股票
+# 批量查询（最多20只，空格或逗号分隔）
 daxiapi stock info 000001 600031 300750
 
-# 概念股查询
+# 查询概念板块成分股（同花顺板块ID）
 daxiapi stock gn 881273
 
-# 技术形态筛选股票
+# 查询概念板块成分股（东方财富板块ID）
+daxiapi stock gn BK0428 --type dfcf
+
+# 技术形态选股
 daxiapi stock pattern vcp
 daxiapi stock pattern rps
 daxiapi stock pattern newHigh
+
+# 个股主力资金流向（默认5天）
+daxiapi stock capital-flow 600031
+
+# 个股主力资金流向（指定天数，最多30天）
+daxiapi stock capital-flow 600031 --days 10
 ```
 
-#### 支持的技术形态（pattern）
+#### 技术形态类型（stock pattern）
 
 | 形态代码 | 说明 |
 |---------|------|
 | **价值指标类** | |
-| gxl | 股息率大于3%的股票 |
+| `gxl` | 高股息率（股息率 > 3%） |
 | **强度指标类** | |
-| rps | RPS大于70的股票（欧奈尔RPS指标） |
-| sctr | SCTR大于70的股票（Stockcharts Rank相对强度排序） |
-| rpsTop3 | RPS行业前三 |
-| csTop3 | CS行业前三 |
-| sctrTop3 | SCTR行业前三 |
+| `rps` | RPS > 70（欧奈尔相对强度） |
+| `sctr` | SCTR > 70（Stockcharts 综合排名） |
+| `rpsTop3` | RPS 行业前三 |
+| `csTop3` | CS 强度行业前三 |
+| `sctrTop3` | SCTR 行业前三 |
 | **趋势形态类** | |
-| trendUp | K线趋势向上 |
-| high_60d | 大量创60日新高 |
-| newHigh | 新高附近 |
-| crossMa50 | 上穿MA50 |
-| crossoverBox | 价格行为交易法信号K，上穿箱体 |
-| cs_crossover_20 | CS穿过MA20 |
+| `trendUp` | K线趋势向上 |
+| `high_60d` | 近期创60日新高 |
+| `newHigh` | 年度新高附近 |
+| `crossMa50` | 上穿 MA50 |
+| `crossoverBox` | 价格行为信号K（上穿箱体） |
+| `cs_crossover_20` | CS 强度穿过 MA20 |
 | **成交量形态类** | |
-| fangliang | 放量上涨（前一天是VCP/3C形态，当天放量突破收盘在高点） |
-| fangliangtupo | 放量突破箱体 |
+| `fangliang` | 放量上涨（前日VCP形态，当日放量突破） |
+| `fangliangtupo` | 放量突破箱体 |
 | **涨跌幅排名类** | |
-| zdf1dTop3 | 1日涨幅行业前三 |
-| zdf5dTop3 | 5日涨幅行业前三 |
-| zdf10dTop3 | 10日涨幅行业前三 |
-| zdf20dTop3 | 20日涨幅行业前三 |
-| shizhiTop3 | 行业市值前三 |
+| `zdf1dTop3` | 1日涨幅行业前三 |
+| `zdf5dTop3` | 5日涨幅行业前三 |
+| `zdf10dTop3` | 10日涨幅行业前三 |
+| `zdf20dTop3` | 20日涨幅行业前三 |
+| `shizhiTop3` | 市值行业前三 |
 | **经典技术形态类** | |
-| vcp | 股魔VCP形态（波动收缩形态） |
-| joc | 跨越小溪Joc |
-| sos | 强势上涨SOS |
-| sos_h1 | SOS之后出现高1入场点 |
-| spring | Spring弹簧形态（上涨波段回调后出现spring向上） |
-| w | SOS之后出现W底吸收 |
-| lps | LPS最后供应点（SOS之后的LPS） |
-| ibs | K线实体较大（当日放量上涨收盘超昨日高点，实体长度超当日幅度69%） |
-```
+| `vcp` | VCP 波动收缩形态（股票魔法师） |
+| `joc` | Joc 越过小溪（威科夫） |
+| `sos` | SOS 强势上涨（威科夫） |
+| `sos_h1` | SOS 后出现高1入场点 |
+| `spring` | Spring 弹簧形态（威科夫） |
+| `w` | SOS 后出现 W 底吸收 |
+| `lps` | LPS 最后供应点（威科夫） |
+| `ibs` | K线实体较大（放量上涨，收盘超昨日高点） |
 
-### K线数据
-
-```bash
-# 获取K线数据
-daxiapi kline 000001
-```
+---
 
 ### 涨跌停
 
 ```bash
-# 涨停池
+# 涨停池（默认）
 daxiapi zdt
 
 # 跌停池
 daxiapi zdt --type dt
-```
-
-### 成交额
 
-```bash
-# 获取A股市场成交额数据
-daxiapi turnover
+# 炸板池
+daxiapi zdt --type zb
 ```
 
+---
+
 ### 热榜数据
 
 ```bash
-# 热股榜（默认：1小时、大家都在看）
+# 热股榜（默认：1小时维度，大家都在看）
 daxiapi hotrank stock
 
 # 热股榜 - 24小时维度
@@ -183,13 +191,13 @@ daxiapi hotrank stock --type day
 # 热股榜 - 快速飙升个股
 daxiapi hotrank stock --list-type skyrocket
 
-# 热股榜 - 趋势投资派关注个股
+# 热股榜 - 趋势投资派关注
 daxiapi hotrank stock --list-type trend
 
-# 热股榜 - 价值派关注个股
+# 热股榜 - 价值派关注
 daxiapi hotrank stock --list-type value
 
-# 热股榜 - 技术派关注个股
+# 热股榜 - 技术派关注
 daxiapi hotrank stock --list-type tech
 
 # 概念板块热榜
@@ -199,48 +207,85 @@ daxiapi hotrank concept
 daxiapi hotrank board
 ```
 
-#### 热股榜榜单类型（list-type）
+**热股榜说明**：`--type`（`hour`/`day`）仅对 `normal` 和 `skyrocket` 榜单有效；`trend`/`value`/`tech` 榜单固定使用日维度。
 
-| 榜单类型 | 说明 |
-|---------|------|
-| normal | 大家都在看（默认） |
-| skyrocket | 快速飙升个股 |
-| trend | 趋势投资派关注个股 |
-| value | 价值派关注个股 |
-| tech | 技术派关注个股 |
+---
+
+### 成交额
+
+```bash
+# 全市场成交额及较昨日变化
+daxiapi turnover
+```
+
+---
+
+### 红利指数
+
+```bash
+# 红利低波指数打分（默认）
+daxiapi dividend score
+
+# 指定指数
+daxiapi dividend score -c 2.H30269    # 红利低波
+daxiapi dividend score -c 2.930955    # 红利低波100
+daxiapi dividend score -c 1.000922    # 中证红利
+daxiapi dividend score -c 2.932365    # 中证现金流
+```
+
+---
 
 ### 财报数据
 
 ```bash
 # 获取个股财务报表数据
 daxiapi report finance 300014
-
-# 查询其他股票
 daxiapi report finance 600036
-daxiapi report finance 000001
 ```
 
+---
+
 ### 新闻数据
 
 ```bash
-# 获取个股舆情（内部自动将 code 转为 secid）
+# 个股舆情（内部自动将 code 转为 secid）
+daxiapi news sentiment -c 600031
+
+# 指定条数
 daxiapi news sentiment -c 600031 -p 20
 
-# 获取个股公告
-daxiapi news notice -c 600031 -p 20 -i 1
+# 个股公告
+daxiapi news notice -c 600031
+
+# 个股公告（翻页）
+daxiapi news notice -c 600031 -p 20 -i 2
 
-# 获取个股研报（支持时间区间）
-daxiapi news report -c 600031 -p 25 -i 1 -b 2026-01-01 -e 2026-04-08
+# 个股研报（指定时间区间）
+daxiapi news report -c 600031 -b 2026-01-01 -e 2026-04-09
 ```
 
-### 工具
+---
+
+### 工具命令
 
 ```bash
-# 代码转换
-daxiapi secid 000001
+# 搜索股票（支持名称、拼音缩写）
+daxiapi search 平安
+daxiapi search 宁德时代
+
+# 搜索板块
+daxiapi search 锂电 --type bk
+
+# 代码格式转换（转为标准 secid 格式）
+daxiapi secid 000001    # → 0.000001
+daxiapi secid 600031    # → 1.600031
+
+# K线数据
+daxiapi kline 000001
+daxiapi kline 1.600031
 ```
 
-> 💡 提示：`daxiapi` 命令也可以使用简写 `dxp`
+---
 
 ## 全局选项
 
@@ -248,14 +293,15 @@ daxiapi secid 000001
 # 查看帮助
 daxiapi --help
 daxiapi market --help
+daxiapi stock --help
 
 # 查看版本
 daxiapi --version
 ```
 
-## 错误处理
+---
 
-CLI 工具提供详细的错误提示和解决建议：
+## 错误处理
 
 ### 认证错误 (401)
 
@@ -264,12 +310,12 @@ CLI 工具提供详细的错误提示和解决建议：
 
 解决方法:
   1. 检查 Token 是否正确配置:
+     daxiapi config get token
+  2. 重新配置:
      daxiapi config set token YOUR_TOKEN
-
-  2. 或设置环境变量:
+  3. 或设置环境变量:
      export DAXIAPI_TOKEN=YOUR_TOKEN
-
-  3. Token 可在 daxiapi.com 用户中心获取
+  4. Token 可在 daxiapi.com 用户中心获取
 ```
 
 ### 限流错误 (429)
@@ -278,15 +324,14 @@ CLI 工具提供详细的错误提示和解决建议：
 ❌ 错误: 请求频率超限
 
 解决方法:
-  1. 请稍后重试
-  2. 检查您的请求频率是否过高
-  3. 升级账户获取更高配额
+  1. 等待 30-60 秒后重试
+  2. 检查请求频率是否过高
 ```
 
 ## 限流规则
 
-- 每日上限：1000次
-- 每分钟上限：10次
+- 每日上限：1000 次
+- 每分钟上限：10 次
 - 超限返回 429 错误
 
 ## License

package/commands/market.js

@@ -31,7 +31,24 @@ module.exports = function (program) {
                 process.exit(1);
             }
         });
+    marketCmd.command('compass')
+        .description('获取市场整合趋势结构、估值、情绪三层指标，用于A股市场三维结构分析系统，给出市场当前状态的综合判断与操作建议')
+        .action(async () => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
 
+                const data = await api.getCompassData(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
     marketCmd
         .command('temp')
         .description(

package/lib/api.js

@@ -1,7 +1,7 @@
 const axios = require('axios');
 const config = require('./config');
 const request = require('./request');
-const {formatThsVolumeTime, isTradingNow} = require('./utils');
+const {formatThsVolumeTime, isTradingNow, formatSecucode} = require('./utils');
 const {calculateScores} = require('./dividendUtils');
 const getFinanceReportDetail = require('./caibao');
 
@@ -107,12 +107,58 @@ async function getSecId(token, code) {
     const client = createClient(token);
     return post(client, '/get_sec_id', {code});
 }
+async function getCompassData(token, ) {
+    const client = createClient(token);
+    return get(client, '/get_market_compass');
+}
 
 async function queryStockData(token, q, type = 'stock') {
     const client = createClient(token);
     return post(client, '/query_stock_data', {q, type});
 }
 
+
+
+async function getCapitalFlow(code, days =10) {
+    if (!code || typeof code !== 'string') {
+        throw new Error('Invalid code: code must be a non-empty string');
+    }
+
+    const secucode = formatSecucode(code);
+    const response = await axios.get('https://datacenter-web.eastmoney.com/api/data/v1/get', {
+        params: {
+            callback: '',
+            reportName: 'PRT_STOCK_CAPITALFLOWS',
+            columns: 'ALL',
+            filter: `(SECUCODE="${secucode}")`,
+            pageNumber: 1,
+            pageSize: days,
+            sortTypes: -1,
+            sortColumns: 'TRADE_DATE',
+            source: 'WEB',
+            client: 'WEB'
+        }
+    });
+
+    const payload = response.data || {};
+    if (!payload.success || !payload.result || !payload.result.data) {
+        throw new Error('Failed to get capital flow data');
+    }
+
+    const data = payload.result.data;
+    return data.map(item => ({
+            date: item.TRADE_DATE,
+            当日资金流入: item.CAPITAL_FLOWS,
+            '当日资金流入占比': item.CAPITAL_FLOWS_RATIO,
+            '5日资金流入金额': item.CAPITAL_FLOWS_5DAYS,
+            '5日资金流入占比': item.CAPITAL_FLOWS_5DAYSRATIO,
+            '板块资金流入': item.BOARD_CAPITAL_FLOWS,
+            '5日板块资金流入金额': item.BOARD_CAPITAL_5FLOWS,
+            '板块代码': item.BOARD_CODE,
+            '板块名称': item.BOARD_NAME,
+        }))
+}
+
 async function getPatternStocks(token, pattern) {
     const client = createClient(token);
     return post(client, '/get_pattern_stocks', {pattern});
@@ -146,8 +192,8 @@ async function getDividendScore(token, code) {
         scores: recentScores.map(item => ({
             date: item.date,
             score: item.totalScore,
-            cs: item.cs.toFixed(2),
-            rsi: item.rsi.toFixed(2)
+            cs: item.cs != null ? item.cs.toFixed(2) : null,
+            rsi: item.rsi != null ? item.rsi.toFixed(2) : null
         }))
     };
 }
@@ -272,15 +318,13 @@ async function getTurnoverData(type = 'day') {
             if (isTrading) {
                 return {
                     是否正在盘中交易: isTrading ? '是' : '否',
-                    ...rs,
-                    minuteData
+                    ...rs
                 };
             }
             return {
                 ...formattedData,
                 是否正在盘中交易: isTrading ? '是' : '否',
-                ...rs,
-                minuteData
+                ...rs
             };
         }
 
@@ -439,8 +483,10 @@ async function getNewsReport(code, pageSize = 25, pageIndex = 1, beginTime = '20
 }
 
 module.exports = {
+    getCapitalFlow,
     getMarketData,
     getMarketTemp,
+    getCompassData,
     getMarketStyle,
     getMarketValueData,
     getBkData,

package/lib/dividendUtils.js

@@ -1,7 +1,7 @@
 const DIVIDEND_SCORE_CONSTANTS = {
     ROLLING_WINDOW: 440,
-    PERCENTILE_LOW: 5,
-    PERCENTILE_HIGH: 95,
+    PERCENTILE_LOW: 0,
+    PERCENTILE_HIGH: 100,
     SCORE_MA_PERIOD: 5,
     EMA_PERIOD: 20,
     MA_PERIOD: 80,
@@ -140,6 +140,7 @@ function calculateScores(data) {
 
     const csValues = dataCopy.map(d => d.cs);
     const ma80BiasValues = dataCopy.map(d => d.ma80Bias);
+    const rsiValues = dataCopy.map(d => d.rsi);
 
     for (let i = 0; i < dataCopy.length; i++) {
         const current = dataCopy[i];
@@ -155,6 +156,7 @@ function calculateScores(data) {
         const startIdx = Math.max(0, i - DIVIDEND_SCORE_CONSTANTS.ROLLING_WINDOW + 1);
         const csHistory = csValues.slice(startIdx, i + 1);
         const ma80History = ma80BiasValues.slice(startIdx, i + 1);
+        const rsiHistory = rsiValues.slice(startIdx, i + 1);
 
         current.csScore = calculateRollingScore(
             current.cs,
@@ -168,7 +170,12 @@ function calculateScores(data) {
             DIVIDEND_SCORE_CONSTANTS.PERCENTILE_LOW,
             DIVIDEND_SCORE_CONSTANTS.PERCENTILE_HIGH
         );
-        current.rsiScore = current.rsi;
+        current.rsiScore = calculateRollingScore(
+            current.rsi,
+            rsiHistory,
+            DIVIDEND_SCORE_CONSTANTS.PERCENTILE_LOW,
+            DIVIDEND_SCORE_CONSTANTS.PERCENTILE_HIGH
+        );
 
         if (current.csScore !== null && current.ma80Score !== null && current.rsiScore !== null) {
             current.totalScore = parseFloat(

package/lib/output.js

@@ -8,7 +8,10 @@ function output(data) {
         console.log('[60]{"日期","分数","cs值","rsi值"}:');
 
         data.scores.forEach(item => {
-            console.log(`  ${item.date},${item.score || '-'},${item.cs || '-'},${item.rsi || '-'}`);
+            const score = item.score != null ? item.score : '-';
+            const cs = item.cs != null ? item.cs : '-';
+            const rsi = item.rsi != null ? item.rsi : '-';
+            console.log(`  ${item.date},${score},${cs},${rsi}`);
         });
 
         console.log('```');

package/lib/utils.js

@@ -78,10 +78,29 @@ const formatThsVolumeTime = e => {
         dataTimestamp: h
     };
 };
+
+function formatSecucode(code) {
+    code = String(code);
+    if (code.includes('.')) {
+        const parts = code.split('.');
+        const stockCode = parts[0];
+        const suffix = parts[1].toUpperCase();
+        if (suffix === 'SH' || suffix === 'SZ') {
+            return `${stockCode}.${suffix}`;
+        }
+        return `${stockCode}.${suffix === '1' ? 'SH' : 'SZ'}`;
+    }
+    if (code[0] === '6' || code[0] === '5') {
+        return `${code}.SH`;
+    }
+    return `${code}.SZ`;
+}
+
 module.exports = {
     isWeekday,
     isTradingTime,
     isTradingNow,
     formatThsVolumeTime,
-    getSecid
+    getSecid,
+    formatSecucode
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "daxiapi-cli",
-    "version": "2.4.1",
+    "version": "2.5.0",
     "description": "大虾皮金融数据API命令行工具",
     "bin": {
         "daxiapi": "./bin/index.js",