MEXC API接口详解：从入门到实战应用指南

日期：2025-02-24 栏目：编程浏览：56

MEXC API 接口使用详解：从入门到实战

在加密货币交易领域，API (应用程序编程接口) 扮演着至关重要的角色。对于量化交易者、开发者和机构用户而言，MEXC API 提供了一种高效、可靠的方式来自动化交易策略、获取市场数据以及管理账户。本文将深入探讨 MEXC API 的使用方法、注意事项以及实战应用，帮助读者更好地利用该工具。

一、MEXC API 概览

MEXC API 是一套全面的程序化接口，允许开发者和交易者通过代码与 MEXC 全球交易所进行无缝交互。它极大地扩展了交易的可能性，为自动化交易策略、市场数据分析和账户管理提供了强大的工具。MEXC API 提供了广泛的功能，旨在满足不同类型用户的需求，从个人交易者到机构投资者。

市场数据： 通过 API 可以访问 MEXC 交易所的各种实时和历史市场数据。这包括但不限于：
- 实时行情： 获取最新的交易价格、涨跌幅、成交量等信息，帮助用户快速掌握市场动态。
- 历史交易数据： 下载历史交易记录，用于分析市场趋势、回测交易策略和进行量化研究。数据粒度通常支持分钟级、小时级、日级等多种时间周期。
- 深度数据： 访问订单簿的深度信息，包括买单和卖单的价格和数量，帮助用户了解市场的买卖力量分布，优化下单策略。通常提供不同深度的订单簿快照，例如 top 5, top 10, top 20 等。
- 指数数据： 部分API可能提供相关的指数数据，例如主流币种的指数、特定行业的指数等，用于宏观市场分析。
交易功能： API 提供了一整套交易相关的接口，允许用户执行各种交易操作：
- 下单： 支持市价单、限价单、止损单等多种订单类型，满足不同的交易需求。用户可以指定交易对、数量、价格等参数，并通过 API 发送订单到交易所。
- 撤单： 允许用户取消尚未成交的订单。用户需要提供订单 ID 等信息来指定要取消的订单。
- 查询订单状态： 可以查询订单的当前状态，例如是否已成交、部分成交、已取消等。这有助于用户监控订单的执行情况。
- 获取交易历史： 查询用户的历史交易记录，包括成交时间、成交价格、成交数量等信息。这有助于用户进行交易复盘和风险管理。
- 仓位管理： 部分API支持查询当前仓位信息，例如持仓数量、平均持仓成本、盈亏等，方便用户进行仓位调整。
账户管理： 通过 API 可以方便地管理 MEXC 账户：
- 查询账户余额： 获取账户中各种币种的可用余额、冻结余额等信息，方便用户了解资金状况。
- 资金划转： 实现不同账户之间的资金转移，例如从现货账户划转到合约账户。
- 获取账户信息： 查询账户的 KYC 认证状态、交易权限等信息。
- API Key管理： 允许用户创建、修改和删除 API Key，并可以为不同的 API Key 设置不同的权限，提高账户的安全性。

MEXC API 提供了两种主要的访问方式：REST API 和 WebSocket API。这两种方式各有特点，适用于不同的应用场景。

REST API： 采用请求-响应模式，客户端发送 HTTP 请求到服务器，服务器返回相应的数据。REST API 的特点是简单易用，适用于请求频率较低的场景。例如，用户可以使用 REST API 查询账户余额、下单、撤单等。由于每次请求都需要建立连接，因此不适合需要实时数据的场景。

WebSocket API： 采用双向通信模式，客户端和服务器之间建立持久连接，服务器可以主动向客户端推送数据。WebSocket API 的特点是实时性高，适用于需要实时数据的场景。例如，用户可以使用 WebSocket API 订阅实时行情、深度数据等。相比 REST API，WebSocket API 的设置和维护相对复杂一些，但可以显著降低延迟，提高数据传输效率。

二、API 密钥的获取与配置

在使用 MEXC API 之前，必须先获取有效的 API 密钥。API 密钥是您访问 MEXC 交易平台 API 的凭证，用于验证您的身份和授权您执行特定的操作。以下是详细的获取和配置步骤：

