MEXC

MEXC（现货）：MEXC（抹茶）现货交易，通过MEXC现货V3接口（api.mexc.com）接入，全部是REST轮询，没有行情和订单推送。私有接口需要API Key（Access Key、Secret Key）。只交易现货，没有模拟盘；永续合约请使用Futures_MEXC。

Futures_MEXC（期货）：MEXC（抹茶）永续合约：USDT、USDC保证金合约与币本位合约，通过MEXC合约接口（contract.mexc.com）接入，全部是REST轮询，没有行情和订单推送。私有接口需要API Key（Access Key、Secret Key）。只有永续合约，没有模拟盘。

名称与配置

exchange.GetName()	类型	别名
MEXC	现货	抹茶
Futures_MEXC	期货	抹茶期货、MEXC期货、MEXC Futures

✓ 表示该交易所对象有这个配置项。

配置项	MEXC	Futures_MEXC	必填	默认值	说明
Access Key	✓	✓	是	—	—
Secret Key	✓	✓	是	—	—
V3协议	✓		否	勾选	兼容旧配置保留的选项，连接器固定使用V3接口，勾选与否不影响。

交易对与合约代码

MEXC（现货）

交易对示例：BTC_USDT、ETH_USDC

交易对写作BASE_QUOTE，大小写不敏感，例如BTC_USDT对应MEXC的原生代码BTCUSDT。带合约后缀（如.swap）或含-的品种代码会报错。

Futures_MEXC（期货）

交易对示例：BTC_USDT、BTC_USDC、BTC_USD

交易对设置为BTC_USDT、BTC_USDC为USDT、USDC保证金合约，BTC_USD为币本位合约。

合约代码	说明
swap	永续合约（唯一的合约代码）。

MEXC合约只有永续合约，其它合约代码会报错。原生合约代码与交易对同形（BTC_USDT）。下单数量单位为张（限价单、市价单相同），每张对应的币数为exchange.GetMarkets()中的CtVal。

专属IO指令

MEXC（现货）

没有专属指令，通用指令见exchange.IO。

Futures_MEXC（期货）

指令	参数	说明	返回值
cross	bool	全仓（true，默认）/逐仓（false）。只记在交易所对象上，下单时使用，不向交易所发请求。	设置的值。

通用指令api、base、currency见exchange.IO。

函数支持差异

MEXC（现货）

不支持（调用时报错并返回空值）：exchange.ModifyOrder、exchange.CreateConditionOrder、exchange.ModifyConditionOrder、exchange.CancelConditionOrder、exchange.GetConditionOrder、exchange.GetConditionOrders、exchange.GetHistoryConditionOrders。

以回退方式支持：

• exchange.GetRecords：原生周期为1分钟、5分钟、15分钟、30分钟、1小时、4小时、1天、1周、1月；其它周期由托管者合成。

Futures_MEXC（期货）

不支持（调用时报错并返回空值）：exchange.ModifyConditionOrder。

以回退方式支持：

• exchange.GetRecords：原生周期为1分钟、5分钟、15分钟、30分钟、1小时、4小时、8小时、1天、1周、1月；其它周期由托管者合成。

保证金、账户与模拟盘

Futures_MEXC（期货）

保证金模式：用exchange.IO("cross", bool)选择全仓/逐仓，下单时随订单发送；exchange.GetPositions只返回与当前选择的保证金模式一致的持仓。

账户：exchange.SetMarginLevel()在全仓模式下向交易所修改该合约多、空两侧的杠杆；逐仓模式下只在本地记下杠杆，下单时随订单发送。逐仓下单时没有设置过杠杆，会先向交易所查询该合约当前的逐仓杠杆。杠杆按四舍五入取整后发送，取整后小于1时报错；也可以在下单附加参数中传leverage指定单张订单的杠杆。

注意事项

MEXC（现货）

• MEXC现货查询挂单的接口必须指定交易对：exchange.GetOrders()不传参数时只查询当前交易对的挂单，不是所有交易对的挂单。
• 市价买单的下单量是要花费的计价币金额（按MEXC的quoteOrderQty下单），市价卖单是交易币数量。
• 限价单指定只做Maker（postOnly）时按MEXC的LIMIT_MAKER类型下单。
• exchange.GetHistoryOrders()只能查询最近7天的订单（交易所接口的限制），since早于7天前时从7天前开始查询。

Futures_MEXC（期货）

• exchange.GetFundings不支持批量查询，需要传入具体品种代码，例如BTC_USDT.swap。
• 条件单只支持止盈、止损单，不支持OCO；不支持修改条件单；条件单不能使用自定义订单号（clientId）。条件单以最新成交价触发，有效期为24小时，到期自动失效。
• 改单（exchange.ModifyOrder()）只能修改限价单，改单后交易所会撤销原订单并挂出新订单，返回值是新订单的Id，之后的查询、撤单应使用新Id。
• 限价单支持IOC、FOK与只做Maker（postOnly）；市价单不能指定FOK或只做Maker，条件单只支持GTC。