daxiapi-cli 2.2.0 → 2.3.0

package/README.md

@@ -164,6 +164,62 @@ daxiapi zdt
 daxiapi zdt --type dt
 ```
 
+### 成交额
+
+```bash
+# 获取A股市场成交额数据
+daxiapi turnover
+```
+
+### 热榜数据
+
+```bash
+# 热股榜（默认：1小时、大家都在看）
+daxiapi hotrank stock
+
+# 热股榜 - 24小时维度
+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
+
+# 概念板块热榜
+daxiapi hotrank concept
+
+# 行业板块热榜
+daxiapi hotrank board
+```
+
+#### 热股榜榜单类型（list-type）
+
+| 榜单类型 | 说明 |
+|---------|------|
+| normal | 大家都在看（默认） |
+| skyrocket | 快速飙升个股 |
+| trend | 趋势投资派关注个股 |
+| value | 价值派关注个股 |
+| tech | 技术派关注个股 |
+
+### 财报数据
+
+```bash
+# 获取个股财务报表数据
+daxiapi report finance 300014
+
+# 查询其他股票
+daxiapi report finance 600036
+daxiapi report finance 000001
+```
+
 ### 工具
 
 ```bash

package/bin/index.js

@@ -18,5 +18,8 @@ require('../commands/zdt')(program);
 require('../commands/secid')(program);
 require('../commands/search')(program);
 require('../commands/dividend')(program);
+require('../commands/hotrank')(program);
+require('../commands/turnover')(program);
+require('../commands/report')(program);
 
 program.parse(process.argv);

package/commands/config.js

@@ -1,8 +1,8 @@
 const config = require('../lib/config');
-const { handleError, createParameterError } = require('../lib/error');
+const {handleError, createParameterError} = require('../lib/error');
 