登录 MEXC 账户： 使用您的用户名和密码，通过官方网站 MEXC 官网安全地登录您的账户。确保您访问的是官方网站，谨防钓鱼网站。
进入 API 管理页面： 成功登录后，导航至用户中心。通常，您可以在账户设置、安全中心或类似的菜单中找到“API 管理”、“API 密钥”或类似的选项。点击进入 API 管理页面。
创建 API 密钥： 在 API 管理页面，点击“创建 API 密钥”、“生成 API 密钥”或类似的按钮。系统会要求您设置密钥的名称和权限。密钥名称仅用于您自己识别不同的 API 密钥用途，例如“量化交易策略A”或“数据分析”。设置权限时，请仔细阅读并理解每个权限的含义。
保存 API 密钥： 成功创建 API 密钥后，系统会生成两个重要的字符串：API Key (公钥) 和 Secret Key (私钥)。API Key 用于标识您的身份，而 Secret Key 用于加密和验证您的请求。务必将这两个密钥保存在安全的地方。强烈建议使用密码管理器来存储 Secret Key，并避免以明文形式保存在代码或配置文件中。请注意，Secret Key 只会显示一次，如果丢失，您需要重新生成 API 密钥。

在创建 API 密钥时，配置合适的权限至关重要。MEXC API 提供了多种权限，以满足不同的使用场景：

读取权限 (Read)： 允许您的程序访问市场数据，例如实时价格、历史交易记录、订单簿深度等。读取权限还允许您查询账户余额、持仓情况、交易历史等信息。拥有读取权限的 API 密钥无法进行任何交易操作。
交易权限 (Trade)： 允许您的程序执行下单、撤单、修改订单等交易操作。如果您需要使用 API 进行自动交易，则必须授予此权限。请谨慎授予交易权限，并确保您的交易策略经过充分的测试和验证，以避免意外损失。
提现权限 (Withdraw)： 允许您的程序从您的 MEXC 账户中提取资产。 强烈不建议授予此权限，除非您完全信任您的程序并且明确需要自动提现功能。 即使您需要自动提现功能，也应尽量限制提现的金额和频率，并采取额外的安全措施，例如IP白名单、提现地址白名单等。提现权限具有极高的风险，一旦泄露，可能导致您的资产被盗。

在配置 API 密钥时，务必根据您的实际需求选择最合适的权限组合。遵循最小权限原则，即只授予必要的权限，可以显著降低潜在的安全风险。例如，如果您只需要获取市场数据，则只需授予读取权限即可。如果您需要进行自动交易，则需要同时授予读取和交易权限。请定期审查您的 API 密钥权限，并根据您的需求进行调整。同时，启用MEXC提供的双因素认证（2FA）可以进一步增强账户的安全性。

三、REST API 使用指南

MEXC REST API 遵循标准的 HTTP 协议设计，允许开发者通过任何支持 HTTP 请求的编程语言与其进行交互。这意味着您可以使用如 Python、Java、JavaScript 等多种语言来构建与 MEXC 交易平台的应用程序。以下是一些常用且重要的 API 端点，以及它们的功能描述：

获取服务器时间： GET /api/v3/time - 此端点用于同步您的应用程序与 MEXC 服务器的时间。这对于确保订单和其他时间敏感的操作的准确性至关重要。返回的是服务器当前的时间戳。
获取交易对信息： GET /api/v3/exchangeInfo - 此端点提供关于所有可用交易对的详细信息，包括交易对的符号、状态、允许的订单类型、价格精度（tick size）和数量精度（lot size）等。它是构建交易策略和用户界面的重要数据来源。
获取市场行情： GET /api/v3/ticker/24hr - 此端点返回指定交易对过去 24 小时的市场行情数据，包括开盘价、最高价、最低价、收盘价、交易量和成交额。可以通过参数指定特定的交易对，也可以获取所有交易对的数据。
下单： POST /api/v3/order - 此端点用于创建新的订单。您需要提供必要的参数，如交易对、订单类型（市价单、限价单等）、买卖方向（买入或卖出）和数量。身份验证是必需的，通常通过 API 密钥和签名来实现。
撤单： DELETE /api/v3/order - 此端点用于取消尚未成交的订单。您需要提供要取消的订单的 ID。与下单一样，身份验证也是必需的。
查询订单： GET /api/v3/order - 此端点用于检索特定订单的详细信息，包括订单状态、成交数量和平均成交价格。您需要提供订单 ID 作为参数。
查询账户信息： GET /api/v3/account - 此端点提供关于您的 MEXC 账户的详细信息，包括可用余额、冻结余额和交易权限。通常需要 API 密钥和签名进行身份验证。

示例：使用 Python 调用 MEXC REST API 获取账户余额

通过 Python 编程语言，可以便捷地与 MEXC 交易所的 REST API 进行交互，获取包括账户余额在内的各种市场数据和用户数据。以下代码展示了如何利用 requests 库发送 HTTP 请求，并结合 hmac 、 hashlib 等库进行签名认证，从而安全地获取账户余额信息。

import requests

import hmac

import hashlib

import time

import urllib.parse

