MEXC API 接口限制与说明
本文档旨在提供对 MEXC 交易所 API 使用限制及相关说明的详尽阐述，以便开发者能够更有效地理解并安全地使用 MEXC API。透彻理解这些约束条件对于构建稳定、可靠的交易应用程序至关重要，并有助于避免因不当 API 调用而可能导致的错误、性能瓶颈或潜在的账户安全风险。
MEXC API 提供了一系列功能，允许开发者通过编程方式访问和操作交易所的数据以及执行交易操作。然而，为了确保平台的稳定性、公平性和安全性，MEXC 对 API 的使用施加了特定的限制。这些限制旨在防止滥用、过度请求以及潜在的恶意行为，从而维护所有用户的交易体验。
理解这些限制不仅仅是阅读文档的简单任务，而是深入理解其背后的原理和影响。例如，请求频率限制旨在防止服务器过载，保证所有用户的 API 请求都能得到及时处理。了解如何优化你的应用程序，使其在这些限制内高效运行，是成为一名成功 API 开发者的关键。
除了速率限制之外，MEXC 还可能实施其他类型的限制，例如针对特定 API 端点的访问限制、账户级别的交易限制或资金提取限制。这些限制的具体细节可能会随着市场条件的变化和交易所的安全策略调整而发生变化，因此开发者应定期查阅官方文档，以确保其应用程序与最新的 API 规范保持一致。
了解 API 使用条款和条件同样重要。这些条款涵盖了 API 的使用许可、责任限制以及 MEXC 可能采取的任何纠正措施，例如暂停或终止违规账户的 API 访问权限。因此，仔细阅读并遵守这些条款是避免不必要风险的必要步骤。
本指南将深入探讨这些限制的各个方面，提供具体的示例和最佳实践，帮助开发者充分利用 MEXC API 的强大功能，同时避免违反任何相关规定。我们将涵盖速率限制、数据限制、交易限制以及安全措施等关键主题，并提供实用技巧，帮助开发者构建高效、可靠且安全的交易应用程序。
API 接口调用频率限制
MEXC 对 API 接口的调用频率实施严格的限制措施，旨在保障平台的整体稳定性和安全性，同时有效防止恶意滥用行为。这些限制通常以 "每分钟请求次数" (RPM, Requests Per Minute) 或 "每秒请求次数" (RPS, Requests Per Second) 的形式呈现，清晰地定义了用户在特定时间段内可以发送的最大请求数量。需要特别注意的是，具体的调用频率限制会根据不同的 API 端点以及用户的 API 密钥等级而有所差异。例如，交易相关的 API 接口通常会有比获取市场数据更高的限制，而更高级别的 API 密钥通常享有更高的调用频率上限，以满足专业交易者和机构用户的需求。
1. 通用限制：
- 公共接口： 无需身份验证即可访问的公共接口，例如获取实时市场行情数据、历史K线数据、交易对信息等，通常具有相对较高的请求速率限制，以每分钟请求数（RPM，Requests Per Minute）或每秒请求数（RPS，Requests Per Second）来衡量。即便如此，开发者仍需采取措施合理控制请求频率，实施本地缓存机制，避免短时间内发起大量请求，从而对交易所服务器基础设施造成不必要的压力，影响其他用户的正常使用。超出限制可能导致IP被暂时或永久封禁。
- 私有接口： 需要进行身份验证（Authentication）才能访问的私有接口，包括下单（Place Order）、撤单（Cancel Order）、查询账户信息（Account Balance）、查询历史交易记录（Trade History）等涉及用户资金和交易操作的接口，通常具有较低的请求速率限制。这是为了增强用户账户安全性和系统稳定性，有效防止潜在的恶意程序或攻击者利用自动化脚本进行批量操作，例如高频交易攻击或恶意资金转移。严格的速率限制能够减轻服务器负载，确保所有用户公平地访问资源。
2. 不同 API 端点的限制：
不同的 API 端点，其调用频率限制往往存在差异，这是为了维护交易所的稳定性和公平性，防止恶意行为。不同的功能模块由于其重要性和资源消耗程度不同，因此拥有不同的限制策略。理解这些限制对于开发高效稳定的交易策略至关重要。
- 现货交易接口： 通常对下单、撤单等接口有更严格的频率限制。这是因为高频的下单和撤单操作可能会对交易系统造成压力，并可能被用于刷单等不正当行为。交易所会通过限制这些接口的调用频率来防止此类行为，保障所有用户的交易体验。例如，可能限制每秒钟最多下单/撤单的次数，或者限制在一定时间窗口内允许的最大请求数量。
- 合约交易接口： 合约交易接口与现货交易接口类似，对交易相关的接口（如开仓、平仓、修改订单等）实施频率限制。由于合约交易通常涉及更高的杠杆和风险，交易所会更加谨慎地控制这些接口的调用频率，以防止恶意操纵市场或系统过载。交易所会根据市场状况和系统负载动态调整这些限制。
- 账户信息接口： 查询账户余额、持仓信息、交易历史等接口的限制通常相对宽松。这些接口主要用于获取用户自身的账户数据，对交易系统的影响较小。然而，为了防止恶意爬取用户信息，交易所仍然会对这些接口设置一定的频率限制。例如，可能允许用户每分钟查询一定次数的账户余额。
- 行情数据接口： 获取 K 线数据、深度数据、最新成交价等行情数据接口的限制通常相对宽松。这些接口主要用于获取市场行情信息，对交易系统的影响相对较小。但是，为了防止恶意爬取行情数据，交易所仍然会对这些接口设置一定的频率限制。例如，可能允许用户每分钟获取一定数量的 K 线数据点。交易所会根据市场数据更新的频率和系统负载来调整这些限制。
3. API 密钥级别的限制：
MEXC API 的使用受到用户 API 密钥级别的严格限制，不同级别的密钥对应不同的调用频率上限。这些限制旨在维护系统的稳定性和公平性，防止恶意攻击和滥用。更高级别的 API 密钥，例如为机构或高频交易者设计的密钥，通常被赋予更高的每分钟请求数 (RPM) 或每秒请求数 (RPS) 阈值，从而允许更频繁的数据访问和交易操作。
获得更高级别 API 密钥的资格通常取决于用户在 MEXC 平台上的交易活动。交易所可能会设定特定的交易量要求，例如在过去 30 天内达到一定的交易额。持有更高级别的 MEXC 代币或参与特定的活动也可能成为升级 API 密钥级别的条件。用户需要仔细阅读 MEXC 的 API 文档和相关条款，了解其 API 密钥级别的具体限制以及升级密钥级别所需的条件。
未能遵守 API 密钥级别的调用频率限制可能会导致 API 请求被拒绝或 API 密钥被暂时禁用。因此，开发者应在设计交易机器人或数据抓取工具时，充分考虑这些限制，并实施适当的错误处理机制和退避策略，以确保 API 调用的稳定性和可靠性。
4. 超出限制的处理：
当 API 调用频率超过预设的限制时，服务器会返回相应的 HTTP 状态码，通常是 429 (Too Many Requests) 或 403 (Forbidden)，表明请求已被限制。开发者必须在应用程序中妥善处理这些错误响应，确保程序的健壮性和用户体验。处理方式应根据具体场景和 API 平台的建议进行调整。
- 暂停请求（Backoff/Retry）： 这是最常见的处理方式。当收到限流错误时，程序应暂停一段时间，然后再重试请求。可以使用指数退避策略（Exponential Backoff），即每次重试前暂停的时间呈指数增长，从而避免在高负载时持续发起无效请求。例如，第一次重试暂停1秒，第二次2秒，第三次4秒，依此类推。同时，设置最大重试次数，防止无限循环。
- 降低频率（Rate Limiting）： 主动降低 API 请求的频率，避免触发限流。这可以通过调整应用程序的逻辑来实现，例如减少数据同步的频率或合并多个请求。考虑使用令牌桶（Token Bucket）或漏桶（Leaky Bucket）算法在客户端实现速率限制。
- 使用队列（Queueing）： 将 API 请求放入消息队列中，例如 RabbitMQ 或 Kafka，然后由消费者按照一定的速率从队列中取出请求并发送到 API 服务器。这可以有效地平滑请求流量，避免突发流量冲击 API 服务器。队列还可以提供请求的持久化，即使应用程序崩溃，请求也不会丢失。
- 使用 WebSocket（WebSockets）： 对于需要实时更新的数据，应该优先考虑使用 WebSocket 连接而不是传统的轮询 API。WebSocket 是一种持久化的双向通信协议，可以减少 HTTP 请求的开销，并且能够实时地推送数据，提高效率和降低延迟。如果 API 提供 WebSocket 接口，强烈建议使用。
- 缓存（Caching）： 适当地使用缓存可以减少对 API 的直接请求。对于不经常变化的数据，可以将其缓存在客户端或服务器端。当需要这些数据时，首先从缓存中获取，只有当缓存失效时才向 API 服务器发起请求。常用的缓存技术包括 HTTP 缓存、Redis、Memcached 等。
- 优化请求（Optimize Requests）： 检查 API 请求的效率。例如，避免请求过多的数据，只请求需要的字段，使用批量请求（Batch Request）将多个请求合并为一个请求，等等。优化请求可以减少 API 服务器的负载，并降低触发限流的风险。
- 使用 API 密钥（API Key）或 OAuth： API 密钥和 OAuth 可以用于身份验证和授权。通过正确地使用 API 密钥和 OAuth，API 服务器可以更好地识别和控制请求，从而避免滥用和恶意攻击。不同的 API 密钥可能具有不同的速率限制，合理地分配和管理 API 密钥可以提高整体系统的性能。
API 接口权限限制
除了API调用频率限制，MEXC等加密货币交易所的API还会对用户的API密钥进行精细化的权限控制。这种权限限制机制旨在增强账户的安全性，防止未经授权的操作。不同的权限级别对应着不同的操作范围，用户应根据实际需求谨慎选择。
- 只读权限： 允许用户获取实时的市场行情数据，包括价格、交易量、深度信息等。还可以查询账户余额、历史订单等信息。但最关键的是，只读权限禁止任何形式的交易操作，例如下单、撤单，从而有效防止因API密钥泄露而造成的资产损失。该权限适用于数据分析师、行情观察者等只需要获取信息的场景。
- 交易权限： 允许用户执行下单（包括市价单、限价单等）、撤单、修改订单等所有与交易相关的操作。拥有交易权限的API密钥可以完全控制账户的交易行为，因此必须妥善保管，并采取必要的安全措施，例如IP地址白名单、二次验证等。该权限适用于程序化交易者、量化交易团队等需要自动化交易的场景。
- 提币权限： 允许用户将账户中的加密货币转移到其他地址。由于提币操作直接涉及资产转移，因此强烈建议非必要情况下不要开放此权限。即使需要提币权限，也应设置严格的提币地址白名单，并密切监控提币记录，以确保账户安全。提币权限是风险最高的权限，一旦泄露，可能导致不可挽回的损失。该权限仅适用于需要通过API进行自动提币的场景，例如支付系统。
在创建 API 密钥时，用户应仔细评估自身的需求，并遵循最小权限原则，选择最合适的权限组合。如果仅需获取市场行情数据进行分析，强烈建议选择只读权限，最大限度地降低安全风险，避免因密钥泄露而导致账户被恶意利用，造成不必要的资金损失。务必定期审查和更新API密钥的权限设置，确保其始终符合当前的使用需求。
API 接口数据格式说明
MEXC API 使用 JSON (JavaScript Object Notation) 作为标准数据交换格式。JSON 是一种轻量级的数据交换格式，易于人阅读和编写，同时也易于机器解析和生成。所有与 MEXC API 的交互，包括发送请求和接收响应，都需要严格遵循 JSON 格式。这意味着请求的参数必须以 JSON 格式进行编码，并且 API 返回的数据也将以 JSON 格式呈现。开发者必须熟悉 JSON 语法，理解键值对的概念，以及如何正确地构建和解析 JSON 对象和数组。为了有效地处理 API 数据，建议使用各种编程语言中提供的成熟的 JSON 解析库，这些库可以简化 JSON 数据的序列化（将数据转换为 JSON 字符串）和反序列化（将 JSON 字符串转换为数据结构）过程，提高开发效率并减少出错的可能性。
1. 请求格式：
API 请求的构建涉及多个关键组件，共同确保数据传输的准确性和安全性。 理解这些组件对于成功地与加密货币交易所或其他服务进行交互至关重要。
-
URL：
API 端点的统一资源定位符（URL）指向服务器上特定的资源或功能。 正确的 URL 是发起请求的基础，它定义了请求的目标地址。 例如，
https://api.example.com/v1/orderbook可能指向获取订单簿数据的端点。 -
HTTP 方法：
超文本传输协议（HTTP）定义了多种方法，用于指示对指定资源执行的操作。
- GET： 用于从服务器检索数据，通常用于获取市场信息或账户余额等只读操作。
- POST： 用于向服务器提交数据，通常用于创建新订单或提交交易请求。
- PUT： 用于更新服务器上的现有资源，较少在加密货币 API 中使用。
- DELETE： 用于删除服务器上的资源，同样较少使用。
-
请求头：
请求头包含了关于请求的元数据，例如内容类型、授权信息等。
- API 密钥： 用于身份验证，证明请求者的身份和权限。通常在每个请求中包含 API 密钥，以允许服务器验证请求的来源。
- 签名： 用于确保请求的完整性和真实性，防止数据篡改。签名通常基于请求参数、时间戳和私钥生成，并在请求头中发送。
-
Content-Type：
指示请求体的媒体类型，例如
application/。 - Accept： 指示客户端能够理解的响应媒体类型。
-
请求体：
请求体包含了要发送给服务器的实际数据。
- 请求参数： 根据 API 的设计，请求体可能包含各种参数，用于指定请求的具体内容。
-
交易对：
指定要交易的加密货币对，例如
BTC/USDT。 - 订单类型： 指示订单的类型，例如市价单（Market Order）或限价单（Limit Order）。
- 价格： 指定限价单的价格。
- 数量： 指定要交易的加密货币数量。
2. 响应格式：
API 响应是应用程序接口之间进行数据交换的关键组成部分。为了确保通信的有效性和可靠性，API 响应通常遵循特定的结构和格式。 响应通常包含以下几个部分：
-
HTTP 状态码：
HTTP 状态码是服务器向客户端发出的三位数字代码，用于指示请求的处理结果。它清晰地表明 API 请求是否成功被服务器接收、理解并处理。例如：
- 200 OK： 表示请求已成功，服务器已成功处理请求并返回了所需的数据。
- 400 Bad Request： 表示客户端的请求存在错误，例如参数格式不正确、缺少必要参数等。这通常意味着客户端需要检查并修正其请求。
- 401 Unauthorized： 表示客户端未经过身份验证或身份验证失败，无权访问所请求的资源。客户端需要提供有效的身份验证凭据（例如 API 密钥或令牌）。
- 403 Forbidden： 表示服务器理解请求，但拒绝执行。这可能是由于权限不足或其他访问限制。
- 404 Not Found： 表示服务器找不到与请求 URI 相匹配的资源。
- 429 Too Many Requests： 表示客户端在短时间内发送了过多的请求，超出了服务器的频率限制。客户端需要稍后重试或调整请求频率。
- 500 Internal Server Error： 表示服务器在处理请求时遇到了内部错误。这通常表明服务器端存在问题，客户端可以稍后重试。
-
响应头：
响应头是 HTTP 响应的一部分，包含关于响应的元数据信息。这些信息可以帮助客户端理解和处理响应。重要的响应头包括：
-
Content-Type：
指定响应体的 MIME 类型，例如
application/表示 JSON 格式的数据，text/xml表示 XML 格式的数据。这告诉客户端如何解析响应体的内容。 - Content-Length： 指定响应体的长度，单位为字节。
- Date： 指示服务器发送响应的日期和时间。
- Server： 指示服务器的软件信息。
- RateLimit-Limit： （如果API有限制速率）指示在时间窗口内允许的最大请求数。
- RateLimit-Remaining： （如果API有限制速率）指示在当前时间窗口内剩余的请求数。
- RateLimit-Reset： （如果API有限制速率）指示时间窗口重置的Unix时间戳。
-
Content-Type：
指定响应体的 MIME 类型，例如
-
响应体：
响应体是 HTTP 响应的主要部分，包含 API 返回的实际数据。数据的格式通常由 Content-Type 响应头指定。常见的响应体内容包括：
- 市场行情数据： 例如加密货币的价格、交易量、涨跌幅等。
- 订单信息： 例如订单 ID、交易对、买卖方向、数量、价格、状态等。
- 账户余额： 例如可用余额、冻结余额、总余额等。
- 错误信息： 当请求失败时，响应体可能包含详细的错误信息，帮助客户端诊断问题。
- 其他数据： 根据 API 的功能，响应体可能包含其他类型的数据。
3. 时间戳：
在与加密货币交易所和相关服务的 API 接口交互时，时间戳扮演着至关重要的角色。 许多 API 接口要求在请求中包含时间戳参数，常见的参数名称包括
timestamp
和
recvWindow
。 这些时间戳用于验证请求的时效性，防止重放攻击，并确保交易的顺序性。时间戳通常以 Unix 时间戳格式表示，精确到毫秒级别 (milliseconds)。Unix 时间戳是指自协调世界时（UTC）1970年1月1日0时0分0秒起至现在的总毫秒数。
客户端应用程序务必确保发送的时间戳的准确性。如果时间戳与服务器的时间存在显著偏差，API 请求很可能会失败，并返回错误信息。 交易所通常会设置一个时间窗口（例如
recvWindow
），允许客户端的时间戳在这个窗口范围内波动。超出此窗口的请求将被拒绝。为了保证时间戳的准确性，强烈建议客户端使用网络时间协议 (NTP) 服务，例如通过操作系统内置的 NTP 客户端或第三方 NTP 库，定期与可靠的 NTP 服务器同步系统时间。这可以最大程度地减少时间偏差，提高 API 请求的成功率。
某些 API 接口可能还要求时间戳作为字符串类型传递，而不是数字类型。因此，在生成时间戳并将其包含在 API 请求中时，请务必仔细阅读 API 文档，并遵循其规定的数据类型和格式要求。
API 接口签名
为了保障 API 请求的安全性与完整性，MEXC 交易所要求对所有涉及用户资产和私有信息的 API 接口进行签名验证。通过签名机制，可以有效防止请求被篡改或伪造，确保交易安全。
- 构建签名字符串： 为了创建可信的签名，首先需要构建一个签名字符串。此过程涉及将所有请求参数（包括时间戳）按照字典顺序（ASCII码顺序）进行排序，然后使用 "&"符号连接参数名和参数值，最后将所有连接的参数对拼接在一起形成一个完整的签名字符串。务必确保参数值已进行 URL 编码，并且包含在请求中的所有参数都参与签名构建。
- 使用密钥进行哈希： 签名字符串构建完成后，使用您的 API 密钥（Secret Key）对其进行哈希运算以生成最终签名。推荐使用的哈希算法是 HMAC-SHA256，因为它提供了良好的安全性和性能。请注意，API 密钥（Secret Key）必须妥善保管，切勿泄露给他人。HMAC-SHA256算法需要使用API密钥对签名字符串进行加密处理，生成的哈希值就是最终的签名。
- 将签名添加到请求头或请求参数中： 生成签名后，需要将其包含在 API 请求中。通常，签名会被添加到 HTTP 请求头中的 "X-MEXC-SIGNATURE" 字段，或者作为请求参数 "signature" 的值传递给服务器。MEXC 交易所可能会根据具体的 API 接口选择不同的方式传递签名，请务必参考相关 API 文档。在发送请求时，还需要包含一个时间戳参数，以防止重放攻击。
服务器接收到 API 请求后，会使用相同的算法和您的 API 密钥（Secret Key）重新计算签名，并将计算出的签名与请求中提供的签名进行比较。如果两个签名一致，则表明请求是合法的且未被篡改。如果签名不匹配，服务器将拒绝该请求，并返回相应的错误代码，例如 "Invalid Signature" 或 "Signature Mismatch"。这确保了只有持有有效 API 密钥的用户才能成功调用 API 接口。
API 接口错误码
MEXC API 会返回各种错误码，精确地指示 API 请求失败的具体原因。对于开发者而言，透彻理解这些错误码的含义至关重要，能够帮助他们快速诊断问题并采取相应的处理措施，保证交易程序的稳定运行。MEXC API 的错误码体系设计旨在提供明确的反馈，协助开发者优化其应用逻辑。 常见的错误码包括：
-
400 Bad Request：请求参数错误。通常是由于请求中包含了不符合API要求的参数，例如数据类型错误、缺少必要参数、参数值超出范围等。开发者应该仔细检查请求参数，确保符合 API 文档的规定。 详细的错误信息通常会包含在返回的错误消息中，帮助开发者定位具体出错的参数。 -
401 Unauthorized：未授权。通常是由于 API 密钥无效或签名错误导致。开发者需要检查 API 密钥是否正确配置，并且签名算法是否正确实现。确保用于生成签名的私钥与 MEXC 账户关联，并且请求的时间戳在有效范围内。 仔细核对 API 密钥、密钥类型以及签名算法的实现，确保其与 MEXC 平台的规范完全一致。 -
403 Forbidden：权限不足。API 密钥没有执行该操作的权限。这意味着 API 密钥没有被授权执行所请求的操作。开发者需要检查 API 密钥的权限设置，确保它拥有足够的权限来执行该操作。 例如，如果需要进行交易操作，API 密钥需要拥有交易权限。请在 MEXC 平台上检查并更新 API 密钥的权限设置。 -
429 Too Many Requests：超出频率限制。为了保护 API 的稳定性和可用性，MEXC API 对请求频率进行了限制。当请求频率超过限制时，会返回此错误码。开发者需要控制请求频率，避免超出限制。可以使用缓存、队列等技术来平滑请求流量。 参考 MEXC API 文档了解具体的频率限制规则，并根据实际情况进行调整。 -
500 Internal Server Error：服务器内部错误。这通常表示 MEXC 服务器遇到了未知的错误。开发者可以稍后重试该请求。如果问题持续存在，请联系 MEXC 技术支持。此类错误通常与客户端代码无关，需要 MEXC 平台进行排查和解决。 -
1000：Invalid parameter. 无效的参数。该错误码与 HTTP 400 类似，更具体地指示了参数无效的原因。 仔细检查请求参数，确保其满足 API 的所有要求，例如数据类型、格式、取值范围等。 -
1002：Authentication failed. 认证失败。该错误码与 HTTP 401 类似，表示身份验证过程失败。 检查 API 密钥是否正确配置，签名算法是否正确实现，以及时间戳是否有效。 确保所有认证信息都与 MEXC 平台的要求一致。 -
1003：Too many requests. 请求过多。 该错误码与 HTTP 429 类似，表示请求频率超过了限制。 开发者需要控制请求频率，避免超出限制，并使用适当的重试机制。 -
3000：Insufficient balance. 余额不足。表示账户余额不足以完成交易。 开发者需要检查账户余额，确保有足够的资金来执行交易。 考虑使用更小的交易量，或者充值账户。 -
3001：Order does not exist. 订单不存在。表示指定的订单 ID 找不到。 开发者需要检查订单 ID 是否正确，或者订单是否已经被取消或成交。 确保订单 ID 是有效的，并且订单仍然存在于系统中。
API 接口版本更新
MEXC 作为领先的数字资产交易平台，会定期更新其应用程序编程接口 (API)，旨在不断提升用户体验，并引入更强大的交易功能和更优越的系统性能。这些更新可能包括但不限于：新增的交易对、改进的订单类型、更高效的数据推送机制以及更安全的身份验证方法。
对于开发者而言，密切关注 MEXC 官方发布的 API 接口更新日志至关重要。 更新日志会详细列出每次更新的具体内容，包括新增的功能、修改的参数以及可能存在的兼容性问题。 开发者应仔细阅读更新日志，并根据自身应用程序的实际情况，及时进行相应的调整和升级，以确保其应用程序能够平稳、高效地与最新的 API 接口进行交互。
未及时更新可能导致应用程序无法正常运行，或无法使用最新的功能。因此，我们强烈建议开发者定期检查 API 更新情况，并采取必要的措施，以保持应用程序与 MEXC 平台的同步，确保交易操作的顺畅进行和数据的准确性。
MEXC 致力于为开发者提供稳定、可靠的 API 接口，并不断优化其性能。我们鼓励开发者积极参与 API 的测试和反馈，共同构建一个更加完善的数字资产交易生态系统。
本文详细介绍了 MEXC API 的使用限制和相关说明，包括调用频率限制、权限限制、数据格式说明、签名机制和错误码等。 开发者需要仔细阅读本文档，并严格遵守相关规定，以确保 API 调用的稳定性和安全性。 合理利用 MEXC API，可以构建出功能强大、高效稳定的交易应用。