跳到主要内容

终端使用

命令结构​

命令由三段组成：类别、模块、动作。

mexc  spot  marketv2  ticker --symbol BTC_USDT
#     类别   模块      动作

功能查询​

mexc explore 打开交互界面，方向键浏览全部 307 个功能，每项附带说明；按 y 复制命令写法，q 退出。首次使用建议先执行该命令。

mexc explore                       # 交互式浏览
mexc spot marketv2 ticker --help   # 单条命令的参数
mexc schema spot.trade.place       # 参数、请求体字段、读写属性

常用命令​

合约公开行情无需密钥，contract market 下 37 个功能均可直接调用：

mexc contract market ticker --symbol BTC_USDT                # 行情
mexc contract market depth --symbol BTC_USDT                 # 盘口深度
mexc contract market kline --symbol BTC_USDT                 # K 线，无需密钥
mexc contract market funding-rate --contractName BTC_USDT    # 资金费率

实时推送同样无需密钥。不指定 --limit 或 --listen-duration 时持续接收，Ctrl+C 停止：

mexc spot marketv2 ws-trades --symbol BTCUSDT --limit 1               # 收到一条即退出
mexc futures market ws-ticker --symbol BTC_USDT --listen-duration 10s # 监听十秒

现货行情多数无需密钥。spot marketv2 下只有 symbols、tickers、symbol-trade、user-eftd-info 需要密钥，它们的返回结果与账户相关（按地区、IP 和账户过滤隐藏交易对）；其余 18 个查询和 3 个实时推送都是公开的。

mexc spot marketv2 ticker --symbol BTC_USDT   # 实时价，无需密钥
mexc spot marketv2 coin-new-list              # 新上线币种，无需密钥
mexc spot marketv2 depth --symbolId <编号>     # 盘口深度，无需密钥
mexc spot marketv2 tickers                    # 全部行情，需要密钥
mexc spot marketv2 symbols                    # 交易对列表及编号，需要密钥

账户与资产：

mexc spot asset overview                      # 各账户总览
mexc spot asset assets-spot                   # 现货余额
mexc contract account assets                  # 合约余额
mexc spot asset assets-financial              # 理财资产
mexc spot asset deposit-history               # 充值记录
mexc spot asset transfer-internal-history     # 划转记录
mexc spot asset pnl-overview                  # 盈亏

现货交易：

mexc spot trade current-orders                # 当前挂单
mexc spot trade history-orders                # 历史订单
mexc spot trade deals                         # 成交明细
mexc spot trade place --data ...              # 限价下单
mexc spot trade place-market --data ...       # 市价下单
mexc spot trade cancel --data ...             # 撤单

理财与活动：

mexc financial-openapi common member-positions    # 理财持仓
mexc financial-openapi common member-assets-v2    # 理财资产
mexc activity online list --data '{"limit":10}'   # 在线活动
mexc activity reward summary                      # 我的奖励

参数命名不统一。多数功能使用 --symbol；合约资金费率使用 --contractName；现货 K 线，无需密钥与盘口深度使用 --symbolId，即内部编号，通过 mexc spot marketv2 symbols 查询。交易对有两种写法：普通查询为 BTC_USDT，实时推送为 BTCUSDT。以 --help 输出为准。

全局开关​

mexc <命令> --read-only    # 拒绝执行任何改变状态的操作
mexc <命令> --dry-run      # 打印将要发出的请求，不实际发送
mexc <命令> --yes          # 声明该操作已确认，跳过确认提示

下单前先以 --dry-run 执行一次，可在请求发出前发现参数错误。--read-only 与 --yes 涉及资金安全，参见 安全 中的 --yes 与 --read-only。