1.对参数按key排序并拼接

API认证与请求格式

抹茶API使用HMAC-SHA256签名算法进行身份认证,大部分API请求都需要在请求头中包含以下信息：

• ApiKey：您创建的API Key。
• Request-Time：请求时间戳（UTC时间，毫秒级）。
• Signature：基于API Secret、请求方法、请求路径、请求参数（如果有）和时间戳生成的签名。

签名生成步骤（以Python为例）：

1. 将所有请求参数（按参数名ASCII码从小到大排序）拼接成字符串 param_string。
2. 将请求方法（GET/POST等）、请求路径、param_string 和时间戳按特定格式拼接成待签名字符串。
3. 使用API Secret对待签名字符串进行HMAC-SHA256加密，得到签名（通常转换为十六进制小写字符串）。

示例（伪代码）：

import hmac
import hashlib
import time
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
request_method = "GET"
request_path = "/api/v3/order"
params = {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "type": "LIMIT",
    "quantity": "0.001",
    "price": "50000",
    "timestamp": int(time.time() * 1000) # 毫秒时间戳
}
sorted_params = "&".join([f"{k}={v}" for k, v in sorted(params.items())])
query_string = sorted_params
# 2. 构建待签名字符串
sign_string = f"{request_method}\n{request_path}\n{query_string}"
# 3. HMAC-SHA256签名
signature = hmac.new(secret_key.encode('utf-8'), sign_string.encode('utf-8'), hashlib.sha256).hexdigest()
# 4. 将签名添加到请求参数中
params["signature"] = signature
# 5. 发送请求（例如使用requests库）
# headers = {"X-MEXC-APIKEY": api_key}
# response = requests.get(request_path, params=params, headers=headers)

常用API接口示例

抹茶API文档详细列出了所有可用的接口及其参数、返回格式，您可以在抹茶交易所官网的API文档页面找到最新最准确的信息：https://mexcdevelop.github.io/apidocs/spot_v3_en/ (请注意替换为最新的官方文档链接)

以下是一些常用接口的简要说明和示例（请以官方文档为准）：

1. 获取服务器时间

   • 接口：GET /api/v3/time
   • 作用：获取服务器时间，用于同步本地时间,确保请求时间戳准确。
   • 示例请求：https://api.mexc.com/api/v3/time

2. 获取账户信息

   • 接口：GET /api/v3/account
   • 权限：读取权限
   • 作用：获取账户的资产信息。
   • 示例请求（需带认证）：https://api.mexc.com/api/v3/account?timestamp=1678886400000&signature=YOUR_SIGNATURE
   • 请求头：X-MEXC-APIKEY: YOUR_API_KEY

3. 下单

   • 接口：POST /api/v3/order
   • 权限：交易权限
   • 参数：symbol (交易对), side (BUY/SELL), type (LIMIT/MARKET等), quantity (数量), price (价格，限价单需要), timestamp (时间戳), signature (签名) 等。
   • 作用：创建一个新的订单。
   • 示例请求（需带认证）：POST https://api.mexc.com/api/v3/order?symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=0.001&price=50000&timestamp=1678886400000&signature=YOUR_SIGNATURE

4. 查询订单状态

   • 接口：GET /api/v3/order
   • 权限：读取权限
   • 参数：symbol (交易对), orderId (订单ID) 或 origClientOrderId (客户端订单ID), timestamp, signature。
   • 作用：查询某个订单的详细信息。

5. 获取K线数据

   • 接口：GET /api/v3/klines
   • 权限：无需认证（公共接口）
   • 参数：symbol (交易对), interval (K线周期，如1m, 5m, 1h, 1d等), limit (数量，默认500，最大1000), startTime, endTime。
   • 作用：获取指定交易对的K线数据。
   • 示例请求：https://api.mexc.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=100

使用API的注意事项

1. 安全第一：

   • 切勿泄露Secret：Secret是您账户安全的核心，一旦泄露,立即在API管理页面禁用该密钥。
   • 谨慎开启提现权限：除非必要,否则不要开启。
   • 使用IP白名单：限制API密钥的访问来源IP。
   • 定期轮换API密钥：定期更换API密钥,降低密钥泄露后的风险。

2. 请求频率限制：抹茶API有请求频率限制（Rate Limit），具体限制请参考官方文档，超频限制可能会导致您的请求被暂时拒绝，甚至API密钥被临时冻结,合理规划请求频率。

3. 错误处理：API调用可能会返回各种错误码（如参数