上述代码片段引入了必要的 Python 模块。 requests 库用于发送 HTTP 请求， hmac 和 hashlib 库用于生成 API 请求所需的签名， time 库用于获取时间戳， urllib.parse 库则用于 URL 编码，确保请求参数的正确传递。在实际应用中，请务必替换示例代码中的占位符，如 API 密钥和 Secret 密钥，为你自己的真实凭据。正确配置认证信息是成功调用 API 的关键步骤，否则将无法通过身份验证，导致请求失败。

API Key 和 Secret Key

在加密货币交易和数据访问中，API Key (应用程序编程接口密钥) 和 Secret Key (秘密密钥) 是至关重要的身份验证凭证。它们类似于用户名和密码，但专为程序化访问而设计，允许你的应用程序安全地与交易所或其他加密货币服务提供商的服务器进行通信。API Key 用于标识你的账户，而 Secret Key 则用于验证请求的真实性，防止未经授权的访问。

安全地管理这些密钥至关重要。切勿将它们存储在公共代码库中，例如 GitHub。建议使用环境变量、配置文件或专门的密钥管理系统来存储和访问这些敏感信息。定期轮换 API Key 和 Secret Key 也是一个好的安全实践，可以减少密钥泄露造成的潜在损害。

示例代码：

api_key = "YOUR_API_KEY"

secret_key = "YOUR_SECRET_KEY"

请务必将 YOUR_API_KEY 和 YOUR_SECRET_KEY 替换为你从加密货币交易所或服务提供商处获得的实际密钥。

API 端点

与 MEXC 交易所进行交互通常涉及使用其应用程序编程接口 (API)。API 允许开发者通过代码访问交易所的数据和功能，例如获取账户信息、交易对价格、下单等。要成功调用 API，你需要了解 API 的基本结构和端点。

base_url = "https://api.mexc.com" 是 MEXC API 的根 URL，所有 API 请求都以此为基础发起。这个基础 URL 指向 MEXC 服务器的入口点，负责处理所有 API 请求。

endpoint = "/api/v3/account" 是一个具体的 API 端点，它指定了你想要访问的特定资源或功能。在这个例子中， /api/v3/account 端点用于获取用户的账户信息。 /api/v3 表明这是 API 的第三个版本，版本号可能会随着 API 的更新而变化。使用正确的版本号至关重要，因为不同版本可能具有不同的请求格式和响应结构。

因此，要获取账户信息，你需要将 base_url 和 endpoint 组合起来，构成完整的 API 请求 URL，即 https://api.mexc.com/api/v3/account 。然后，你可以使用 HTTP 客户端（例如 curl 、 Python requests 等）向该 URL 发送请求，并附带必要的参数和认证信息（例如 API 密钥）。

不同的 API 端点对应不同的功能，例如获取市场行情、下单、查询订单状态等。你需要查阅 MEXC 的官方 API 文档，了解每个端点的具体用途、请求参数、响应格式和认证要求。正确的 API 文档是成功使用 API 的关键。

构建请求参数

在与加密货币交易所或相关服务进行API交互时，构建正确的请求参数至关重要。时间戳 (timestamp) 是一个常见的参数，用于验证请求的时效性，防止重放攻击。

timestamp = int(time.time() * 1000) 这行代码的作用是生成一个精确到毫秒级别的时间戳。 time.time() 函数返回自 Unix 纪元（1970 年 1 月 1 日 00:00:00 UTC）以来的秒数，乘以 1000 将其转换为毫秒，然后使用 int() 函数将结果转换为整数。

生成的毫秒级时间戳随后被添加到参数字典 params 中。 params = {"timestamp": timestamp} 创建了一个Python字典，其中键 "timestamp" 对应的值是之前生成的时间戳。这个字典可以进一步扩展，包含其他必要的请求参数，例如API密钥、签名等，具体取决于API的要求。

某些交易所可能要求时间戳为字符串类型，而非整数。在这种情况下，你需要将时间戳转换为字符串： timestamp = str(int(time.time() * 1000)) 。请务必查阅API文档，确认所需的时间戳格式。

对参数进行签名

为了确保API请求的完整性和真实性，需要对请求参数进行签名。签名过程通常涉及以下步骤：

