BitMEX API接口使用详解：交易与数据分析实战

日期：2025-02-14 栏目：编程浏览：70

BitMEX API 接口使用指南：从入门到实践

BitMEX (Bitcoin Mercantile Exchange) 是一家知名的加密货币衍生品交易所，提供包括永续合约、期货等多种交易产品。其强大的 API 接口允许开发者通过程序化方式接入平台，进行自动交易、数据分析、风险管理等操作。本文将深入探讨 BitMEX API 的使用方法，并指导你如何在实际应用中有效利用其功能。

API 概述

BitMEX API 遵循 REST (Representational State Transfer) 架构原则，是一种广泛应用于网络应用程序设计的风格。这意味着开发者可以通过发送标准的 HTTP 请求（例如 GET、POST、PUT、DELETE）与 BitMEX 服务器进行数据交互和功能调用。 API 提供了一整套预定义的端点，每个端点对应特定的功能模块，细分来看，这些端点涵盖了丰富的市场行情数据，包括但不限于最新成交价（Last Price）、买一价/卖一价（Best Bid/Ask）、交易量（Volume）、指数价格（Index Price）等；账户信息管理，允许用户查询账户余额、保证金水平、已实现盈亏、未实现盈亏等关键指标；订单管理功能，支持用户创建、修改、取消订单，以及查询订单状态、成交记录等；仓位查询功能，方便用户获取当前持仓情况，包括持仓数量、平均持仓成本、盈亏比例等详细信息。

除了 REST API 之外，BitMEX 还提供了 WebSocket API，这是一种基于 TCP 协议的全双工通信协议。 WebSocket API 允许服务器主动向客户端推送数据，而无需客户端发起请求，显著降低了延迟，极大地提升了数据传输效率。通过 WebSocket API，用户可以接收实时的市场数据更新，例如实时交易价格（Real-time Trade Prices）、深度订单簿状态（Order Book snapshots and updates）、以及其他关键的市场动态。这种实时性对于高频交易、量化交易以及需要快速响应市场变化的交易策略至关重要。

REST API 接口

REST API 接口是与 BitMEX 平台进行交互的关键方式，主要用于执行各种交易操作，例如下单、修改订单、取消订单，以及查询账户信息，包括账户余额、持仓情况、交易历史等。为了确保数据传输的安全性，所有与 BitMEX API 的通信都必须强制使用 HTTPS 协议进行加密传输，防止中间人攻击和数据窃取。API 接口通常会返回 JSON (JavaScript Object Notation) 格式的数据，这种格式易于解析，被广泛应用于网络数据传输。

身份验证: 访问 BitMEX 平台上的某些需要授权的 API 端点，例如执行交易或访问敏感账户信息，需要进行身份验证。BitMEX 使用 API 密钥 (API Key) 和密钥 (Secret) 组合进行身份验证。API 密钥用于标识您的账户，密钥用于生成请求签名。您需要在 BitMEX 平台上创建一个 API 密钥，并采取必要的安全措施妥善保管您的密钥，防止泄露，因为拥有您的 API 密钥和密钥的人可以代表您执行交易。
请求签名: 为了保证请求的完整性和真实性，防止请求被篡改或伪造，每个经过身份验证的请求都需要进行签名。签名是使用您的密钥和请求的具体内容，包括请求方法（例如 GET 或 POST）、请求的 URI、查询参数（如果存在）以及请求体（如果存在），通过特定的哈希算法计算出来的唯一哈希值。BitMEX 服务器会使用相同的算法和您的密钥重新计算签名，并与您提供的签名进行比较，如果两者不匹配，则表明请求可能已被篡改。
速率限制: BitMEX 为了维护系统的稳定性和公平性，防止恶意滥用和过度请求，对 API 请求的速率进行了限制。这意味着在一定的时间窗口内，您可以发送的请求数量是有限的。如果超过了限制，您的请求将被拒绝，并返回一个错误代码。您需要密切注意您的请求频率，避免超过限制。可以通过查看 API 响应头中的相关信息来了解当前的速率限制状态，并据此调整您的请求策略，例如使用队列或延迟机制，以确保您的应用程序能够平稳运行，不会因超出速率限制而被阻止。

WebSocket API 接口

WebSocket API 接口是获取实时市场数据和事件的关键途径。与传统的 REST API 依赖于客户端发起请求不同，WebSocket API 采用持久连接的方式，一旦连接建立，服务器便可以主动推送数据更新，极大地降低了延迟，并提高了数据传输效率。这种双向通信模式特别适合对实时性要求高的应用场景。

