欧易API：手把手教你用Python玩转交易（2024最新）

25 2025-03-05 17:29:13

欧易交易所API接口使用说明

概述

欧易（OKX）交易所提供了一套完善的应用程序编程接口（API），赋能开发者通过程序化的方式无缝访问和管理其在欧易平台上的账户。这包括检索账户信息、监控市场行情数据、自动化交易执行，以及管理资金划转等操作。本文档旨在为开发者提供欧易API接口的详细使用说明和技术指南，旨在帮助他们更深入地理解和有效地利用这些接口，从而构建出高效、智能的交易系统和应用程序。

通过欧易API，开发者可以创建定制化的交易策略、集成市场数据到现有应用程序、自动化交易流程，以及开发其他与加密货币相关的创新应用。 API 接口提供了多种编程语言的支持，包括但不限于 Python、Java 和 JavaScript，允许开发者选择最适合其技术栈的工具和框架。安全性和稳定性是欧易API设计中的首要考虑因素，使用者需要通过身份验证和授权才能访问 API 功能。欧易提供详细的 API 文档、示例代码和技术支持，以帮助开发者快速上手并解决遇到的问题。

本文档将涵盖 API 的身份验证、请求格式、响应处理、错误代码以及各种交易和数据检索接口的详细信息。开发者可以通过阅读本文档，掌握欧易API的使用方法，从而在加密货币交易领域获得更大的优势。

API 认证

在使用欧易API之前，您需要进行身份认证，确保您的访问权限。认证过程的核心在于生成和管理API密钥对，包括API密钥（API Key）和密钥（Secret Key）。API Key用于标识您的身份，Secret Key则用于生成签名，验证请求的合法性。妥善保管这些密钥至关重要，因为它们是访问您账户的关键凭证。

获取API密钥：
- 登录您的欧易账户。
- 然后，导航至“API管理”页面。该页面的具体名称可能因欧易平台的版本更新而略有变化，但通常位于账户设置或安全设置的相关选项中。
- 点击“创建API密钥”按钮，开始创建新的API密钥。在创建过程中，您可以为每个密钥设置特定的权限，例如只读、交易、提币等。这些权限控制了密钥可以访问的API端点和执行的操作，有助于提高账户的安全性。务必根据您的实际需求分配最小权限原则。
- 成功创建后，系统将生成API Key和Secret Key。 请务必妥善保管您的Secret Key，切勿以任何方式泄露给他人。 Secret Key用于生成签名，一旦泄露，您的账户可能面临风险。强烈建议启用二次验证（2FA）以增加安全性。
- 建议将API Key和Secret Key存储在安全的地方，例如使用密码管理器进行加密存储。
API 签名：

欧易API采用严格的签名机制，确保每个API请求的完整性和真实性。签名是对请求参数和您的Secret Key进行特定算法运算的结果，用于验证请求是否被篡改以及请求的来源是否合法。常用的哈希算法是HMAC-SHA256，这是一种安全的哈希算法，能够有效地防止伪造请求。
- 签名步骤：
  - 准备请求参数： 收集所有需要发送到API的请求参数，包括查询参数（query parameters）和请求体（request body）中的参数。
  - 参数排序： 将所有请求参数按照字母顺序进行排序（区分大小写），这是为了保证签名的一致性。注意：排序时，包括时间戳参数，但 不包括 签名参数（通常命名为 sign 或 signature ）。
  - 参数拼接： 将排序后的参数以键值对的形式拼接成一个字符串。通常，键值对之间使用 & 符号连接，键和值之间使用 = 符号连接。例如： param1=value1&param2=value2&timestamp=1678886400 。
  - HMAC-SHA256哈希运算： 使用您的Secret Key作为密钥，对拼接后的字符串进行HMAC-SHA256哈希运算。不同的编程语言提供了不同的HMAC-SHA256实现方式。
  - 编码转换： 将哈希运算的结果进行Base64编码，并转换为大写字母。
  - 添加签名到请求头： 将生成的签名添加到请求头中，键名为 OK-ACCESS-SIGN 。还需要添加以下请求头： OK-ACCESS-KEY (API Key), OK-ACCESS-TIMESTAMP (时间戳), 和 OK-ACCESS-PASSPHRASE (如果设置了API Passphrase)。