-module.exports = function(program) {
-    const configCmd = program.command('config');
+module.exports = function (program) {
+    const configCmd = program.command('config').description('配置管理，添加daxiapi.com接口api_token');
 
     configCmd
         .command('set <key> <value>')
@@ -12,14 +12,8 @@ module.exports = function(program) {
                 if (!key || !value) {
                     throw createParameterError(
                         '参数无效',
-                        [
-                            "参数 'key' 不能为空",
-                            "参数 'value' 不能为空"
-                        ],
-                        [
-                            'daxiapi config set token YOUR_TOKEN',
-                            'daxiapi config set baseUrl https://daxiapi.com'
-                        ]
+                        ["参数 'key' 不能为空", "参数 'value' 不能为空"],
+                        ['daxiapi config set token YOUR_TOKEN', 'daxiapi config set baseUrl https://daxiapi.com']
                     );
                 }
 
@@ -47,14 +41,10 @@ module.exports = function(program) {
     configCmd
         .command('delete <key>')
         .description('删除配置项')
-        .action((key) => {
+        .action(key => {
             try {
                 if (!key) {
-                    throw createParameterError(
-                        '参数无效',
-                        ["参数 'key' 不能为空"],
-                        ['daxiapi config delete token']
-                    );
+                    throw createParameterError('参数无效', ["参数 'key' 不能为空"], ['daxiapi config delete token']);
                 }
 
                 config.delete(key);

package/commands/dividend.js

@@ -4,7 +4,9 @@ const {handleError} = require('../lib/error');
 const {output} = require('../lib/output');
 
 module.exports = function (program) {
-    const dividendCmd = program.command('dividend');
+    const dividendCmd = program
+        .command('dividend')
+        .description('获取红利类指数打分数据，用于判断红利指数超买超卖状态与投资机会。');
 
     dividendCmd
         .command('score')

package/commands/hotrank.js

@@ -0,0 +1,63 @@
+const api = require('../lib/api');
+const {handleError} = require('../lib/error');
+const {output, encode} = require('../lib/output');
+
+module.exports = function (program) {
+    const hotrankCmd = program
+        .command('hotrank')
+        .description('获取A股热股榜、概念板块热榜、行业板块热榜数据，用于发现市场热点与资金流向。');
+
+    hotrankCmd
+        .command('stock')
+        .description('获取A股热股榜数据，支持不同时间维度和榜单类型。可用于发现市场热点、跟踪资金流向、识别强势个股。')
+        .option(
+            '-t, --type <type>',
+            '时间类型：hour(1小时) 或 day(24小时)，仅对 normal 和 skyrocket 榜单有效，默认为 hour',
+            'hour'
+        )
+        .option(
+            '-l, --list-type <listType>',
+            '榜单类型：normal(默认，大家都在看)、skyrocket(快速飙升个股)、trend(趋势投资派关注个股)、value(价值派关注个股)、tech(技术派关注个股)',
+            'normal'
+        )
+        .action(async options => {
+            try {
+                const data = await api.getStockRank(options.type, options.listType);
+                console.log('```toon\n' + encode(data) + '\n```');
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    hotrankCmd
+        .command('concept')
+        .description(
+            '获取A股概念板块热榜数据，展示当前市场热门概念板块排名。可用于把握市场热点、识别题材轮动、辅助主题投资决策。'
+        )
+        .action(async () => {
+            try {
+                const data = await api.getPlateRank('concept');
+                console.log('```toon\n' + encode(data) + '\n```');
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    hotrankCmd
+        .command('board')
+        .description(
+            '获取A股行业板块热榜数据，展示当前市场热门行业板块排名。可用于分析行业轮动、把握板块机会、辅助行业配置决策。'
+        )
+        .option('-t, --type <type>', '板块类型：industry(行业) 或其他类型', 'industry')
+        .action(async options => {
+            try {
+                const data = await api.getPlateRank(options.type);
+                console.log('```toon\n' + encode(data) + '\n```');
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/market.js

@@ -4,7 +4,11 @@ const {handleError} = require('../lib/error');
 const {output} = require('../lib/output');
 
 module.exports = function (program) {
-    const marketCmd = program.command('market');
+    const marketCmd = program
+        .command('market')
+        .description(
+            '获取A股市场全景数据，涵盖指数行情、市场温度、风格轮动、估值水平等多维度分析，用于市场整体研判与投资决策辅助。'
+        );
 
     marketCmd
         .command('index')
@@ -93,6 +97,4 @@ module.exports = function (program) {
                 process.exit(1);
             }
         });
-
-
 };

package/commands/report.js

@@ -0,0 +1,32 @@
+const api = require('../lib/api');
+const {handleError, createParameterError} = require('../lib/error');
+const {encode} = require('../lib/output');
+
+module.exports = function (program) {
+    const reportCmd = program
+        .command('report')
+        .description('获取A股个股财报数据，包括主要财务指标、盈利能力、偿债能力等，用于基本面分析。');
+
+    reportCmd
+        .command('finance <code>')
+        .description(
+            '获取指定股票的财务报表数据，包括报告期、营业收入、净利润、每股收益、净资产收益率等核心财务指标。数据来源于同花顺，可用于个股基本面分析和财务健康评估。'
+        )
+        .action(async code => {
+            try {
+                if (!code) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'code' 不能为空"],
+                        ['daxiapi report finance 300014', 'daxiapi report finance 600036']
+                    );
+                }
+
+                const data = await api.getFinanceReportDetail(code);
+                console.log('```toon\n' + encode(data) + '\n```');
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/sector.js

@@ -4,7 +4,11 @@ const {handleError, createParameterError} = require('../lib/error');
 const {output} = require('../lib/output');
 
 module.exports = function (program) {
-    const sectorCmd = program.command('sector');
+    const sectorCmd = program
+        .command('sector')
+        .description(
+            '获取A股板块热力图、行业板块、概念板块、板块内个股排名等多维度板块数据，用于板块轮动分析与热点追踪。'
+        );
 
     sectorCmd
         .command('heatmap')

package/commands/stock.js

@@ -34,7 +34,9 @@ const SUPPORTED_PATTERNS = [
 ];
 
 module.exports = function (program) {
-    const stockCmd = program.command('stock');
+    const stockCmd = program
+        .command('stock')
+        .description('获取A股个股详情、概念股成分、技术形态选股等多维度股票数据，用于个股分析与量化筛选。');
 
     stockCmd
         .command('info')
@@ -71,7 +73,7 @@ module.exports = function (program) {
     stockCmd
         .command('gn <gnId>')
         .description(
-            '根据概念板块ID获取该概念下的所有股票数据，支持同花顺(881155)和东方财富(BK0428)两种格式的板块ID。' +
+            '根据概念板块ID获取该概念下的所有股票数据，支持同花顺(8开头code)和东方财富(BK开头)两种格式的板块ID。' +
                 '自动根据ID格式选择数据源，返回股票名称、代码、涨跌幅、CS强度、SCTR排名等详细信息，最多返回300只股票。' +
                 '可用于概念板块成分股分析和板块内股票筛选。'
         )

package/commands/turnover.js

@@ -0,0 +1,18 @@
+const api = require('../lib/api');
+const {handleError} = require('../lib/error');
+const {encode} = require('../lib/output');
+
+module.exports = function (program) {
+    const turnoverCmd = program
+        .command('turnover')
+        .description('获取A股市场成交额数据，对比当日与上一交易日成交额变化。')
+        .action(async () => {
+            try {
+                const data = await api.getTurnoverData();
+                console.log('```toon\n' + encode(data) + '\n```');
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};