核心用法
EntradeX CLI 是专为 DNSE(越南证券经纪商)设计的命令行交易工具,提供完整的程序化交易能力:
配置管理:支持三级凭证优先级(配置文件 > 环境变量 > 命令行参数),通过 entradex config 命令安全存储 API 密钥。
交易执行:覆盖股票(STOCK)与衍生品(DERIVATIVE)两大市场,支持 6 种订单类型(ATO/ATC/LO/MTL/MOK/PLO)。买卖指令通过 NB/NS 标识,需配合 tradingToken 完成风控验证。
账户与风控:提供余额查询、借贷包管理、订单历史追踪、成交明细等功能。内置 dry-run 模式支持模拟下单,避免误操作。
安全认证:采用 OTP + 交易令牌双因素机制,auth 子命令完成登录态生命周期管理。
显著优点
- 越南本土市场深度适配:精准对接 DNSE 业务规则,如股票市场的整手(100股倍数)与零股(1-99股)分离约束
- 防御性设计:dry-run 预演、参数校验(价格/数量/订单类型组合合法性检查)、凭证分级存储
- 完整工作流闭环:从配置 → 认证 → 下单 → 查询 → 撤改单的全链路支持
潜在局限
- 地域限定:仅支持 DNSE 单一家券商,无法跨平台使用
- CLI 门槛:需熟悉命令行操作与越南股市术语(如 ATO/ATC 等竞价时段专有序型)
- 依赖外部认证:每次交易需人工介入获取 OTP,难以实现完全自动化
- npm 供应链风险:作者为个人开发者(hieuhani),需自行审计包完整性
适合人群
- DNSE 存量客户中的技术型交易者
- 需要批量下单或策略化执行的越南股市投资者
- 具备 Node.js/npm 生态经验的开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| **资金风险** | CLI 直接操作真实资金账户,误参数可能导致即时成交 |
| **密钥泄露** | `DNSE_API_KEY/SECRET` 需按敏感凭证管理,避免提交至代码仓库 |
| **供应链攻击** | npm 包可能被篡改,安装前需验证作者身份与仓库哈希 |
| **市场规则变更** | DNSE API 升级可能导致 CLI 行为异常,需关注版本更新 |