- 示例（Python）：
  
  以下Python代码演示了如何生成欧易API请求签名。请注意，这只是一个示例，您需要根据您的实际需求进行修改和调整。
  
  import hmac import hashlib import base64 import time import urllib.parse import requests
  
  def generate_signature(timestamp, method, request_path, body, secret_key): message = timestamp + method + request_path + body mac = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256) d = mac.digest() return base64.b64encode(d).decode()
  
  # 示例用法 api_key = "YOUR_API_KEY" # 替换为你的API Key secret_key = "YOUR_SECRET_KEY" # 替换为你的Secret Key api_passphrase = "YOUR_API_PASSPHRASE" # 替换为你的API Passphrase (如果设置了) timestamp = str(int(time.time())) method = "GET" request_path = "/api/v5/account/balance" # 例如，获取账户余额的API端点 body = "" # GET 请求通常没有body, POST请求则需要提供JSON格式的body signature = generate_signature(timestamp, method, request_path, body, secret_key)
  
  headers = { "OK-ACCESS-KEY": api_key, "OK-ACCESS-SIGN": signature, "OK-ACCESS-TIMESTAMP": timestamp, "OK-ACCESS-PASSPHRASE": api_passphrase, "Content-Type": "application/" # 大部分API需要指定Content-Type }
  
  url = "https://www.okx.com" + request_path # 欧易API的基础URL response = requests.get(url, headers=headers)
  
  print(response.status_code) print(response.())
  
  注意事项：
  - 请替换示例代码中的 YOUR_API_KEY , YOUR_SECRET_KEY , 和 YOUR_API_PASSPHRASE 为您的实际值。
  - 时间戳必须是当前时间，且误差不应超过几秒钟，否则请求可能会被拒绝。
  - 不同的API端点可能需要不同的参数和请求头，请参考欧易API的官方文档。
  - 对于POST请求， body 应该是JSON格式的字符串。
  - 在生产环境中，请确保您的代码能够正确处理异常情况。

示例参数

在构建加密货币交易API请求时，需要提供必要的参数以进行身份验证和数据交互。以下是一些关键参数的示例，务必妥善保管您的API密钥和私钥。

api_key = "YOUR_API_KEY"

api_key 是您的应用程序的唯一标识符，由交易所提供。它是访问API的凭证，类似于用户名。请务必替换 "YOUR_API_KEY" 为您实际的API密钥。

secret_key = "YOUR_SECRET_KEY"

secret_key 也被称为私钥，是与API密钥配对的密钥，用于对请求进行签名，确保请求的完整性和来源真实性。切勿与他人分享您的 secret_key ，并将其安全地存储在服务器端或本地安全环境中。请务必替换 "YOUR_SECRET_KEY" 为您实际的私钥。

timestamp = str(int(time.time()))

timestamp 表示请求发起的时间戳，通常以Unix时间格式（自1970年1月1日以来经过的秒数）表示。为了防止重放攻击，交易所通常会验证时间戳的有效性，例如，确保其在允许的时间窗口内。 time.time() 函数获取当前时间， int() 将其转换为整数， str() 将其转换为字符串，以便在请求中使用。

method = "GET"

method 指定HTTP请求方法，常用的方法包括 GET 、 POST 、 PUT 和 DELETE 。 GET 方法用于从服务器获取数据， POST 方法用于向服务器提交数据， PUT 方法用于更新服务器上的资源， DELETE 方法用于删除服务器上的资源。根据API文档的要求选择合适的HTTP方法。

request_path = "/api/v5/account/balance"

request_path 定义了API的端点或路径，用于指定要访问的具体资源或功能。例如， "/api/v5/account/balance" 可能用于获取账户余额信息。务必根据API文档提供的端点进行设置，不同的API功能对应不同的路径。

body = ""

body 包含要发送到服务器的数据。对于 GET 请求，通常没有请求体，因此 body 设置为空字符串。对于 POST 、 PUT 和 DELETE 请求， body 通常包含JSON格式的数据，用于传递请求参数或更新数据。请根据API文档的要求构建请求体。

生成签名

在加密货币交易和API交互中，生成签名是验证请求完整性和身份的关键步骤。签名确保数据在传输过程中未被篡改，并且请求确实来自授权方。

签名生成过程通常涉及以下元素：

Timestamp (时间戳): 表示请求创建的时间，用于防止重放攻击。通常是一个Unix时间戳，记录了自Unix纪元（1970年1月1日 00:00:00 UTC）以来经过的秒数。
Method (方法): HTTP请求方法，例如 GET 、 POST 、 PUT 或 DELETE 。用于指示服务器执行的操作。
Request Path (请求路径): API的端点URL，不包含域名或查询参数。例如： /api/v1/orders 。
Body (请求体): 请求中包含的数据，通常为JSON格式。如果请求是 GET 请求，可能为空。
Secret Key (密钥): 只有客户端和服务器知道的私密密钥。用于创建签名的加密密钥，绝对不能泄露。

签名通常使用加密哈希函数（如HMAC-SHA256）生成。其一般形式如下：

signature = generate_signature(timestamp, method, request_path, body, secret_key)

其中， generate_signature 函数代表签名算法的实现。该函数的具体实现细节根据不同的交易所或API提供商而有所不同，但通常遵循以下步骤：

构建签名字符串: 将 timestamp 、 method 、 request_path 和 body 按照特定规则连接成一个字符串。连接顺序和格式至关重要，必须与服务器端一致。
使用密钥进行哈希: 使用 secret_key 作为密钥，对签名字符串进行哈希运算（例如，使用HMAC-SHA256算法）。
编码签名: 将哈希结果进行编码，通常使用Base64编码，使其成为一个可安全传输的字符串。

生成的 signature 将作为请求头或请求参数的一部分发送到服务器。服务器使用相同的算法和密钥验证签名，以确保请求的真实性和完整性。

构造请求头

在使用Okex API进行身份验证和数据交互时，构造正确的请求头至关重要。请求头中包含API密钥、签名、时间戳和Passphrase（如果已设置），用于验证请求的合法性和安全性。

以下是一个示例请求头，展示了如何设置这些关键参数：


headers = {
    'OK-ACCESS-KEY': api_key,
    'OK-ACCESS-SIGN': signature,
    'OK-ACCESS-TIMESTAMP': timestamp,
    'OK-ACCESS-PASSPHRASE': "YOUR_PASSPHRASE"  # 如果您启用了Passphrase
}

参数说明：

OK-ACCESS-KEY: 您的API密钥。这相当于您的用户名，用于标识您的身份。请务必妥善保管，不要泄露给他人。
OK-ACCESS-SIGN: 请求签名。这是使用您的密钥和请求参数生成的加密签名，用于验证请求的完整性和真实性。签名的生成算法通常包含请求方法（GET、POST等）、请求路径、时间戳和请求体（如果存在）。具体的签名算法请参考Okex API的官方文档。
OK-ACCESS-TIMESTAMP: 时间戳。这是一个Unix时间戳，表示请求发送的时间。时间戳用于防止重放攻击。服务器通常会拒绝时间戳与当前时间相差过大的请求。建议使用精确到秒的时间戳。
OK-ACCESS-PASSPHRASE: 您的Passphrase。如果您在Okex账户中设置了Passphrase，则需要在请求头中包含此参数。Passphrase相当于您的密码，增加了API访问的安全性。如果您没有设置Passphrase，则不需要包含此参数。

注意事项：

确保API密钥、签名和Passphrase的准确性。任何错误都可能导致请求失败。
时间戳的准确性至关重要。请确保您的服务器时间与UTC时间同步。
Passphrase是可选的。只有在您设置了Passphrase的情况下才需要包含在请求头中。
不同的编程语言和HTTP客户端库可能有不同的设置请求头的方式。请参考您使用的库的文档。

构建正确的请求头是成功调用Okex API的关键步骤。请务必仔细阅读Okex API的官方文档，并按照文档中的说明进行操作。

发送请求

构建请求URL时，首先确定API的基础URL。对于欧易（OKX）交易所，API的基础URL通常为 https://www.okx.com 。将此基础URL与所需API接口的请求路径 request_path 组合，即可得到完整的请求URL。

示例代码如下：

url = "https://www.okx.com" + request_path

利用Python的 requests 库发起GET请求。在请求中，需要包含请求头 headers ，其中包含了认证信息（API Key和Secret Key等）。

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

服务器返回的响应通常是JSON格式的字符串。通过 response.text 可以获取响应内容，并进一步解析。

print(response.text)

Passphrase：

为了进一步增强账户安全性，欧易API支持Passphrase功能。Passphrase是在创建API Key时由用户设置的，可以看作是API Key的密码。并非所有API接口都需要Passphrase，但对于涉及资金操作或敏感信息的接口，通常需要提供Passphrase进行身份验证。

要使用Passphrase，需要在请求头中添加一个名为 OK-ACCESS-PASSPHRASE 的键值对，其值为您在创建API Key时设置的Passphrase。

例如：

headers = {
    "OK-ACCESS-KEY": "YOUR_API_KEY",
    "OK-ACCESS-SIGN": "YOUR_SIGNATURE",
    "OK-ACCESS-TIMESTAMP": "YOUR_TIMESTAMP",
    "OK-ACCESS-PASSPHRASE": "YOUR_PASSPHRASE"
}

请务必妥善保管您的Passphrase，避免泄露。如果Passphrase泄露，请立即更换API Key和Passphrase。

API 端点和功能

欧易API提供了一系列全面的端点，旨在满足用户在账户管理、实时市场数据访问以及交易执行等方面的需求。这些端点经过精心设计，能够为开发者提供高效且稳定的接口，从而构建各种加密货币交易应用。以下列出了一些常用的API端点，并对其功能进行了更详细的描述：

账户信息：
- /api/v5/account/balance : 获取账户余额。此端点允许用户查询其在欧易交易所的账户余额，包括不同币种的可用余额、冻结余额等详细信息。通过此接口，用户可以实时掌握资金状况，方便进行交易决策。
- /api/v5/account/positions : 获取持仓信息。此端点提供用户当前持有的仓位信息，包括币种、持仓数量、平均持仓成本、杠杆倍数、未实现盈亏等关键数据。该接口对于风险管理至关重要，能够帮助用户监控投资组合的表现。
- /api/v5/account/account-settings : 获取账户设置信息。此端点用于检索用户的账户配置信息，包括账户等级、手续费等级、API权限设置、交易密码设置等。通过此接口，用户可以检查和确认账户安全设置，并根据需要进行调整。
- /api/v5/account/bills : 查询账户账单明细。此端点提供账户交易历史的详细记录，包括充值、提现、交易、手续费等各项收支明细。用户可以通过此接口追踪资金流动，进行财务审计。支持按时间范围、币种类型等条件进行筛选。
市场数据：
- /api/v5/market/tickers : 获取所有交易对的行情数据。此端点返回欧易交易所所有交易对的最新市场行情快照，包括最新成交价、24小时最高价、24小时最低价、24小时成交量等信息。此接口适用于构建行情看板或监控整个市场趋势。
- /api/v5/market/ticker : 获取单个交易对的行情数据。此端点允许用户查询特定交易对的实时行情信息，与 /api/v5/market/tickers 相比，此端点更专注于单个交易对的详细数据，例如买一价、卖一价、最新成交价、成交量等。
- /api/v5/market/depth : 获取交易对的深度数据（买卖盘）。此端点提供指定交易对的实时深度信息，包括买盘和卖盘的报价和数量。深度数据是分析市场供需关系的重要指标，能够帮助用户判断市场流动性。
- /api/v5/market/trades : 获取交易对的最新成交记录。此端点提供指定交易对的最近成交记录，包括成交时间、成交价格、成交数量、买卖方向等信息。用户可以通过此接口了解市场交易活动的实时动态。
- /api/v5/market/candles : 获取K线数据。此端点允许用户获取指定交易对的历史K线数据，包括开盘价、最高价、最低价、收盘价和成交量。K线数据是技术分析的基础，可以用于预测未来价格走势。用户可以自定义K线的时间周期（如1分钟、5分钟、1小时、1天等）。
交易：
- /api/v5/trade/order : 下单。此端点用于创建新的交易订单，包括市价单、限价单、止损单等多种订单类型。用户可以指定交易对、交易方向（买入/卖出）、订单数量、订单价格等参数。在提交订单前，务必仔细核对订单信息。
- /api/v5/trade/cancel-order : 撤销订单。此端点允许用户取消尚未成交的订单。用户需要提供要取消订单的订单ID。在市场波动剧烈时，及时撤销订单可以有效控制风险。
- /api/v5/trade/amend-order : 修改订单。此端点允许用户修改尚未完全成交的订单的参数，例如价格、数量等。此功能可以帮助用户在市场变化时灵活调整交易策略。部分订单类型可能不支持修改。
- /api/v5/trade/orders-pending : 获取未成交订单列表。此端点用于查询用户当前所有未成交的订单信息，包括订单ID、交易对、订单类型、订单价格、订单数量、订单状态等。
- /api/v5/trade/order-history : 获取历史订单列表。此端点提供用户历史交易订单的详细记录，包括已成交、已撤销、部分成交等状态的订单。用户可以按时间范围、交易对等条件进行筛选。
- /api/v5/trade/fills : 获取成交明细。此端点提供用户的成交记录，包括成交时间、成交价格、成交数量、手续费等详细信息。用户可以通过此接口了解实际交易成本。

API 请求格式

欧易API支持两种常用的HTTP请求方法： GET 和 POST 。选择合适的请求方法取决于请求的目的和需要传递的数据量。

GET 请求： GET 请求主要用于检索数据。参数通过 URL 传递，例如： /api/v5/public/trades?instId=BTC-USDT 。URL 长度有限制，因此不适合传递大量数据。参数直接附加在URL后面，使用问号`?`分隔URL和参数，多个参数之间使用`&`符号连接。
POST 请求： POST 请求通常用于创建、更新或删除数据。参数通过请求体传递，数据大小没有URL的长度限制。 POST 请求更安全，因为参数不会暴露在 URL 中。通常使用 JSON 格式组织请求体中的数据，便于服务器解析。

所有 API 请求都需要包含特定的请求头，用于身份验证和数据完整性校验。这些请求头是确保您的请求被服务器正确处理的关键。

OK-ACCESS-KEY : 您的 API Key，用于标识您的账户。API Key 可以在欧易账户的 API 管理页面创建和管理。请妥善保管您的 API Key，不要泄露给他人。
OK-ACCESS-SIGN : 签名，用于验证请求的完整性和真实性。签名是通过将请求参数、请求路径、时间戳和您的 Secret Key 组合起来，使用特定的哈希算法（例如 HMAC SHA256）生成的。服务器使用相同的算法验证签名，以确保请求未被篡改。
OK-ACCESS-TIMESTAMP : 时间戳（Unix 时间戳，单位为秒），表示请求发送的时间。时间戳用于防止重放攻击。服务器会检查时间戳，如果时间戳与服务器时间相差过大，请求将被拒绝。Unix 时间戳是从 1970 年 1 月 1 日 00:00:00 UTC 到现在的秒数。
OK-ACCESS-PASSPHRASE : Passphrase。如果您在创建 API Key 时设置了 Passphrase，则必须在每个请求中包含此请求头。Passphrase 增加了 API Key 的安全性。如果没有设置Passphrase，则不需要包含此请求头。
Content-Type : 指定请求体的媒体类型。对于 POST 请求，通常设置为 application/ ，表示请求体中的数据是 JSON 格式。如果使用其他格式（例如 application/x-www-form-urlencoded ），则需要相应地设置 Content-Type 。对于 `GET` 请求，通常不需要设置 Content-Type 。

API 响应格式

欧易API返回JSON（JavaScript Object Notation）格式的响应。JSON是一种轻量级的数据交换格式，易于阅读和解析，被广泛应用于Web API的数据传输。响应包含以下关键字段，用于指示请求状态和返回数据：

code : 状态码，用于标识API请求的处理结果。 0 表示API请求成功执行，并返回了预期的数据。任何其他非零值都表示发生了错误，需要根据 msg 字段的详细信息进行排查。
msg : 错误信息，用于提供关于错误的具体描述。当 code 不为 0 时，该字段包含详细的错误信息，例如参数错误、权限不足、服务器内部错误等。开发者应根据此信息诊断并解决问题。该字段信息有助于快速定位问题根源，减少调试时间。
data : 返回的数据。该字段包含API请求成功后返回的实际数据。数据的结构和类型取决于具体的API接口。例如，查询交易对信息时， data 字段可能包含交易对名称、价格、交易量等信息；提交订单时， data 字段可能包含订单ID。如果API请求没有返回数据，则该字段可能为空或包含 null 值。

示例响应：

以下是一个JSON格式的示例响应，展示了加密货币交易平台可能返回的数据结构。此示例数据针对BTC-USDT交易对，提供了实时市场信息。


{
  "code": "0",
  "msg": "",
  "data": [
    {
      "instId": "BTC-USDT",
      "last": "30000.00",
      "lastSz": "0.01",
      "askPx": "30001.00",
      "askSz": "0.1",
      "bidPx": "29999.00",
      "bidSz": "0.1",
      "open24h": "29000.00",
      "high24h": "30500.00",
      "low24h": "28500.00",
      "vol24h": "1000",
      "volCcy24h": "30000000",
      "ts": "1678886400000"
    }
  ]
}

字段说明：

code : 返回码，"0" 通常表示请求成功。非 "0" 值可能指示错误，具体含义需要参考API文档。
msg : 返回消息，通常为空字符串 ("")，但在发生错误时会包含错误描述。
data : 数据数组，包含交易对的详细信息。
instId : 交易对ID，例如 "BTC-USDT" 表示比特币兑换USDT。不同的平台可能使用不同的ID格式。
last : 最新成交价，即最近一笔交易的价格。在本例中，是 30000.00 USDT。
lastSz : 最新成交量，即最近一笔交易的数量。此处为 0.01 BTC。
askPx : 卖一价，即当前市场上最佳卖出价格。本例中，是 30001.00 USDT。
askSz : 卖一量，即以卖一价可供卖出的数量。此处为 0.1 BTC。
bidPx : 买一价，即当前市场上最佳买入价格。本例中，是 29999.00 USDT。
bidSz : 买一量，即以买一价可供买入的数量。此处为 0.1 BTC。
open24h : 24小时开盘价，表示24小时前该交易对的开盘价格。此处为 29000.00 USDT。
high24h : 24小时最高价，表示过去24小时内该交易对的最高成交价格。此处为 30500.00 USDT。
low24h : 24小时最低价，表示过去24小时内该交易对的最低成交价格。此处为 28500.00 USDT。
vol24h : 24小时成交量，以交易对的基础货币计价。此处为 1000 BTC。
volCcy24h : 24小时成交额，以交易对的计价货币计价。此处为 30000000 USDT。
ts : 时间戳，表示数据生成的时间，通常为Unix时间戳（毫秒）。此处为 1678886400000。可以通过时间戳转换工具将其转换为可读的时间格式。

注意事项：

这些数据是动态变化的，会随着市场交易活动而实时更新。
不同的交易所或数据提供商可能提供略有不同的字段和格式。
时间戳的单位需要根据具体API文档进行确认，常见的是秒或毫秒。

错误处理

当API请求失败时， code 字段将返回一个非零值，明确指示请求未成功。同时， msg 字段将包含详细的、人类可读的错误信息，以便于开发者诊断和解决问题。务必检查这两个字段以确定API请求的状态和失败原因。

常见的错误码及其详细解释如下：

60001 : 无效的API Key。表明提供的API Key未通过验证，可能已过期、被吊销或根本不存在。请检查API Key是否正确，并确保其处于活动状态。如果最近重新生成了密钥，请确保使用新的密钥更新应用程序的配置。
60002 : 签名错误。指示请求的签名与服务器计算的签名不匹配。这通常是由于签名算法实现错误、密钥不匹配或请求参数被篡改造成的。仔细检查签名算法的实现，包括参数的排序、编码和密钥的使用。确保用于生成签名的密钥与API Key对应。
60003 : 时间戳过期。API服务器为了防止重放攻击，会验证请求的时间戳。如果时间戳与服务器当前时间相差过大，则会返回此错误。请确保客户端的时间与服务器时间同步，通常误差应控制在几分钟之内。使用网络时间协议（NTP）同步时间可以有效解决此问题。
60011 : 权限不足。表明当前API Key不具备执行该操作所需的权限。检查API Key的权限配置，确保它具有访问所需资源的权限。联系API提供商可以确认API Key是否已正确配置了所需的权限范围。
51001 : 参数错误。指示请求中包含无效的参数。检查请求中所有参数的类型、格式和取值范围是否符合API文档的要求。某些参数可能存在特定的校验规则，例如正则表达式或枚举值。
51002 : 订单不存在。表明请求中指定的订单ID在系统中不存在。验证提供的订单ID是否正确，并确认该订单是否已成功创建。如果订单是最近才创建的，可能需要一些时间才能在系统中完全生效。
51015 : 账户余额不足。表明尝试执行的操作需要足够的账户余额，但当前账户余额不足以支付。检查账户余额，并确保有足够的资金来完成操作。某些操作可能需要支付手续费，因此需要预留足够的手续费金额。

请根据API返回的错误信息，采取相应的纠正措施。建议在应用程序中实现全面的错误处理机制，以便能够优雅地处理API错误，并向用户提供有用的错误提示。同时，详细记录API请求和响应，可以帮助诊断和解决问题。

频率限制

欧易API为了保障系统的稳定性和公平性，对每个API Key都设置了频率限制，也称为速率限制 (Rate Limit)。这意味着在一定时间内，您的API Key能够发起的请求数量是有限制的。超出频率限制将会导致API请求被服务器拒绝，返回错误代码，例如429 Too Many Requests。为了保证交易的流畅性，建议您在使用 API 接口时务必关注并严格遵守频率限制规则。

具体的频率限制取决于您所调用的API端点，以及您的欧易账户的VIP级别。不同的API端点，由于其功能和资源消耗的不同，会有不同的频率限制。 VIP级别越高，通常可以获得更高的频率限制，允许您在单位时间内发起更多的请求。您可以在欧易官方API文档中查阅每个端点的具体频率限制，文档中会明确指出在特定时间窗口内允许的最大请求数量。部分API端点可能还具有更细粒度的频率限制规则，例如针对特定参数的限制。

为了避免触发频率限制，您需要仔细设计和优化您的代码，减少不必要的API调用。建议您采用以下策略来提高效率：

避免频繁轮询： 不要过于频繁地轮询API，特别是在市场行情变化不大的时候。可以使用WebSocket等实时数据推送服务，代替主动轮询。
批量请求： 对于支持批量操作的API端点，尽量将多个请求合并为一个批量请求，减少请求的总次数。例如，批量下单、批量取消订单等。
缓存数据： 将API返回的静态数据或短期内不会变化的数据缓存到本地，避免重复请求。
错误处理： 完善错误处理机制，当API请求被拒绝时，进行适当的延迟重试，避免短时间内大量无效请求冲击服务器。推荐采用指数退避算法进行重试。
监控与告警： 监控API的使用情况，设置频率限制的告警，及时发现并解决问题。

通过合理的设计和优化，可以有效地避免触发频率限制，提高API的使用效率，确保您的交易策略能够顺利执行。

WebSocket API

除了REST API，欧易还提供WebSocket API，这是一种高效的双向通信协议，特别适用于实时数据推送。 WebSocket API允许应用程序与欧易服务器之间建立持久连接，从而实现近乎实时的市场数据流和账户信息更新。相比于传统的HTTP请求-响应模式，WebSocket显著降低了延迟，并减少了服务器资源消耗，因为它避免了频繁建立和关闭连接的开销。

WebSocket API的一个关键优势在于其无需签名认证即可接收公共频道的数据。然而，为了接收特定的数据流，例如用户的账户信息或特定的市场交易对数据，开发者需要通过订阅相应的频道来指定所需接收的数据类型和范围。订阅过程通常涉及发送特定的JSON格式消息到WebSocket服务器，表明客户端希望接收哪些数据更新。

要深入了解欧易WebSocket API的详细用法，包括支持的频道列表、消息格式、连接参数以及错误处理机制，请务必查阅欧易官方WebSocket API文档。该文档提供了全面的指南和示例，帮助开发者快速集成和有效地利用WebSocket API进行实时数据获取和交易。

示例代码（下单）

以下示例展示了如何使用POST请求通过API下单。此示例着重展示了如何生成API请求所需的签名，确保交易的安全性。

import hmac
import hashlib
import base64
import time
import urllib.parse
import requests

def generate_signature(timestamp, method, request_path, body, secret_key):
message = timestamp + method + request_path + body
mac = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
d = mac.digest()
return base64.b64encode(d).decode()

代码解释：

hmac , hashlib , base64 , time , urllib.parse , requests : 这些是Python中常用的库，分别用于消息认证码生成、哈希计算、Base64编码、获取当前时间戳、URL编码和发送HTTP请求。在使用前需要确保已经安装这些库。你可以使用 pip install requests 来安装 requests 库，以及其他库。
generate_signature 函数：此函数负责生成API请求的签名。
timestamp : 请求的时间戳，通常以Unix时间表示，精确到秒或毫秒。
method : HTTP请求方法，如POST、GET等。
request_path : API的请求路径，例如 /api/v1/order 。
body : 请求体，包含要发送的数据，通常是JSON格式。如果请求方法是GET，通常body为空字符串。
secret_key : 你的API密钥，用于生成签名。请妥善保管此密钥。
签名生成过程：

将时间戳、HTTP方法、请求路径和请求体拼接成一个字符串 message 。
使用你的 secret_key 对 message 进行HMAC-SHA256哈希计算。
将哈希结果进行Base64编码，得到最终的签名。

重要提示：

请务必替换示例代码中的占位符，如 secret_key 、 request_path 和 body ，为你自己的实际值。
不同的加密货币交易所或平台可能有不同的签名生成规则，请务必参考其官方API文档。
在实际应用中，建议使用更安全的密钥管理方式，例如环境变量或专门的密钥管理服务。
示例代码仅供参考，请根据你的实际需求进行修改和完善。

示例参数

api key = "YOUR API KEY" # 您的API密钥，用于身份验证。请务必妥善保管，不要泄露给他人。

secret key = "YOUR SECRET KEY" # 您的密钥，与API密钥配对使用，用于生成签名。务必安全存储，防止未经授权的访问。

timestamp = str(int(time.time())) # 当前时间戳，以秒为单位的整数表示。用于防止重放攻击，确保请求的时效性。

method = "POST" # HTTP请求方法。POST方法通常用于创建或更新资源，这里用于提交订单。

request_path = "/api/v5/trade/order" # 示例API endpoint。指定请求的API端点，这里是用于下单的交易接口。

body = .dumps({ # POST请求需要body,这里使用JSON格式。请求体包含订单参数，采用JSON格式进行序列化。


      "instId": "BTC-USDT",  # 交易的标的物，这里是比特币兑美元的交易对。
    "tdMode":  "cash",  # 交易模式，"cash"表示现货交易。
    "side":  "buy",  # 交易方向，"buy"表示买入。
      "ordType": "market",  # 订单类型，"market"表示市价单，立即以当前市场价格成交。
     "sz":  "0.001"  # 交易数量，这里表示买入0.001个比特币。

})

生成签名

为了保障API请求的安全性和完整性，通常需要生成数字签名。签名基于请求的关键组成部分，例如时间戳、HTTP方法、请求路径、请求体以及一个预共享的密钥（secret key）。

signature = generate_signature(timestamp, method, request_path, body, secret_key)

此函数接收以下参数：

timestamp : 请求发起时的时间戳，用于防止重放攻击。通常以Unix时间戳格式表示（自1970年1月1日00:00:00 UTC起的秒数）。
method : HTTP请求方法，例如GET、POST、PUT、DELETE等。必须使用大写形式。
request_path : 请求的URL路径，不包含域名和查询参数。例如： /api/v1/orders 。
body : 请求体的内容，通常是JSON格式的数据。如果请求没有请求体，则使用空字符串。
secret_key : API密钥，由服务提供商提供，用于验证请求的身份。请务必妥善保管，避免泄露。

generate_signature 函数的具体实现取决于所使用的签名算法。常见的签名算法包括HMAC-SHA256和RSA。签名算法的选择必须与API服务提供商的要求一致。

使用HMAC-SHA256算法的示例：


import hmac
import hashlib
import base64

def generate_signature(timestamp, method, request_path, body, secret_key):
  message = timestamp + method + request_path + body
  hmac_obj = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
  signature = base64.b64encode(hmac_obj.digest()).decode('utf-8')
  return signature

生成的签名需要包含在API请求的Header中，具体的Header名称由API服务提供商指定，常见的Header名称包括 X-Signature 、 Authorization 等。

正确生成和使用签名是确保API安全的重要步骤。请仔细阅读API文档，并严格按照要求实现签名逻辑。

构造请求头

在与加密货币交易所的API交互时，构造正确的请求头至关重要。它包含了认证信息和请求的数据格式，确保您的请求能够被交易所服务器正确处理。以下是一个示例，展示了如何构建必要的请求头：

headers = {

'OK-ACCESS-KEY': api_key,

'OK-ACCESS-SIGN': signature,

'OK-ACCESS-TIMESTAMP': timestamp,

'OK-ACCESS-PASSPHRASE': "YOUR_PASSPHRASE", # 如果您启用了Passphrase

'Content-Type': 'application/'

}

字段详解：

OK-ACCESS-KEY ：您的API密钥。这是交易所分配给您的唯一标识符，用于验证您的身份。务必妥善保管您的API密钥，避免泄露。
OK-ACCESS-SIGN ：请求签名。这是使用您的密钥和请求的参数生成的加密签名，用于防止请求被篡改。签名算法通常由交易所指定，常见的算法包括HMAC-SHA256。
OK-ACCESS-TIMESTAMP ：时间戳。表示请求发送的时间，用于防止重放攻击。时间戳通常是自Unix纪元以来的秒数或毫秒数。
OK-ACCESS-PASSPHRASE ：密码短语（Passphrase）。如果您的交易所账户设置了密码短语，则必须在请求头中包含此字段。密码短语为API密钥提供额外的安全保障。
Content-Type ：指定请求体的媒体类型。在大多数情况下，API使用JSON格式进行数据交换，因此应设置为 application/ 。对于某些特定API，可能需要使用其他媒体类型，例如 application/x-www-form-urlencoded 。

注意事项：

请务必使用您自己的API密钥和密码短语替换示例中的占位符。
请求签名算法和时间戳的生成方式因交易所而异，请参考交易所的API文档。
确保时间戳的准确性，偏差过大可能导致请求被拒绝。
安全地存储您的API密钥和密码短语，避免泄露。
根据交易所的要求，可能还需要包含其他请求头字段。请仔细阅读API文档。

发送请求

为了与欧易（OKX）API交互，我们需要构建并发送一个POST请求。定义API的基础URL以及请求的具体路径 request_path 。然后，将它们组合成完整的URL： url = "https://www.okx.com" + request_path 。务必将 "https://www.okx.com" 修改为欧易官方提供的最新的API基础URL，以确保请求的有效性。请求方法选择POST，适用于需要传递数据到服务器的操作。

接下来，利用 requests 库发送HTTP POST请求。请求头 headers 包含了认证和内容类型等元数据，请求体 body 则包含了需要发送的实际数据，例如交易参数或查询条件。完整的请求发送代码如下： response = requests.post(url, headers=headers, data=body) 。 response 对象包含了服务器返回的所有信息，例如状态码、响应头和响应体。

为了方便调试和验证，可以使用 print(response.text) 将服务器返回的响应体以文本形式打印出来。响应体通常是JSON格式的数据，包含了请求执行的结果或其他相关信息，例如订单状态、账户余额等。

请务必用您从欧易交易所获得的真实API密钥（ YOUR_API_KEY ）、密钥（ YOUR_SECRET_KEY ）以及通行短语（ YOUR_PASSPHRASE ）替换代码中的占位符。这些凭证用于对您的请求进行签名，确保请求的安全性，防止未经授权的访问。请妥善保管这些信息，切勿泄露给他人。 API密钥用于标识您的账户，密钥用于生成签名，通行短语则是密钥的加密密码，用于增加安全性。不正确的凭证会导致请求失败。

还在手动交易？欧易自动交易教程：解放双手，抓住暴富机会！

51 2025-03-08