核心用法
EntradeX CLI 是一款面向 DNSE(越南领先券商)EntradeX 交易平台的命令行工具,基于 Node.js 开发,通过 npm 分发。用户需配置 API 密钥(DNSE_API_KEY、DNSE_API_SECRET)或本地配置文件(~/.entradex-cli/config.json)完成鉴权,支持 OTP 双因素认证生成临时交易令牌(tradingToken)。
主要功能模块包括:
- 账户管理:查询账户列表、资产余额、融资融券套餐
- 交易执行:支持 HOSE/HNX/UPCOM 三大市场的限价单(LO)、市价单(MP)、IOC 等多种订单类型,可下单、改单、撤单
- 订单管理:实时查询委托状态、历史成交、成交明细
- 行情数据:获取证券代码定义(SecDef)、购买力计算(PPSE)等
- 模拟测试:内置
dry-run模式,支持零风险验证策略逻辑
显著优点
1. 官方生态兼容:直接对接 DNSE 官方 OpenAPI,数据延迟低、可靠性高
2. CLI 原生体验:无需 GUI,适合服务器部署与 CI/CD 集成
3. 灵活配置:支持环境变量、配置文件、命令行参数三级优先级,便于多环境切换
4. 安全设计:强制 OTP 交易令牌机制,降低密钥泄露后的资金风险
5. 开源可审计:MIT 协议,源码托管于 GitHub,社区可审查
潜在缺点与局限性
- 地域限制:仅支持越南三大交易所(HOSE/HNX/UPCOM),无法覆盖 A 股、美股等市场
- Node 依赖:需本地 Node.js 环境,对非技术用户有一定门槛
- API 权限依赖:实际功能受 DNSE 账户权限限制(如融资融券需开通相应服务)
- 社区规模有限:GitHub Stars 较少,长期维护依赖作者个人投入
适合人群
- 越南市场量化交易者与算法策略开发者
- 需要自动化交易脚本的 DNSE 存量用户
- 熟悉 Node.js/CLI 环境的技术型投资者
常规风险
- 资金风险:配置生产密钥后可直接下单,误操作或代码 Bug 可能导致真实亏损
- 密钥泄露:
config.json或环境变量若未妥善保管,存在被盗用风险 - 网络与 API 稳定性:依赖 DNSE 服务端可用性,极端行情下可能出现延迟或限流
- 合规风险:高频或自动化交易需遵守越南证券法规及 DNSE 用户协议