构建参数字符串： 将所有请求参数（不包括 signature 参数本身）按照参数名的字母升序排列，并将参数名和参数值用等号（=）连接。然后，将这些键值对用&符号（&）连接起来，形成一个query string。例如，如果参数包括 symbol=BTCUSDT 和 side=BUY ，那么排序后的query string应为 side=BUY&symbol=BTCUSDT 。
URL编码： 对query string中的参数值进行URL编码，以确保特殊字符（如空格、斜杠等）被正确处理。不同的API平台可能有不同的URL编码规则，请务必参考API文档。Python中可以使用 urllib.parse.urlencode(params, quote_via=urllib.parse.quote) 来进行编码。
计算HMAC-SHA256哈希值： 使用您的API密钥（ secret_key ）作为密钥，使用HMAC-SHA256算法对构建好的query string进行哈希运算。HMAC（Hash-based Message Authentication Code）是一种消息认证码算法，它使用密钥来生成消息的哈希值，从而验证消息的完整性和真实性。
生成签名： 将计算出的HMAC-SHA256哈希值转换为十六进制字符串。这个十六进制字符串就是您的签名。
添加签名参数： 将生成的签名作为一个新的参数（通常命名为 signature ）添加到原始的请求参数中。

以下Python代码片段演示了如何对参数进行签名：


import urllib.parse
import hmac
import hashlib

# 假设params是一个包含请求参数的字典
# 假设secret_key是您的API密钥

def generate_signature(params, secret_key):
  """
  生成API请求的签名。

  Args:
    params: 包含请求参数的字典。
    secret_key: 您的API密钥。

  Returns:
    签名字符串。
  """
  query_string = urllib.parse.urlencode(params)
  signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest()
  return signature

# 示例用法
# params = {'symbol': 'BTCUSDT', 'side': 'BUY', 'type': 'MARKET', 'quantity': 0.01}
# secret_key = 'your_secret_key'  # 替换为您的实际API密钥

# signature = generate_signature(params, secret_key)
# params["signature"] = signature

# 现在，params字典包含了签名
# 可以使用这个字典来构建API请求

重要提示：

确保您的API密钥安全存储，不要泄露给他人。
不同的API平台可能有不同的签名规则，请务必仔细阅读API文档，并按照文档的要求进行签名。
在进行API调用时，请确保您的服务器时间与API服务器的时间同步，否则可能会导致签名验证失败。可以使用NTP服务器进行时间同步。
仔细检查参数名称的大小写，确保与API文档中定义的一致。
某些API平台可能要求将API密钥包含在HTTP Header中，而不是作为query string参数。

发送请求

与MEXC API交互时，发送HTTP请求是关键步骤。以下代码展示了如何使用Python的 requests 库构造并发送一个GET请求。

需要构建请求头（headers）。 X-MEXC-APIKEY 是必不可少的字段，用于身份验证。将你的API密钥赋值给 api_key 变量，并将其包含在请求头中。

    
headers = {
    "X-MEXC-APIKEY": api_key
}

接下来，需要构造完整的URL。 base_url 是MEXC API的基础URL， endpoint 是具体的API端点， query_string 是查询参数。使用字符串拼接将它们组合起来。务必确保 endpoint 和 query_string 的正确性，并正确编码查询参数。

    
url = base_url + endpoint + "?" + query_string

使用 requests.get() 方法发送GET请求。将构造好的URL和请求头作为参数传递给该方法。 response 对象将包含服务器的响应。

    
response = requests.get(url, headers=headers)

发送请求后，应立即检查 response 对象的状态码，以确定请求是否成功。常见的状态码包括200（成功）、400（错误请求）、401（未授权）等。

示例代码假设已经定义了 api_key , base_url , endpoint 和 query_string 变量。在实际应用中，请根据你的具体需求修改这些变量。特别注意，API密钥应妥善保管，避免泄露。

处理响应

在发送HTTP请求后，处理服务器的响应至关重要。成功的响应通常意味着请求已被成功处理，而错误响应则表明出现了问题。以下代码片段展示了如何根据响应状态码来处理不同的情况。

if response.status_code == 200:

上述代码检查响应的状态码是否为200。状态码200表示"OK"，表明请求已成功完成。当状态码为200时，我们可以从响应中提取数据并进行进一步处理。

data = response.()

如果响应返回的是JSON格式的数据，可以使用 response.() 方法将其解析为Python字典或列表。这使得我们可以方便地访问和操作响应中的数据。

print(data)

解析后的数据可以使用 print() 函数输出到控制台，以便进行调试或验证。在实际应用中，可以根据需要对数据进行更复杂的处理，例如存储到数据库、显示在用户界面上等。

else:

如果响应状态码不是200，则表明请求失败。在这种情况下，我们需要处理错误并向用户提供有用的信息。

print(f"请求失败：{response.status_code} - {response.text}")

上述代码使用f-string格式化字符串，将响应状态码和错误信息一起输出到控制台。 response.status_code 包含了HTTP状态码，例如404（未找到）或500（服务器内部错误）。 response.text 包含了服务器返回的原始错误信息，这有助于诊断问题。将状态码和错误信息一同显示，能够更清晰地了解请求失败的原因，方便后续的问题排查和解决。

注意事项：

