在加密货币交易领域,抹茶交易所(Mexc)凭借其丰富的交易对和稳定的流动性,成为不少开发者和交易者的选择,若要通过程序化交易、数据分析或自动化策略接入抹茶平台,获取官方API是关键第一步,本文将详细介绍抹茶交易所API的获取流程、核心功能及使用注意事项。
API申请前的准备工作
在申请API前,需完成以下准备工作:
- 注册并完成身份认证:访问抹茶交易所官网(https://www.mexc.com/),完成注册流程,并根据要求完成实名认证(KYC),未认证用户可能无法申请API,或权限受限。
- 明确API用途:根据需求(如交易、查询、提币等)规划API权限,避免申请不必要的权限以降低安全风险。
- 准备开发环境:熟悉HTTP请求、JSON数据格式及加密签名方法(通常使用HMAC-SHA256),推荐使用Python的
requests库或JavaScript的axios库进行接口调用。
API申请步骤
- 登录账户并进入API管理页面:登录抹茶账户后,进入“账户中心”-“API管理”模块。
- 创建API密钥:点击“创建API”,填写API名称(如“交易机器人”并备注用途),选择权限范围,抹茶API权限分为三类:
- 只读权限:可查询账户余额、交易历史、市场行情等,适合数据分析工具;
- 交易权限:支持下单、取消订单、查询订单状态,需谨慎启用;
- 提币权限:允许发起提币申请,强烈建议普通用户关闭此权限,除非确有必要且已设置IP白名单。
- 设置IP白名单:为增强安全性,需限制API的访问IP地址,在创建API时,输入允许访问的IP(如开发机公网IP),未在白名单内的IP将无法调用API。
- 保存API Key和Secret:创建成功后,系统会显示API Key(公钥)和Secret(私钥)。Secret仅显示一次,务必复制并妥善保存,丢失后需重新创建,无法找回。
API调用核心流程
获取API密钥后,调用接口需遵循以下规范:
-
接口地址:抹茶API分为测试网(
https://api.mexc.com/test)和正式网(https://api.mexc.com/api/v3),测试网用于调试,正式网用于实盘交易。 -
请求参数:包含公共参数(如
timestamp时间戳、api_key)和接口特定参数,所有请求需按字母顺序排序后拼接成字符串,并通过Secret使用HMAC-SHA256加密生成签名(signature)。 -
示例代码(Python):
import requests import hmac import hashlib import time api_key = "your_api_key" secret_key = "your_secret_key" url = "https://api.mexc.com/api/v3/account" params = { "api_key": api_key, "timestamp": int(time.time() * 1000) } query_string = "&".join([f"{k}={v}" for k, v in sorted(params.items())]) signature = hmac.new(secret_key.encode(), query_string.encode(), hashlib.sha256).hexdigest() params["signature"] = signature response = requests.get(url, params=params) print(response.json())此代码用于获取账户资产信息,需确保
api_key和secret_key正确,且签名生成符合规范。
使用注意事项
- 权限最小化原则:仅开启业务必需的权限,避免滥用导致资产风险。
- IP白名单限制:生产环境中务必设置IP白名单,防止API密钥泄露被恶意调用。
- 频率限制:抹茶API对调用频率有限制(如每秒10次),避免高频请求导致接口被封禁。