WebSocket 连接通常通过特定的 URL 地址建立，例如： wss://example.com/ws 。客户端需要使用支持 WebSocket 协议的库或工具来建立连接，并处理接收到的数据。

频道订阅机制: 为了过滤所需的数据，WebSocket API 通常采用频道订阅机制。客户端可以选择订阅特定的频道，以接收感兴趣的数据类型。例如，订阅 trade 频道可以接收实时发生的交易信息，包括交易价格、交易数量和时间戳。订阅 orderBookL2 频道可以接收订单簿的第二层深度数据，包含多个买单和卖单的价格和数量，用于分析市场深度。其他频道可能包括但不限于： ticker (最新成交价和交易量)、 kline (K线数据，如1分钟、5分钟等周期) 和 depth (订单簿快照)。
数据格式规范: WebSocket API 传输的数据通常采用 JSON 格式。JSON 是一种轻量级的数据交换格式，易于解析和生成。每条消息可能包含不同的字段，具体取决于订阅的频道。例如， trade 频道的数据可能包含 price (价格)、 quantity (数量)、 timestamp (时间戳) 和 side (买/卖方向) 等字段。客户端需要根据 API 文档解析 JSON 数据，并进行相应的处理。
心跳机制和错误处理: 为了保持连接的活跃性，WebSocket API 通常会采用心跳机制。客户端需要定期发送心跳包给服务器，以防止连接超时。客户端还需要处理连接断开、数据错误等异常情况，并进行重连或错误报告。详细的错误码和错误信息通常会在 API 文档中说明。
身份验证和授权: 某些 WebSocket API 需要身份验证和授权才能访问。客户端需要提供 API 密钥或其他凭证才能建立连接和订阅频道。安全的 WebSocket 连接 (WSS) 使用 TLS/SSL 加密来保护数据传输的安全性。

准备工作

在使用 BitMEX API 之前，充分的准备工作至关重要，这将直接影响你与 BitMEX 平台交互的效率和安全性。以下是详细的准备步骤：

注册 BitMEX 账户: 如果你尚未拥有 BitMEX 交易账户，请访问 BitMEX 官方网站并按照注册流程创建一个账户。注册过程中，请务必使用安全强度高的密码，并妥善保管账户信息，开启双重验证(2FA)以增强安全性。
创建 API 密钥: 成功登录 BitMEX 账户后，导航至账户设置中的 API 密钥管理页面。在此页面，你可以创建新的 API 密钥对。创建密钥时，必须精确配置所需的权限，例如交易权限（用于下单、修改订单、取消订单等操作）、提现权限（允许通过 API 发起提现请求，请谨慎授予此权限）、账户信息读取权限（用于查询账户余额、持仓信息等）。 重要安全提示：务必严格控制每个 API 密钥的权限范围，并将其视为高度敏感信息。切勿将你的 API 密钥以任何方式泄露给任何第三方。 定期轮换 API 密钥也是一种良好的安全实践。
选择编程语言和库: 根据你的技术背景和项目需求，选择合适的编程语言（如 Python、JavaScript、Java、Go 等）以及相应的 HTTP 客户端库和 WebSocket 库。
- 对于 Python，常用的 HTTP 客户端库包括 requests 、 aiohttp （适用于异步操作）等。WebSocket 库可以选择 websockets 、 asyncio （配合 websockets 实现异步 WebSocket 连接）。
- 对于 JavaScript (Node.js)，HTTP 客户端库可以选择 axios 、 node-fetch 等。WebSocket 库可以选择 ws 、 socket.io 。在浏览器环境中使用 API 时，请注意跨域资源共享 (CORS) 的问题。
- 对于 Java，HTTP 客户端库可以选择 HttpClient (Apache HttpClient)、 OkHttp 等。WebSocket 库可以选择 javax.websocket (Java WebSocket API)。
选择库时，请关注其文档完整性、社区活跃度、性能表现以及是否支持异步操作。
深入阅读 BitMEX API 文档: BitMEX 官方 API 文档是使用 API 的首要参考资料。务必仔细阅读文档，理解 API 的整体架构、认证机制、请求方法 (GET, POST, PUT, DELETE)、数据格式 (JSON)、参数说明、速率限制、错误代码以及 WebSocket 连接方式。文档通常会提供示例代码，可以帮助你更快地理解和使用 API。特别注意不同 API 端点的权限要求和参数限制。

