BitMEX订单查询教程：从入门到精通，掌握交易技巧

• getActiveOrders(): 获取所有活动订单。
• getOrder(): 根据订单 ID 获取特定订单的信息。
• getOrders(): 根据条件查询订单，例如订单状态、时间范围等。

from bitmex import bitmex

替换为你的 API 密钥和密钥

在与 BitMEX API 交互之前，必须配置API密钥和密钥。请务必妥善保管这些凭证，避免泄露给未经授权的第三方，以确保账户安全。以下代码片段展示了如何设置 api_key 和 api_secret 变量，它们将用于后续的身份验证。

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

请将 "YOUR_API_KEY" 替换为您的实际 API 密钥，并将 "YOUR_API_SECRET" 替换为您的实际密钥。这两个值都可以在 BitMEX 网站的 API 密钥管理页面找到。完成替换后，您就可以使用这些密钥初始化 BitMEX 客户端，进行交易和数据查询。

使用 bitmex 模块初始化客户端，建立与 BitMEX 交易平台的连接。 test=False 参数表示连接到真实的生产环境，而不是测试网络。使用您之前配置的 api_key 和 api_secret 进行身份验证，确保您的客户端可以安全地访问您的 BitMEX 账户。以下代码展示了如何使用 bitmex 模块创建一个连接到真实 BitMEX 交易所的客户端实例：

client = bitmex(test=False, api_key=api_key, api_secret=api_secret)

获取所有活动订单

通过Bybit API，可以便捷地检索当前处于活动状态的订单。以下代码展示了如何使用Python SDK实现这一功能。该方法通过调用 client.Order.Order_getOrders() 函数，并设置过滤器来获取指定状态的订单信息。

orders = client.Order.Order_getOrders(filter='{"orderStatus": "New"}').result()

上述代码中， client.Order.Order_getOrders() 方法被调用，并传递了一个JSON格式的字符串作为过滤器参数。 filter='{"orderStatus": "New"}' 表示我们只希望获取状态为"New"的订单。 .result() 用于提取API调用的结果数据。 请注意，根据Bybit API的约定，"New"状态通常表示订单已提交但尚未完全成交或取消。

获取到订单列表后，可以使用循环来遍历每个订单的详细信息。

for order in orders[0]: print(order)

这段代码遍历 orders[0] 列表中的每个订单对象，并使用 print(order) 将订单的详细信息输出到控制台。每个订单对象包含诸如订单ID、交易对、订单类型、价格、数量等关键信息。通过分析这些信息，可以更好地监控和管理您的交易活动。

注意事项：

• 确保您已正确安装Bybit Python SDK，并配置好API密钥和私钥。
• orderStatus 参数可以接受不同的值，例如"Filled"（已成交）、"PartiallyFilled"（部分成交）、"Cancelled"（已取消）等，以获取不同状态的订单。具体取值请参考Bybit API官方文档。
• API调用可能会受到速率限制，请合理控制调用频率，避免触发限制。
• 为了更方便地处理订单数据，可以将其存储到数据库或进行其他自定义处理。

根据订单 ID 获取订单信息

要查询特定订单的信息，你需要使用订单 ID 作为标识符。以下代码展示了如何通过订单 ID 从交易平台 API 获取订单详细信息。请确保你已经正确配置了 API 客户端，并且拥有足够的权限进行订单查询。

order_id = "YOUR_ORDER_ID" # 替换为你要查询的订单 ID

在上述代码片段中， YOUR_ORDER_ID 应该替换为你想要查询的具体订单的 ID。订单 ID 通常由交易所平台生成，并与每个订单唯一对应。

order = client.Order.Order_get(orderID=order_id).result()

这行代码使用 client.Order.Order_get 方法，传入 orderID 参数（其值为之前定义的 order_id ），向 API 发起请求。 .result() 方法用于获取 API 调用的结果。请注意，不同的 API 客户端库可能使用不同的方式来处理 API 响应，例如使用回调函数或 Promise。你需要根据你所使用的库的文档进行相应的调整。

