核心用法
EntradeX CLI 是面向越南 DNSE 证券（DNSE Securities）的 Node.js 命令行交易终端，通过 npm 全局安装后，可实现从身份认证到真实交易的全链路操作。
认证流程：配置 API 密钥 → 发送 OTP 至注册邮箱 → 创建短期交易令牌（trading token）→ 执行交易。令牌机制为安全设计亮点，避免长期凭证暴露。
核心功能模块：
- 账户管理：查询多账户列表、资金余额、融资融券套餐
- 交易执行：支持股票（STOCK）与衍生品（DERIVATIVE）市场，涵盖 ATO/ATC/LO/MTL/MOK/PLO 六种订单类型
- 订单生命周期：下单、改单、撤单、历史查询、成交明细
- 行情数据：证券定义查询、购买力估算（PPSE）
- 调试工具：dry-run 模式可模拟下单不执行，便于策略验证
参数规范化：自动将 buy/sell 映射为 NB/NS，强制枚举值大写，对非法数量（如101股）主动拦截。
显著优点
1. 官方生态完整性：覆盖 DNSE OpenAPI 全功能，非第三方封装，数据实时性有保障
2. 安全分层设计：API 密钥与交易令牌分离，OTP 双因素认证，敏感操作需短期令牌
3. 命令语义清晰：动词-名词结构（trade order、account balances）降低学习成本
4. 前置校验机制：在本地校验订单类型与价格的匹配规则（如非限价单 price 必须为0），减少无效请求
潜在缺点与局限性
- 地域限制：仅支持越南 DNSE 证券，无法跨券商使用
- Node.js 依赖：需维护 npm 全局环境，版本冲突可能导致运行异常
- 无交互式界面：纯 CLI 体验，需记忆参数顺序，复杂策略建议配合脚本封装
- 令牌有效期：trading token 需频繁刷新，自动化场景需额外处理 OTP 流程
- 奇数股限制：101-199股等非标准手数被硬性拒绝，需用户手动拆单
适合人群
- 越南股市量化交易者与算法策略开发者
- 需批量管理多 DNSE 账户的机构投资者
- 熟悉命令行、追求低延迟直连券商的进阶个人投资者
- 不适合：寻求图形界面的新手、非 DNSE 客户、需跨市场（如美股）交易的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| **凭证泄露** | `DNSE_API_KEY`/`SECRET` 需按金融级敏感信息保管，建议配置于 `~/.entradex-cli/config.json` 并设 600 权限 |
| **非授权交易** | 本工具可执行真实资金操作，建议配合独立子账户与 IP 白名单，避免主账户密钥暴露 |
| **供应链攻击** | npm 包需验证作者为 `hieuhani`、仓库地址匹配，安装前执行 `npm pack --dry-run` 审查 |
| **市场规则误触** | 衍生品与股票的订单类型、数量规则差异大，错误参数可能导致废单或意外成交 |
| **OTP 时效中断** | 交易令牌获取依赖实时 OTP，自动化脚本需预留人工介入或备用认证通道 |