使用 REST API 的示例 (Python)

以下示例展示了如何使用 Python 的 requests 库与 BitMEX REST API 交互，以获取账户信息。此方法利用 API 密钥和密钥，并通过数字签名确保请求的安全性。

为了成功执行此代码，你需要安装 requests 库。你可以使用 pip 包管理器来安装它： pip install requests 。请确保已从 BitMEX 获得有效的 API 密钥和密钥。

示例代码：


import requests
import hashlib
import hmac
import time
import 

# 替换为你的 API 密钥和密钥
api_key = 'YOUR_API_KEY'
api_secret = 'YOUR_API_SECRET'

# API 请求的端点
endpoint = 'https://www.bitmex.com/api/v1/user/margin'

# 设置请求参数（可以为空，取决于API端点的要求）
params = {}

# 生成时间戳
expires = int(time.time()) + 60  # 设置过期时间为 60 秒后

# 创建签名
def generate_signature(secret, verb, url, expires, data):
    """生成 BitMEX API 签名."""
    url = url.replace('https://www.bitmex.com', '')
    parsed_url = urllib.parse.urlparse(url) # 需要 import urllib.parse
    path = parsed_url.path
    message = verb + path + str(expires) + data
    hmac_obj = hmac.new(secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
    signature = hmac_obj.hexdigest()
    return signature
try:
    import urllib.parse
except ImportError:
    import urllib as urllib_parse

verb = 'GET'
url = endpoint
data = '' # GET 请求通常没有 data, POST 或 PUT 请求才会有
signature = generate_signature(api_secret, verb, url, expires, data)


# 设置请求头
headers = {
    'Content-Type': 'application/',
    'Accept': 'application/',
    'X-Requested-With': 'XMLHttpRequest',
    'api-key': api_key,
    'api-expires': str(expires),
    'api-signature': signature
}

# 发送 GET 请求
response = requests.get(endpoint, headers=headers, params=params)

# 检查响应状态码
if response.status_code == 200:
    # 解析 JSON 响应
    account_info = response.()
    # 打印账户信息
    print(.dumps(account_info, indent=4))  # 格式化输出 JSON
else:
    # 打印错误信息
    print(f"请求失败，状态码: {response.status_code}")
    print(response.text)  # 打印响应内容，便于调试

代码详解：

导入必要的库： requests 用于发送 HTTP 请求, hashlib 和 hmac 用于生成数字签名, time 用于获取时间戳, 用于处理 JSON 数据。
设置 API 密钥和密钥： 将 YOUR_API_KEY 和 YOUR_API_SECRET 替换为你自己的 BitMEX API 密钥和密钥。务必妥善保管你的密钥。
定义 API 端点： endpoint 变量指定了要调用的 BitMEX API 端点。本例中，它指向 /api/v1/user/margin 端点，用于获取账户保证金信息。
设置请求参数： params 字典用于传递 API 请求的参数。根据不同的 API 端点，你需要设置不同的参数。这里设置为空，意味着不传递任何参数。
生成时间戳： expires 变量设置为当前时间加上 60 秒，作为请求的过期时间。这有助于防止重放攻击。
生成签名： generate_signature 函数使用 API 密钥、请求方法、URL、过期时间和请求数据生成数字签名。签名用于验证请求的真实性和完整性。BitMEX 使用 HMAC-SHA256 算法来生成签名。代码里面考虑了python2和python3的urllib包的兼容性.
设置请求头： headers 字典包含了 API 请求的头部信息。其中， api-key 和 api-signature 字段分别包含了你的 API 密钥和签名。 Content-Type 设置为 application/ 表示请求体使用 JSON 格式。 Accept 设置为 application/ 表示期望的响应格式为 JSON。
发送 GET 请求： requests.get() 函数用于发送 GET 请求到指定的 API 端点。请求头和参数都包含在请求中。
处理响应： 首先检查响应的状态码。如果状态码为 200，表示请求成功。然后，使用 response.() 函数解析 JSON 响应，并将账户信息打印出来。如果状态码不是 200，表示请求失败，打印错误信息。

安全提示：

切勿将你的 API 密钥和密钥泄露给他人。
不要将 API 密钥和密钥硬编码到你的代码中。可以使用环境变量或其他安全的方式来存储它们。
定期更换你的 API 密钥和密钥。
限制 API 密钥的权限，只允许它们访问必要的资源。

你的 API 密钥和密钥

要访问 BitMEX API，你需要一对 API 密钥：一个公共 API 密钥 ( api_key ) 和一个私有 API 密钥 ( api_secret )。公共密钥用于标识你的账户，而私有密钥用于对请求进行签名，从而验证请求的来源。

请妥善保管你的私有 API 密钥，切勿泄露给他人。私有密钥泄露可能导致你的账户被盗用。

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

base_url = "https://www.bitmex.com/api/v1" 如果你正在进行测试或者开发，可以使用 BitMEX 测试网，将 base_url 更改为 https://testnet.bitmex.com/api/v1 。测试网提供了一个模拟环境，允许你在不冒真实资金风险的情况下测试你的应用程序。

generate_signature 函数用于为你的 BitMEX API 请求生成身份验证签名。此签名对于确保请求的完整性和真实性至关重要。它使用你的私有 API 密钥、HTTP 方法（例如 GET 或 POST）、API 路径、过期时间戳和请求数据生成一个唯一的哈希值。

def generate_signature(method, path, expires, data):
"""Generates an authentication signature for the BitMEX API request."""
message = method + path + str(expires) + data
signature = hmac.new(
api_secret.encode('utf-8'),
message.encode('utf-8'),
digestmod=hashlib.sha256).hexdigest()
return signature

get_account_info 函数演示了如何使用 BitMEX API 获取账户信息。它构造了一个带有必要标头的 GET 请求，包括 API 密钥、过期时间和签名。然后，它向 BitMEX API 发送请求，并打印响应。可以使用其他的http库，例如`aiohttp`、`urllib3`等。

def get_account_info():
"""Gets account information from the BitMEX API."""
method = "GET"
path = "/user/wallet"
expires = int(time.time()) + 60 # 60 seconds from now
data = ""

signature = generate_signature(method, path, expires, data)

headers = {
    "api-key": api_key,
    "api-expires": str(expires),
    "api-signature": signature
}

url = base_url + path
response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(.dumps(response.(), indent=4))
else:
    print(f"Error: {response.status_code} - {response.text}")

API 密钥的过期时间戳 ( api-expires ) 必须设置为未来的某个时间点，通常在当前时间后 60 秒左右。这有助于防止重放攻击。BitMEX 服务器会验证请求是否在过期时间之前收到。如果服务器接收到过期时间已过的请求，则会拒绝该请求。

在代码的 if __name__ == "__main__": 块确保 get_account_info 函数仅在脚本作为主程序运行时才被调用，而不是作为模块导入时被调用。这是一个常见的 Python 实践，用于组织和执行代码。

if __name__ == "__main__":
get_account_info()

代码解释:

导入必要的库: 脚本起始于导入执行过程中必需的 Python 库。 requests 库被用于发起 HTTP 请求，这是与 BitMEX 服务器进行通信的基础。 hashlib 和 hmac 库共同负责生成加密签名，确保请求的安全性。 time 库用于获取当前时间戳，而库则用于处理从 BitMEX API 返回的 JSON 格式数据，方便提取和使用数据。
设置 API 密钥和密钥: 为了安全地访问 BitMEX API，你需要将占位符 YOUR_API_KEY 和 YOUR_API_SECRET 替换为你在 BitMEX 平台上获得的真实 API 密钥和密钥。API 密钥用于标识你的身份，而密钥则用于生成请求签名，防止未经授权的访问。 务必妥善保管你的 API 密钥和密钥，避免泄露。
generate_signature 函数: 此函数的关键作用是根据请求的各个组成部分（HTTP 请求方法，API 路径，请求过期时间以及请求数据）生成唯一的数字签名。BitMEX 使用 HMAC-SHA256 算法来确保签名的安全性。该算法使用你的 API 密钥作为密钥，对请求的规范化表示进行哈希运算，从而生成签名。这个签名附加到每个 API 请求中，BitMEX 使用它来验证请求的来源和完整性，防止中间人攻击和数据篡改。
get_account_info 函数:
- 定义请求参数: 函数明确定义了本次 API 调用的所有关键参数。请求方法被设置为 GET ，表明要从服务器获取数据。API 路径被设置为 /user/wallet ，这是 BitMEX API 中用于获取用户钱包信息的特定端点。请求过期时间被设置为当前时间加上 60 秒，这意味着该请求在生成后的 60 秒内有效。如果请求在过期后到达服务器，将会被拒绝。请求数据在此处为空字符串，因为获取钱包信息的 GET 请求通常不需要发送额外的数据。
- 生成签名: 定义好请求参数后，函数调用 generate_signature 函数，使用前面定义的参数以及你的 API 密钥和密钥来生成请求的数字签名。
- 创建请求头: 为了将 API 密钥、过期时间和签名传递给 BitMEX 服务器，函数创建了一个包含这些信息的 HTTP 请求头。请求头中包含了 api-key 字段，其值为你的 API 密钥； api-expires 字段，其值为请求的过期时间；以及 api-signature 字段，其值为生成的数字签名。
- 发送 GET 请求: 函数使用 requests.get 函数，将 API 路径和包含身份验证信息的请求头发送到 BitMEX 服务器。
- 处理响应: 在接收到服务器的响应后，函数首先检查响应的状态码。HTTP 状态码 200 表示请求已成功处理。如果状态码为 200，则函数使用 response.() 方法将响应内容解析为 JSON 格式，并打印返回的 JSON 数据。如果状态码不是 200，则表明请求失败，函数会打印包含状态码和响应内容的错误信息，帮助你诊断问题。
if __name__ == "__main__": 块: 这是一种常见的 Python 编程实践。 if __name__ == "__main__": 这行代码确保 get_account_info 函数只在脚本作为主程序直接执行时才会被调用，而不是在被作为模块导入到其他脚本中时执行。这允许你创建可重用的模块，同时又能方便地执行特定的功能。

使用 WebSocket API 的示例 (Python)

以下示例展示了如何使用 Python 的 websockets 库连接到 BitMEX WebSocket API，并订阅和接收实时交易数据。此代码段重点在于建立连接、发送订阅请求以及处理接收到的消息。

为了运行此示例，你需要安装 websockets 库。可以使用 pip 进行安装： pip install websockets 。还需安装库

import asyncio
import websockets
import 

async def subscribe_trades():
    """订阅交易频道并打印接收到的消息。"""
    uri = "wss://www.bitmex.com/realtime"  # 如果使用测试网，请替换为 wss://testnet.bitmex.com/realtime
    # BitMEX 的 WebSocket API 端点。主网使用 wss://www.bitmex.com/realtime，测试网使用 wss://testnet.bitmex.com/realtime

    async with websockets.connect(uri) as websocket:
        # 连接到 WebSocket 服务器。使用 'async with' 确保连接在使用后正确关闭。
        # 订阅 XBTUSD 交易频道的请求消息。
        subscribe_message = {
            "op": "subscribe",
            "args": ["trade:XBTUSD"]  # 订阅 XBTUSD 的交易数据。可以根据需要修改此参数以订阅其他合约。
        }
        await websocket.send(.dumps(subscribe_message))
        # 将订阅消息以 JSON 格式发送到 WebSocket 服务器。'.dumps()' 用于将 Python 字典转换为 JSON 字符串。

        while True:
            try:
                message = await websocket.recv()
                # 接收来自 WebSocket 服务器的消息。'await websocket.recv()' 会挂起直到接收到消息。
                print(.dumps(.loads(message), indent=4))
                # 将接收到的 JSON 消息格式化并打印到控制台。'.loads()' 将 JSON 字符串转换为 Python 字典，'.dumps()' 再次将其转换回 JSON 字符串，但带有缩进，以便于阅读。
            except websockets.exceptions.ConnectionClosed as e:
                print(f"连接已关闭: {e}")
                # 处理 WebSocket 连接关闭的情况。打印错误消息并退出循环。
                break
            except Exception as e:
                print(f"错误: {e}")
                # 处理其他可能发生的异常。打印错误消息并退出循环。
                break

此部分代码用于运行异步函数 subscribe_trades() 。 asyncio.get_event_loop() 获取当前事件循环， run_until_complete() 运行给定的协程直到完成。

if __name__ == "__main__":
    asyncio.get_event_loop().run_until_complete(subscribe_trades())

重要提示：

API 密钥： 此示例不包括身份验证。如果要访问需要身份验证的频道（例如，您的帐户数据），则需要在订阅消息中包含您的 API 密钥和签名。请参阅 BitMEX API 文档以获取有关身份验证的更多信息。
错误处理： 此示例包含基本的错误处理，但可能需要根据你的需要进行改进。例如，你可能需要实现重连逻辑，或者记录错误到文件。
数据处理： 此示例只是简单地打印接收到的消息。在实际应用中，你需要解析这些消息并进行相应的处理。
其他订阅： 除了 trade:XBTUSD 之外，你还可以订阅其他频道，例如 quote:XBTUSD （报价数据）或 orderBookL2:XBTUSD （深度数据）。请参阅 BitMEX API 文档以获取可用频道的完整列表。
测试网： 在生产环境中使用 API 之前，强烈建议先在测试网上进行测试。

代码解释:

导入必要的库: 导入 asyncio 库，它为编写并发代码提供了基础架构，使用 async/await 语法实现异步编程。导入 websockets 库，用于创建 WebSocket 客户端和服务器，简化了 WebSocket 连接的建立、数据发送和接收。导入库，用于在 Python 对象和 JSON（JavaScript Object Notation）字符串之间进行转换，便于处理来自 WebSocket 连接的结构化数据。
subscribe_trades 函数:
- 定义 WebSocket URI (Uniform Resource Identifier)。URI 指定了 WebSocket 服务器的地址。如果需要连接到测试网络 (testnet) 而不是主网络 (mainnet)，则使用相应的测试网 URI。
- 使用 websockets.connect 函数异步地建立与 WebSocket 服务器的连接。 async with 语句创建一个异步上下文管理器，确保在代码块执行完毕后，即使发生异常，WebSocket 连接也会被正确关闭，释放资源。
- 创建订阅消息，该消息以 JSON 格式构造，用于告知 WebSocket 服务器客户端希望接收哪些数据。 op 字段设置为 "subscribe"，表示这是一个订阅操作。 args 字段是一个列表，包含要订阅的频道。这里订阅的是 trade:XBTUSD 频道，意味着客户端希望接收 XBTUSD 交易对的实时成交数据。不同的交易所和 API 可能有不同的频道命名规范。
- 使用 websocket.send 函数将订阅消息发送到 WebSocket 服务器。该函数将 Python 对象序列化为 JSON 字符串并通过 WebSocket 连接发送。
- 进入无限循环，持续监听并接收来自服务器的消息。这个循环会一直运行，直到连接中断或发生错误。
- 使用 websocket.recv 函数异步地接收来自服务器的消息。该函数会暂停程序的执行，直到接收到一条新的消息。接收到的消息通常是一个 JSON 格式的字符串，包含实时交易数据或其他相关信息。
- 使用 .loads 函数将接收到的 JSON 字符串解析为 Python 字典或列表等对象，方便后续处理和分析。
- 使用 .dumps 函数将 Python 对象（例如解析后的交易数据）格式化为 JSON 字符串，并使用 print 函数打印出来。 indent=4 参数用于美化输出，使 JSON 数据更易于阅读。开发者可以根据需要修改输出格式或将数据存储到数据库或文件中。
- 使用 try...except 块来捕获和处理可能出现的异常情况。例如，如果 WebSocket 连接意外关闭（ websockets.exceptions.ConnectionClosedError ）或发生网络错误， except 块中的代码将被执行，打印错误信息，并可以选择重新连接或安全地退出程序。良好的错误处理机制可以提高程序的健壮性和稳定性。
if __name__ == "__main__": 块: 这个条件语句用于判断当前脚本是否作为主程序直接运行。如果脚本是被直接执行的（而不是被其他模块导入），则 __name__ 变量的值为 "__main__" ， if 块中的代码将被执行。这允许开发者将代码组织成可重用的模块，同时也能方便地执行特定的任务。 asyncio.get_event_loop().run_until_complete(subscribe_trades()) 用于获取当前事件循环并运行 subscribe_trades 异步函数，直到它执行完成。事件循环是 asyncio 的核心，负责调度和执行异步任务。

错误处理

在使用 BitMEX API 进行交易和数据获取时，可能会遇到各种类型的错误。这些错误可能是由客户端问题、网络问题或服务器端问题引起的。理解这些错误信息并采取适当的处理措施是构建稳定可靠的交易应用的关键。

400 Bad Request (错误请求): 此错误表明发送到 BitMEX 服务器的请求格式存在问题。最常见的原因包括：
- 参数错误: 请求中包含了无效的或格式错误的参数。仔细检查请求参数的名称、类型和值是否符合 API 文档的规定。例如，确保数值参数是数字类型，日期参数是正确的日期格式。
- 缺少必需参数: 请求缺少了 API 所必需的参数。参考 API 文档确认所有必需参数都已包含在请求中。
- JSON 格式错误: 如果请求体是 JSON 格式，请确保 JSON 格式正确无误，例如括号是否匹配，键值对是否完整。
处理方法：仔细检查请求的各个部分，比对 API 文档，确保所有参数都正确无误。使用 API 客户端或调试工具可以帮助你检查发送到服务器的实际请求内容。
401 Unauthorized (未授权): 此错误表明你的身份验证信息无效，无法访问 BitMEX API。常见原因包括：
- API 密钥错误: API 密钥或密钥不正确。请确保你使用的 API 密钥和密钥是从 BitMEX 正确生成的，并且没有被泄露。
- 签名错误: 请求的签名不正确。签名是使用你的密钥对请求数据进行加密生成的，用于验证请求的完整性和身份。仔细检查你的签名算法是否正确，以及用于签名的参数是否正确。
- 权限不足: 你的 API 密钥可能没有足够的权限执行该操作。例如，你的密钥可能只具有读取权限，而你尝试执行一个需要写入权限的操作。
- IP 限制: 你的API密钥可能设置了IP限制，而当前请求的IP不在白名单中。
处理方法：重新检查 API 密钥和密钥，确保它们正确无误。仔细检查签名算法的实现，并与 BitMEX 提供的示例代码进行比较。确保你的 API 密钥具有执行该操作所需的权限。检查你的IP是否在白名单中。
429 Too Many Requests (请求过多): 此错误表明你已经超过了 BitMEX API 的速率限制。BitMEX 对 API 请求的频率进行了限制，以防止滥用和保护服务器的稳定。
- 超出每分钟请求限制: 你在短时间内发送了过多的请求。BitMEX API 对不同的端点可能有不同的速率限制。
处理方法：减少你的请求频率。实现速率限制逻辑，例如使用延迟或队列来控制请求的发送速度。查看 API 文档了解具体的速率限制规则。使用 WebSocket API 可以减少对 REST API 的调用，从而降低达到速率限制的风险。
500 Internal Server Error (服务器内部错误): 此错误表明 BitMEX 服务器遇到了内部错误，无法处理你的请求。这通常是服务器端的问题，与你的请求无关。处理方法：稍后重试。如果问题持续存在，请联系 BitMEX 的技术支持。
503 Service Unavailable (服务不可用): 此错误表明BitMEX服务器当前无法处理请求，通常是由于服务器维护或过载。处理方法：稍后重试。定期检查BitMEX官方公告，了解服务器维护计划。
403 Forbidden (禁止访问): 此错误表明服务器理解请求，但拒绝授权。处理方法：检查你的API密钥是否被禁用，或你的账户是否受到限制。联系BitMEX技术支持获取更多信息。

当遇到 API 错误时，请务必仔细检查 API 返回的错误信息。API 返回的错误信息通常包含错误代码、错误消息和详细的错误描述。根据这些信息，你可以快速定位问题并采取相应的解决措施。同时，建议记录 API 请求和响应日志，以便于调试和排查问题。使用专门的API客户端库可以简化错误处理流程，并提供更详细的错误信息。

API 文档查询

BitMEX 官方 API 文档是学习和使用 BitMEX API 的首要且最重要的资源。通过官方文档，开发者能够全面了解 API 的功能，并高效地集成到他们的应用程序中。你可以在 BitMEX 官网找到最新、最权威的 API 文档，网址通常位于开发者或 API 专区。文档中详细记载了所有可用的 API 端点（endpoints）、每个端点所需的请求参数（request parameters）、服务器返回的数据格式（response data format），以及可能出现的错误代码（error codes）及其详细含义。每个端点都附带了清晰的描述，包括其功能、使用方法和示例。深入、仔细地阅读 API 文档是理解 API 工作原理、掌握其使用方式的关键步骤，并能有效避免由于参数错误、权限问题或请求格式不规范等原因导致的常见错误。理解请求的频率限制（rate limits）和身份验证机制（authentication schemes）对于构建稳定可靠的应用程序至关重要。建议开发者在开始编写代码之前，务必查阅相关文档，确保正确理解和使用 BitMEX API。

# 上一篇：MEXC交易所购买Celo(CELO)完全指南：新手也能轻松上手

# 下一篇：币安与Upbit加密货币借贷差异与特色分析