print(order)

获取到订单信息后，可以使用 print(order) 将订单数据打印到控制台。订单数据通常以 JSON 格式返回，包含订单的各种属性，例如订单类型、价格、数量、状态、创建时间等。根据实际情况，你可能需要解析 JSON 数据，并提取你所关心的特定字段。

请注意，以上代码仅为示例，你需要根据实际使用的交易平台 API 和客户端库进行修改。务必查阅相关文档，了解 API 的具体用法、参数要求和错误处理机制。同时，要注意保护你的 API 密钥，避免泄露，并遵守交易平台的 API 使用规则。

2.3. 使用 CSV 导出功能查询:

BitMEX 提供便捷的 CSV 导出功能，允许用户将历史订单数据以逗号分隔值（CSV）格式导出。此功能尤其适用于需要对大量历史交易数据进行深度分析、审计或长期记录的用户，方便他们在本地进行数据处理和分析，而无需依赖 BitMEX 平台进行查询和筛选。

1. 登录 BitMEX 账户： 使用您的有效凭据（包括用户名/邮箱和密码，以及可能的双因素认证）登录您的 BitMEX 交易账户。这是访问账户报表和导出数据的首要步骤。
2. 进入账户报表页面： 成功登录后，导航至 BitMEX 平台上的“账户报表”或类似名称的页面。该页面通常位于用户个人资料或账户设置区域，专门用于显示和管理用户的交易历史和账户活动。
3. 选择需要导出的订单类型： 在报表页面，根据您的分析需求，选择需要导出的订单类型。BitMEX 可能会提供多种订单类型选项，例如：已成交订单（Executed Orders）、挂单（Open Orders）、已取消订单（Cancelled Orders）等。选择正确的订单类型对于获取目标数据至关重要。
4. 设置时间范围： 指定您希望导出的订单数据的时间范围。您可以选择预设的时间段（如过去 24 小时、过去 7 天、过去 30 天），或自定义开始和结束日期。合理设置时间范围可以有效控制导出的数据量，提高数据处理效率。请注意，BitMEX 可能会对单次导出的数据量或时间跨度有限制。
5. 点击“导出 CSV”按钮： 完成以上设置后，点击页面上的“导出 CSV”或类似名称的按钮。BitMEX 平台将开始生成包含您所选订单数据的 CSV 文件，并将其提供给您下载。下载速度取决于数据量的大小。

导出的 CSV 文件包含了订单的详尽信息，涵盖了订单生命周期的各个关键环节，例如：唯一的订单 ID (Order ID)、下单的确切时间 (Order Time)、实际成交的时间 (Execution Time)、最终成交的价格 (Execution Price)、成交的数量 (Quantity)、以及平台收取的手续费 (Commission Fees) 等。这些字段提供了对每笔交易的全面记录。您可以方便地使用 Microsoft Excel、Google Sheets、Numbers 或其他电子表格软件打开该 CSV 文件，并利用这些软件强大的数据处理和分析功能，进行诸如趋势分析、风险评估、绩效评估等操作。还可以使用 Python 等编程语言对 CSV 文件进行更复杂的数据分析和可视化操作。

3. 订单查询常见问题及解决方法

在数字资产交易平台查询订单时，用户可能会遇到各种问题。了解并掌握这些常见问题的解决方法至关重要，可以帮助用户更高效地管理其交易活动。以下详细列出了一些常见问题及对应的解决方案：

• 问题：订单信息未显示或加载缓慢

  原因：可能由于网络连接不稳定、服务器延迟或浏览器缓存问题导致。

  解决方法：

  • 检查网络连接是否正常。尝试刷新页面或重启浏览器。
  • 清除浏览器缓存和Cookie，然后重新登录交易平台。
  • 避开交易高峰期，此时服务器负载可能较高。
  • 如果问题持续存在，请联系平台客服寻求帮助。
