EntradeX CLI

安装

npm i -g entradex-cli

使用方法

entradex [全局选项] [命令]

配置

凭证优先级顺序：

1. 配置文件（~/.entradex-cli/config.json）——推荐方式
2. 环境变量（DNSE_API_KEY、DNSE_API_SECRET）
3. 全局命令选项（--api-key、--api-secret）

配置与检查配置：

entradex config set --key "" --secret ""
entradex config set
entradex config get
entradex config clear

安全与风险提示

使用本功能前，请务必：

• 验证 npm 包：npm view entradex-cli —— 确认作者为 hieuhani，且仓库地址匹配
• 检查包内容：npm pack entradex-cli --dry-run 或在 npmjs.com 上浏览源码
• 将 DNSE_API_KEY 和 DNSE_API_SECRET 视为高度敏感的交易凭证，严格保密

自主执行警告：

• 本功能可使用提供的凭证发起真实交易
• 建议使用权限受限的独立账户进行操作
• 如怀疑存在未授权访问，请立即轮换 API 密钥

全局选项

• --api-key DNSE API 密钥
• --api-secret DNSE API 密钥密文
• --base-url API 基础 URL（默认值：https://openapi.dnse.com.vn）
• --debug 显示请求详细信息
• -V, --version 显示 CLI 版本
• -h, --help 显示帮助信息

命令

Config（配置）

entradex config set [--key ] [--secret ] [--url ]
entradex config get
entradex config clear

Account（账户）

entradex account list
entradex account balances 
entradex account loan-packages   [--symbol ]

Trade（交易）

entradex trade order        [--price-stop ]
entradex trade modify          [--price-stop ]
entradex trade cancel    

参数说明：

• marketType（枚举值）：STOCK、DERIVATIVE
• side（枚举值）：NB（买入）、NS（卖出）
• orderType（枚举值）：ATO、ATC、LO、MTL、MOK、PLO
  • ATO：集合竞价开盘价委托
  • ATC：集合竞价收盘价委托
  • LO：限价委托
  • MTL：市价转限价委托
  • MOK：市价委托（立即成交否则取消）
  • PLO：盘后限价委托
• price（数值型）：单价；须符合 DNSE 的最小变动单位（tick size）及市场规则
  • 若 orderType=LO，则 price 必须大于 0。
  • 若 orderType 为其他类型（ATO、ATC、MTL、MOK、PLO），则 price 必须严格等于 0。
• quantity（整数型）：委托数量；须满足市场最小交易单位（lot）要求
  • 对于 marketType=STOCK，有效数量为以下两类之一：
    • 整手：100 的整数倍（如 100、200 …）
    • 零股：1 至 99 的整数
  • 对于 marketType=STOCK，类似 101、102 等非标准零股数量无效，必须拒绝。
• tradingToken（字符串）：由 entradex auth create-token 生成的令牌

用户意图标准化规则：

• 若用户输入 buy/sell，自动映射为 NB/NS。
• 执行前统一将枚举类参数（marketType、side、orderType）转为大写。
• 若用户提供不支持的枚举值，中止执行并提示用户输入合法值。
• 若指定的 orderType 不被目标市场或当前交易时段所支持，中止执行并提示用户选择支持的类型。

Order（订单）

entradex order list  
entradex order detail   
entradex order history   [--from ] [--to ] [--page-size ] [--page-index ]
entradex order deals  

Market（市场）

entradex market secdef  [--board-id ]
entradex market ppse     

Auth（认证）

entradex auth send-otp  [--otp-type ]
entradex auth create-token  

Dry Run（试运行）

entradex dry-run accounts
entradex dry-run balances 
entradex dry-run order       [--price-stop ]

典型工作流程

# 1) 配置凭证
entradex config set

# 2) 发送 OTP
entradex auth send-otp user@example.com

# 3) 使用验证码创建交易令牌
entradex auth create-token smart_otp 

# 4) 下单
entradex trade order STOCK VIC NB LO 15000 100