时间戳 (timestamp) 必填： 所有需要进行身份验证和签名的 API 请求，必须包含 timestamp 参数。该参数代表请求发送时的时间，以 Unix 时间戳的毫秒 (millisecond) 形式表示。精确的时间戳对于防止重放攻击至关重要，并确保请求的时效性。
签名算法：HMAC SHA256： MEXC API 使用 HMAC SHA256 算法进行签名生成。这意味着您需要使用您的 Secret Key 作为密钥，对请求的参数进行哈希运算，生成一个唯一的签名。此签名用于验证请求的完整性和来源。 HMAC SHA256 提供了强大的安全保障，确保数据在传输过程中未被篡改。
API Key 必须包含在请求头中： 在发送任何需要身份验证的 API 请求时，请务必将您的 API Key 添加到 HTTP 请求头中。密钥名称为 X-MEXC-APIKEY 。这是 MEXC 服务器识别您的身份并授权您访问特定 API 端点的关键步骤。未包含 API Key 的请求将被拒绝。
详细阅读 MEXC API 文档： 为确保成功集成 MEXC API，请务必仔细阅读官方 API 文档。文档中详细描述了每个 API 端点的具体参数要求、数据类型、请求方法 (GET, POST, PUT, DELETE 等) 和响应格式 (JSON)。充分理解 API 文档可以避免常见的错误，并提高开发效率。文档还包含了关于速率限制、错误代码和最佳实践的信息，这些信息对于构建稳定可靠的应用程序至关重要。

四、MEXC WebSocket API 使用详解

MEXC 交易所的 WebSocket API 旨在提供极速、稳定的实时数据推送服务，满足高频交易者和实时监控应用的需求。该 API 允许用户订阅多个数据通道，从而获取市场动态和账户信息。以下详细介绍常用的 WebSocket 通道及其用途：

实时行情 (Ticker)： [email protected]
此通道广播所有现货交易对的实时行情摘要，包括最新成交价、24 小时最高价、24 小时最低价、24 小时成交量等关键指标。开发者可利用这些数据构建价格监控系统或自动化交易策略。订阅此通道无需身份验证。
深度数据 (Order Book Depth)： [email protected]@BTCUSDT
此通道提供特定交易对（例如 BTCUSDT）的深度订单簿数据。 level5 参数表示订阅的是 5 档买卖盘数据，即买一到买五、卖一到卖五的价格和数量。更精细的订单簿数据有助于分析市场微观结构和流动性，适用于高频交易和套利策略。也可以替换level5为level20，获取20档买卖盘数据。订阅此通道无需身份验证。
交易数据 (Trade Data)： [email protected]@BTCUSDT
此通道推送特定交易对（例如 BTCUSDT）的实时成交记录，包括成交价格、成交数量、成交方向（买入或卖出）和成交时间戳。这些数据反映了市场的即时交易活动，可用于计算成交量加权平均价 (VWAP) 等指标，或用于识别大额交易。订阅此通道无需身份验证。
用户订单 (User Orders)： [email protected]
此通道提供与用户账户相关的订单更新信息，包括订单创建、订单状态变更（例如：已提交、部分成交、完全成交、已撤销）以及订单详细信息（例如：订单类型、价格、数量、手续费）。订阅此通道 需要身份验证 ，并且只能接收与该账户相关的订单数据。通过此通道，用户可以实时监控自己的交易活动。

示例：使用 Python 连接 MEXC WebSocket API 订阅实时行情

本示例演示如何使用 Python 连接 MEXC（抹茶）交易所的 WebSocket API，并订阅实时行情数据。MEXC WebSocket API 提供了高效、低延迟的市场数据流，适用于构建交易机器人、行情监控系统等应用。

要运行此示例，您需要安装 websocket-client 库。可以使用 pip 进行安装：

pip install websocket-client

以下是 Python 代码示例：

import websocket
import 
import time

# MEXC WebSocket API Endpoint (公共频道)
WS_ENDPOINT = "wss://wbs.mexc.com/ws"

# 订阅的主题：示例为 BTC/USDT 交易对的 kline 数据（1 分钟）
SYMBOL = "BTC_USDT"
INTERVAL = "1m"
SUBSCRIBE_TOPIC = {
    "method": "SUBSCRIPTION",
    "params": [
        f"kline.{SYMBOL}@{INTERVAL}"
    ]
}

def on_open(ws):
    """WebSocket 连接建立时触发的函数"""
    print("连接已建立")
    ws.send(.dumps(SUBSCRIBE_TOPIC)) # 发送订阅消息
    print("已发送订阅请求")