• 问题：无法找到特定时间段的订单

  原因：可能是筛选条件设置不正确，或查询的时间范围超出平台记录范围。

  解决方法：

  • 仔细检查日期和时间范围是否正确设置，起始日期是否早于结束日期。
  • 确认交易对选择正确。
  • 部分平台可能只保存一定时间内的交易记录。如果交易时间过早，可能无法查询到。
  • 尝试扩大时间范围进行搜索。
• 问题：订单状态显示不明确

  原因：不同的订单状态（如“待成交”、“部分成交”、“已成交”、“已撤销”）可能没有清晰的解释说明。

  解决方法：

  • 查阅平台的帮助中心或FAQ，通常会有关于订单状态的详细解释。
  • 联系平台客服，获取关于特定订单状态的解释。
  • 注意观察订单的成交数量和成交价格，结合订单类型（限价单、市价单等）判断订单状态。
• 问题：订单成交价格与预期不符

  原因：市价单的价格会随市场波动而变化，限价单可能未能完全按照指定价格成交。

  解决方法：

  • 如果是市价单，其成交价格会受到当时市场深度和波动的影响。
  • 如果是限价单，且市场价格未达到或超过设定的价格，订单可能不会完全成交，或仅部分成交。
  • 查看成交明细，确认实际成交价格和数量。
  • 了解平台的交易规则，特别是关于市价单和限价单的执行机制。
• 问题：订单查询结果与实际交易记录不符

  原因：数据同步延迟、API接口问题或者极少数情况下平台数据错误都可能导致此类问题。

  解决方法：

  • 稍等片刻，等待数据同步完成。
  • 如果通过API查询订单，请检查API密钥和权限是否正确配置。
  • 如果确认存在数据错误，立即联系平台客服，提供详细的订单信息和交易记录截图。

无法找到特定订单:

• 订单号无效或不存在： 您输入的订单号可能不正确，或者该订单尚未在我们的系统中创建。请仔细检查您输入的订单号，并确保其与您收到的确认邮件或交易记录中的订单号完全一致。
• 订单状态异常： 即使订单号正确，该订单的状态可能处于非活动状态，例如已取消、已退款或已完成。请确认您的订单是否处于可查询状态。
• 查询条件不匹配： 您可能使用了错误的查询条件，例如错误的日期范围、错误的交易金额或其他错误的信息。请检查您提供的所有查询信息，确保其与订单信息相符。
• 系统维护或故障： 我们的系统可能正在进行维护或遭遇故障，导致您无法找到订单。请稍后再试，或者联系我们的客服团队寻求帮助。我们将尽快解决问题，并恢复系统正常运行。
• 权限不足： 您可能没有查看该订单的权限。请确保您使用正确的账户登录，并且该账户有权访问您要查找的订单信息。

API 查询失败:

• API查询操作未能成功完成，这表明在尝试从特定应用程序编程接口 (API) 获取数据或执行功能时遇到了问题。 可能的原因涵盖网络连接中断、API服务器不可用、请求格式不正确、身份验证失败、速率限制超出或API返回错误响应。排查此类问题需要详细检查API请求的参数、验证网络连接状态、确认API密钥的有效性与权限，并分析API服务器返回的错误信息，以便精确定位并解决根本原因。检查API文档以确保请求符合其规范至关重要。

导出的 CSV 文件数据不完整:

• 数据截断原因分析： 当导出的 CSV 文件包含大量数据或包含特殊字符（例如逗号、引号、换行符）时，部分软件或在线平台可能会错误地解析这些数据，导致数据被截断，从而造成数据不完整。软件本身的文件大小限制也可能导致导出数据不完整。某些电子表格软件或数据处理工具对 CSV 文件的大小存在限制，超过限制的部分数据可能无法导出。内存不足或程序运行错误也可能导致导出过程提前终止，造成数据丢失或不完整。