Emq 是一款专为金融数据查询与投资组合管理设计的领域专用命令行工具（CLI），通过简洁的命令结构为量化分析师、交易员和研究人员提供高效的数据访问能力。它封装了 EmQuantAPI 的核心功能，支持用户通过终端直接获取市场快照、历史时间序列数据以及执行组合操作，极大提升了高频数据交互的效率。Emq 采用模块化命令设计，涵盖认证、行情、组合、配额和原始 SDK 调用等五大核心域，每个命令均遵循统一的参数规范，确保复杂金融操作在命令行环境中仍可清晰表达。 该工具的一大亮点是其灵活多样的输出格式支持，默认以 JSON 形式返回结构化数据，同时可切换为易读的表格或 CSV 格式，适配不同场景下的数据分析需求。此外，Emq 实现了自动登录机制，用户只需首次配置用户名和密码（可通过环境变量 EMQ_USER 和 EMQ_PASS 设置），后续命令将自动使用保存的身份凭证进行鉴权，减少重复输入负担。对于需要调试或监控 API 状态的用户，emq auth status 命令还可附加远程探针检查，增强系统可靠性。 尽管 Emq 定位为轻量级 CLI 工具，但其功能覆盖全面，既适合快速查询单只股票的最新收盘价，也支持批量获取多资产的历史波动率与成交量；不仅能创建并管理投资组合，还能通过文件批量下单或交互式指令完成调仓操作。所有命令均返回统一格式的响应包，包含成功标志、错误信息、元数据和实际数据体，便于脚本自动化处理。值得注意的是，凭证以明文存储于 ~/.emq/state.json 文件中，建议仅在可信环境下使用，且日期格式严格遵循 YYYY-MM-DD 标准，避免因格式混乱导致解析失败。
核心功能特点
- 支持五大核心命令域：认证（auth）、市场行情（market）、投资组合管理（portfolio）、配额查询（quota）及原始SDK接口调用（raw）
- 提供 JSON、表格、CSV 三种输出格式，满足不同场景下数据查看与分析需求
- 内置自动登录机制，支持环境变量配置凭据，提升连续操作效率
- 支持批量订单文件导入与快速单笔下单两种组合交易模式
- 所有命令返回统一结构化响应，包含成功状态、错误详情与元数据信息
适用场景
Emq 特别适用于需要频繁调用金融数据接口但又不希望依赖图形界面或复杂编程框架的场景。例如，一位量化研究员希望在终端中快速拉取沪深300成分股的最新收盘价与换手率，仅需一条命令即可生成表格视图，无需编写 Python 脚本或启动 Jupyter Notebook。同样，日内交易者可以通过 emq portfolio qorder 指令在开盘前迅速下达限价单，结合 –date 和 –time 参数实现精确到秒的交易计划执行。 在企业级投研系统中，Emq 可作为数据采集模块嵌入自动化流程。运维人员可编写 Shell 脚本定期调用 emq market series 获取某 ETF 过去一年的分钟级 K 线数据，并以 CSV 格式导出供后续回测使用。当多个分析师共享同一账户时，管理员可通过 emq quota usage 监控 API 调用频次，防止超额消耗影响团队整体服务可用性。此外，对于偏好使用原生命令行工具而非 IDE 插件的用户而言，Emq 提供了接近本地开发体验的一致性接口，降低学习成本的同时提高了操作透明度。