def on_message(ws, message):
    """收到 WebSocket 消息时触发的函数"""
    try:
        data = .loads(message)

        # 检查是否为心跳响应（ping/pong）
        if "ping" in data:
            ws.send(.dumps({"pong": data["ping"]})) # 回复pong
            print("收到心跳，已回复")
            return #防止心跳数据进入后续处理流程

        if "data" in data and "k" in data["data"]:
            kline_data = data["data"]["k"]
            # o: 开盘价, c: 收盘价, h: 最高价, l: 最低价, v: 成交量, t: 时间戳
            open_price = kline_data["o"]
            close_price = kline_data["c"]
            high_price = kline_data["h"]
            low_price = kline_data["l"]
            volume = kline_data["v"]
            timestamp = kline_data["t"]

            print(f"[{SYMBOL}] - 时间: {timestamp}, 开盘价: {open_price}, 收盘价: {close_price}, 最高价: {high_price}, 最低价: {low_price}, 成交量: {volume}")

    except Exception as e:
        print(f"解析数据出错: {e}, 原始消息: {message}")

def on_error(ws, error):
    """发生错误时触发的函数"""
    print(f"发生错误: {error}")

def on_close(ws, close_status_code, close_msg):
    """WebSocket 连接关闭时触发的函数"""
    print("连接已关闭")
    print(f"关闭代码: {close_status_code}, 关闭消息: {close_msg}")

if __name__ == "__main__":
    websocket.enableTrace(False) # 开启/关闭 debug 日志
    ws = websocket.WebSocketApp(
        WS_ENDPOINT,
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )

    # 设置心跳间隔，MEXC要求每隔5秒发送一次ping消息
    # ws.run_forever(ping_interval=5) #已由服务器自动维护心跳，无需客户端手动发送

    ws.run_forever()

代码说明：

WS_ENDPOINT ：MEXC WebSocket API 的公共地址。
SYMBOL ：要订阅的交易对，例如 "BTC_USDT"。
INTERVAL ：K线的时间间隔，例如 "1m"（1 分钟）。
SUBSCRIBE_TOPIC ：构建订阅消息的 JSON 对象，包括 method (SUBSCRIPTION)和 params (订阅的主题列表)。
on_open 函数：在 WebSocket 连接建立后，发送订阅消息。
on_message 函数：处理接收到的消息，解析 K 线数据并打印相关信息。注意处理心跳响应（ping/pong机制），交易所会定期发送ping消息，客户端必须回复pong消息以保持连接。
on_error 函数：处理错误。
on_close 函数：处理连接关闭事件。
websocket.enableTrace(False) ：控制是否开启 WebSocket 的 debug 日志。
ws.run_forever() ：启动 WebSocket 客户端，保持连接并监听消息。

注意：

需要注册MEXC账号并了解MEXC API的使用规则。
请务必阅读 MEXC 官方 API 文档以获取最新的 API 信息和限制。
在生产环境中使用时，请务必进行错误处理和异常处理，以确保程序的稳定性。
MEXC服务器会自动维护心跳连接，无需客户端手动发送ping消息。
如果需要使用私有频道（例如交易、下单等），需要进行身份验证。具体参考MEXC官方API文档。

此示例仅用于演示如何连接和订阅 MEXC WebSocket API，您可以根据自己的需求进行修改和扩展。

WebSocket 地址

WebSocket URL（统一资源定位符）为 wss://wbs.mexc.com/ws 。该地址是MEXC交易所提供的WebSocket服务的安全接入点。通过此URL，客户端可以建立持久的双向通信连接，实时接收市场数据更新，执行交易指令以及订阅特定账户的活动通知。 wss 协议代表WebSocket Secure，它通过TLS/SSL协议对数据传输进行加密，确保数据在客户端和服务器之间传输的安全性。客户端应用程序需要使用兼容WebSocket协议的库来连接此地址，并根据MEXC提供的API文档构建相应的请求和处理接收到的数据流。

订阅参数

subscribe_params 字典定义了WebSocket连接的订阅参数，用于指定需要接收的数据流。具体内容如下：

method : 指定WebSocket请求的方法，这里设置为 "SUBSCRIPTION" ，表明这是一个订阅请求。
params : 一个列表，包含了订阅的具体参数。在这里， ["[email protected]"] 表示订阅现货交易市场的公开交易对信息。不同的交易平台或API可能使用不同的参数格式来指定订阅内容，此例中订阅的是所有现货交易对的公开符号信息。
id : 一个整数，用于标识该订阅请求。可以用于跟踪请求的响应。每个请求的ID应该是唯一的，以便能够区分不同的响应。


subscribe_params = {
    "method": "SUBSCRIPTION",
    "params": ["[email protected]"],
    "id": 1
}

on_message 函数定义了当从WebSocket连接接收到消息时执行的操作。在这个例子中，它只是简单地打印接收到的消息。实际应用中，通常需要对消息进行解析和处理，例如提取数据、更新界面等。


