核心功能
Phemex-trade 是一个面向 Phemex 加密货币交易所的命令行交易工具,封装了交易所 REST API,提供完整的交易生命周期管理。核心能力包括:
市场数据获取:无需认证即可查询 24 小时行情、订单簿、K 线、近期成交及资金费率历史,支持 list_symbols 工具快速发现可用交易对。
账户与仓位管理:查询合约账户余额、现货钱包、持仓盈亏、挂单与历史订单、成交记录等,数据字段自动映射为可读名称(如 closeRp → closePrice)。
交易执行:支持市价/限价/止损/限价止损四种订单类型,涵盖 USDT-M 永续、币本位永续及现货三大市场。关键特性包括:
- 智能字段映射与
--raw原始模式切换 - 分市场订单数量单位自动处理(USDT-M 按基础币数量,币本位按合约张数,现货支持按基础币或计价币下单)
- 内置止盈止损、减仓-only、持仓模式切换、杠杆调整等风控参数
资金划转:支持现货与合约账户间的资金划转及历史查询。
显著优点
1. 配置灵活:支持 ~/.phemexrc 配置文件持久化存储 API 凭证,环境变量与命令行参数优先级覆盖,便于多环境切换(主网/测试网)。
2. 错误友好:结构化错误响应包含 suggestion 与 tip 字段,对常见错误(如符号拼写错误、数量超限)提供可操作建议。
3. 安全机制:内置五项安全规则,强制要求订单确认、全撤单前展示持仓、杠杆变更风险提示,禁止自动化交易。
4. 开发体验:每个工具内置 --help 输出完整参数说明与示例,字段命名统一降低 API 认知门槛。
潜在局限
- API 密钥风险:需存储敏感凭证,配置文件或环境变量泄露可能导致资金损失
- 无内置风控:依赖用户自行设置
PHEMEX_MAX_ORDER_VALUE等外部限制 - 仅支持 Phemex:无法跨交易所使用
- 命令行门槛:非图形界面,对非技术用户存在学习成本
- 网络依赖:直接对接交易所 API,受限于交易所服务可用性与速率限制
适合人群
- 量化交易者与算法交易开发者
- 偏好命令行效率的活跃交易者
- 需要自动化行情监控与订单管理的用户
- 熟悉 Phemex 合约机制的中高级加密货币投资者
常规风险
- 资金安全风险:API 密钥泄露、误操作下单、高杠杆清算
- 操作风险:命令行参数错误导致的非意图交易
- 技术风险:CLI 工具或交易所 API 故障、网络中断
- 合规风险:需遵守当地加密货币交易法规及 Phemex 服务条款