def on_message(ws, message):
    print(message)

on_error 函数定义了当WebSocket连接发生错误时执行的操作。它接收一个错误对象作为参数，并打印错误信息。在实际应用中，可以根据错误类型采取相应的处理措施，例如重新连接、记录日志等。


def on_error(ws, error):
    print(error)

on_close 函数定义了当WebSocket连接关闭时执行的操作。它打印一条消息，表明连接已关闭。在实际应用中，可能需要在连接关闭时执行一些清理工作，例如释放资源、通知用户等。


def on_close(ws):
    print("WebSocket 连接已关闭")

on_open 函数定义了当WebSocket连接建立成功后执行的操作。它首先使用 ws.send(.dumps(subscribe_params)) 发送订阅参数，将Python字典转换为JSON字符串并发送。然后，打印一条消息，表明订阅请求已发送。


def on_open(ws):
    ws.send(.dumps(subscribe_params))
    print("WebSocket 连接已建立，已发送订阅请求")

以下代码块是主程序入口。它首先使用 websocket.WebSocketApp 创建一个WebSocket应用程序对象，并指定WebSocket服务器的URL (示例中为 websocket_url ，需要替换为实际的URL) 以及各种回调函数（ on_message 、 on_error 、 on_close ）。然后，将 on_open 函数绑定到 WebSocketApp 对象的 on_open 属性。调用 ws.run_forever() 启动WebSocket客户端，使其保持运行状态并监听来自服务器的消息。


if __name__ == "__main__":
    ws = websocket.WebSocketApp(websocket_url,
                                on_message=on_message,
                                on_error=on_error,
                                on_close=on_close)
    ws.on_open = on_open
    ws.run_forever()

注意事项：

WebSocket 连接必须先完成握手过程才能发送订阅请求。在连接建立后，客户端与服务器之间会进行协议升级，确认双方都支持 WebSocket 协议。
订阅请求采用 JSON 格式，必须包含 method 、 params 和 id 这三个关键字段，区分大小写，且字段名称必须拼写正确。
method 字段定义了请求的操作类型，对于订阅操作，该字段应设置为 SUBSCRIPTION 。其他操作类型也可能存在，请参考 MEXC API 文档。
params 字段用于指定需要订阅的数据通道，例如 [email protected] 表示订阅现货市场所有交易对的公开行情数据。不同的通道提供不同类型的数据，如深度数据、K线数据等。确保通道名称正确，避免订阅失败或接收到错误数据。
id 字段是请求的唯一标识符，由客户端自定义生成，用于区分不同的订阅请求。服务器在响应中会返回相同的 id ，便于客户端识别响应对应的请求。建议使用具有唯一性的字符串或数字。
强烈建议在使用 MEXC WebSocket API 之前，详细查阅官方 API 文档，深入理解各个 WebSocket 通道的具体格式、数据结构以及数据更新频率。文档通常包含示例代码和详细的参数说明，有助于正确解析和处理接收到的数据。

五、常见问题与解决方案

在使用 MEXC API 进行交易和数据获取时，开发者可能会遇到一些常见问题。以下是一些常见问题、潜在原因以及相应的详细解决方案：

API 密钥无效（Invalid API Key）：
- 问题描述： API 请求返回认证失败的错误代码，表明提供的 API 密钥无法被验证。
- 可能原因： API Key 或 Secret Key 输入错误、复制粘贴时遗漏字符，或者 API 密钥尚未激活。
- 解决方案：
  1. 仔细核对 MEXC 账户中生成的 API Key 和 Secret Key，确保完全一致，包括大小写。
  2. 重新生成新的 API 密钥，并确保在生成后立即启用。
  3. 检查 API 密钥的权限设置，确保具有执行所需操作（如交易、查询）的权限。
  4. 如果使用了IP限制，需要将发出api请求的服务器IP添加到白名单。
签名错误（Signature Error）：
- 问题描述： API 请求返回签名验证失败的错误代码，表明请求的签名不正确。
- 可能原因： 签名算法实现错误、参数顺序错误、缺少必要的参数，或者 Secret Key 使用不正确。
- 解决方案：
  1. 仔细检查签名算法的实现代码，确保与 MEXC 官方文档提供的签名算法完全一致（通常使用 HMAC-SHA256）。
  2. 确保所有参与签名的参数按照文档规定的顺序排列。
  3. 确保包含所有必要的参数，包括 timestamp (时间戳)。
  4. 使用正确的 Secret Key 进行签名，避免使用错误的 Key 或空格。
  5. 检查时间戳是否在有效范围内，避免服务器与客户端时间不同步导致签名失败。
  6. 避免对Secret Key进行编码或解码操作，确保原始Secret Key用于签名。
频率限制（Rate Limit Exceeded）：
- 问题描述： API 请求返回 429 Too Many Requests 错误，表明请求频率超过了 MEXC API 的限制。
- 可能原因： 短时间内发送了过多的 API 请求。
- 解决方案：
  1. 查阅 MEXC API 文档，了解不同 API 端点的频率限制。
  2. 在代码中实现请求频率控制机制，例如使用令牌桶算法或漏桶算法。
  3. 尽量使用 WebSocket API 获取实时数据，减少对 REST API 的轮询需求。
  4. 批量处理数据，减少 API 调用次数。
  5. 如果需要高频率的数据访问，可以考虑申请更高的 API 频率限制（如果 MEXC 提供此选项）。
订单错误（Order Error）：
- 问题描述： 下单 API 请求失败，返回错误代码，表明订单参数不正确。
- 可能原因： 交易对错误、数量超出限制、价格不符合要求、账户余额不足等。
- 解决方案：
  1. 仔细检查交易对代码是否正确，例如 "BTC_USDT"。
  2. 确保订单数量在 MEXC 允许的最小和最大数量范围内。
  3. 检查价格是否符合价格步长要求。
  4. 确保账户有足够的可用余额来支付订单。
  5. 检查订单类型是否正确（市价单、限价单等）。
  6. 阅读错误信息，通常会提供更详细的错误原因。
连接错误（Connection Error）：
- 问题描述： 无法连接到 MEXC API 服务器，或者 WebSocket 连接中断。
- 可能原因： 网络连接问题、防火墙阻止连接、WebSocket 地址错误等。
- 解决方案：
  1. 检查网络连接是否正常。
  2. 检查防火墙设置，确保允许与 MEXC API 服务器的连接。
  3. 确保 WebSocket 地址正确，并且使用正确的协议（wss://）。
  4. 如果使用代理服务器，请确保代理服务器配置正确。
  5. 尝试使用不同的网络环境进行连接。
  6. 检查MEXC服务器状态，是否存在维护或故障。

六、API 安全注意事项

在使用 MEXC API 进行交易和数据访问时，安全性至关重要。泄露或不当使用 API 密钥可能导致资金损失或账户被盗。因此，请务必严格遵守以下安全措施，以确保您的 API 密钥和账户安全：

妥善保管 API 密钥： API Key 和 Secret Key 是访问 MEXC API 的凭证，如同账户密码一样重要。切勿以任何方式将它们泄露给任何第三方，包括通过电子邮件、即时通讯工具或公开的代码仓库。应将 API 密钥存储在安全的地方，例如加密的数据库或硬件钱包中。不要将 API 密钥硬编码到应用程序中，避免上传到公共代码仓库。
设置 IP 地址白名单： 通过 MEXC 提供的 IP 地址白名单功能，您可以限制 API 密钥只能从预先批准的 IP 地址访问。这可以防止即使 API 密钥泄露，未经授权的 IP 地址也无法使用该密钥。建议只允许您的服务器或特定开发环境的 IP 地址访问 API。定期检查和更新 IP 白名单，确保其始终与您的实际使用情况相符。
启用双重验证（2FA）： 为您的 MEXC 账户启用双重验证，例如 Google Authenticator 或短信验证码。即使您的账户密码泄露，攻击者仍然需要通过第二重验证才能登录您的账户或使用 API 密钥。这大大提高了账户的安全性，防止未经授权的访问。
定期更换 API 密钥： 定期更换您的 API 密钥，可以降低因密钥泄露而造成的风险。即使您认为您的密钥没有被泄露，定期更换也是一种良好的安全实践。MEXC 允许您随时生成新的 API 密钥，并停用旧的密钥。建议每隔一段时间（例如，每月或每季度）更换一次 API 密钥。
监控 API 使用情况： 密切监控您的 API 使用情况，包括请求频率、交易量和账户余额。如果发现任何异常活动，例如未经授权的交易或异常高的请求频率，立即停止 API 使用并调查原因。MEXC 可能会提供 API 使用情况的监控工具或日志，您可以利用这些工具来检测异常情况。
使用安全的网络连接： 使用 API 时，始终通过安全的网络连接（例如 HTTPS）进行通信。避免使用公共 Wi-Fi 网络，因为这些网络可能不安全，容易受到中间人攻击。
限制 API 权限： MEXC 允许您为 API 密钥设置不同的权限，例如只允许读取数据或允许进行交易。根据您的实际需求，只授予 API 密钥所需的最低权限。例如，如果您的应用程序只需要读取市场数据，则不要授予 API 密钥交易权限。