ZB.com API接口使用指南：认证、常用接口与Python示例

ZB.com API 接口使用方法

概述

ZB.com 作为一家老牌加密货币交易所，提供了丰富的 API 接口供用户进行程序化交易和数据分析。 这些 API 接口允许用户自动化交易策略，获取市场数据，并管理账户信息。 本文将详细介绍 ZB.com API 的使用方法，包括认证、常用接口以及示例代码。

API 认证

访问 ZB.com 交易平台的应用程序编程接口 (API) 资源，安全有效的身份认证是首要步骤。ZB.com 采用基于密钥的身份验证机制，确保只有授权用户才能访问其 API。

认证过程的核心是 API 密钥（API Key）和密钥（Secret Key）的使用。API Key 用于标识您的应用程序，Secret Key 则用于对您的 API 请求进行签名，验证请求的完整性和来源。您需要在 ZB.com 账户后台创建 API Key。创建后，务必妥善保管您的 Secret Key，如同保管您的银行密码一样。泄露 Secret Key 将可能导致未经授权的访问，并带来潜在的资金损失风险。

进行 API 请求时，必须将 API Key 通过 HTTP Header 传递给 ZB.com 服务器。将 API Key 放置在名为 X-ZB-ACCESSKEY 的 Header 字段中。此步骤告知 ZB.com 您正在尝试访问 API 及其相关权限。

为了确保请求的安全性，您需要使用 Secret Key 对所有请求参数进行数字签名。签名过程通常涉及对请求参数进行加密哈希处理，生成唯一的签名字符串。然后，将此签名字符串添加到 HTTP Header 中，并命名为 X-ZB-SIGNATURE 。ZB.com 服务器将使用您的 Secret Key 验证此签名，确认请求的真实性和完整性。如果签名验证失败，服务器将拒绝该请求，从而防止恶意篡改或伪造的请求。

签名生成方法如下：

为了保障API请求的安全性，需要对请求进行签名验证。以下步骤详细描述了如何生成符合要求的签名。

1. 参数排序： 将所有请求参数按照 ASCII 码从小到大的顺序进行排序。这一步至关重要，因为参数顺序的任何差异都会导致签名验证失败。请务必包含请求方法，如GET或POST，作为其中一个需要排序的参数。如果参数值本身也是一个数组或对象，需要对该结构进行递归排序。
2. 参数拼接： 将排序后的参数及其对应的值拼接成一个字符串。参数名和参数值之间使用等号（=）连接，不同参数之间使用 & 符号连接。例如： symbol=btc_usdt&type=1min&timestamp=1678886400 。 确保URL编码正确处理，尤其是特殊字符。
3. HMAC-SHA256 加密： 使用您的 Secret Key （API密钥）对拼接后的字符串进行 HMAC-SHA256 加密。HMAC (Hash-based Message Authentication Code) 是一种使用加密哈希函数的消息认证码，可用于验证数据的完整性和真实性。SHA256 是一种安全哈希算法，用于生成 256 位的哈希值。
4. 十六进制转换： 将 HMAC-SHA256 加密的结果转换为大写十六进制字符串。生成的十六进制字符串就是最终的签名，该签名将作为请求头或请求参数的一部分发送给 API 服务器。务必使用大写形式，因为大小写敏感的比较会导致验证失败。

以下是一个 Python 示例代码，用于生成签名：

import hashlib
import hmac
import urllib.parse

def generate_signature(secret_key, params):
    """
    生成 API 签名
    """
    sorted_params = sorted(params.items())
    query_string = urllib.parse.urlencode(sorted_params)
    hashed = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256)
    signature = hashed.hexdigest().upper()
    return signature

代码解释：

• import hashlib , import hmac , import urllib.parse : 导入必要的Python库， hashlib 用于哈希计算， hmac 用于 HMAC 计算， urllib.parse 用于 URL 编码。
• sorted(params.items()) : 将参数字典转换为键值对列表，并按照键的 ASCII 码顺序排序。
• urllib.parse.urlencode(sorted_params) : 将排序后的参数列表进行 URL 编码，生成符合 URL 格式的字符串。
• hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256) : 创建一个 HMAC 对象，使用 Secret Key 对 query string 进行 SHA256 加密。注意 Secret Key 和 query string 都需要进行 UTF-8 编码。
• hashed.hexdigest().upper() : 将加密结果转换为十六进制字符串，并转换为大写。

注意事项：

• 确保 Secret Key 保密，不要泄露给他人。
• 不同的API接口可能对签名参数的要求略有不同，请仔细阅读API文档。
• 时间戳（timestamp）通常是签名的一部分，确保时间戳的准确性，防止重放攻击。
• 某些API可能需要将请求体（request body）也包含在签名中，具体取决于API的实现方式。

示例

secret_key = "YOUR_SECRET_KEY" # 替换为你的 Secret Key。 Secret Key 是用于验证 API 请求的关键凭证，务必妥善保管，避免泄露。该密钥通常由交易所或平台提供，并与你的账户关联。 请确保使用高强度、随机生成的字符串，以提升安全性。

params = { "symbol": "btc_usdt", "type": "1min" } # 定义请求参数。 symbol 指定交易对，例如 "btc_usdt" 表示比特币兑 USDT。 type 指定K线周期， 例如 "1min" 表示1分钟K线。 其他常见的 K 线周期包括 "5min" , "15min" , "30min" , "1hour" , "4hour" , "1day" 等。 根据API文档的要求正确设置这些参数。务必核对交易所API文档，确保参数名和参数值符合规范，避免请求失败。

signature = generate_signature(secret_key, params) # 使用 Secret Key 和参数生成签名。 签名用于验证请求的完整性和身份。 generate_signature 函数的实现会根据具体的交易所或平台而有所不同，通常涉及使用哈希函数（如 HMAC-SHA256）对参数进行加密。 务必参考相应的API文档，正确实现签名生成逻辑。 如果签名不正确，API 请求将被拒绝。

print(signature) # 打印生成的签名。用于调试和验证签名是否正确。 在实际应用中，签名应该被添加到 API 请求的 Header 或 Body 中，具体位置取决于 API 的要求。通过比对生成的签名和交易所收到的签名，可以排查签名过程中的问题。

常用 API 接口

ZB.com 提供了丰富的 RESTful API 接口，开发者可以通过这些接口访问平台的各种功能。以下是一些常用的 API 接口，涵盖了市场数据获取、交易操作和账户管理等方面：

• 获取市场行情数据：

  这些接口允许开发者获取实时的市场数据，用于分析和决策。常用的市场行情数据接口包括：

  • 深度数据 ( /data/v1/depth ): 此接口提供指定交易对的深度数据，展示买单和卖单的挂单情况，有助于了解市场供需关系和流动性。深度数据通常包含价格和数量两个维度，价格按照从优到劣排序。
  • K 线数据 ( /data/v1/kline ): 此接口返回指定交易对的 K 线数据，也称为蜡烛图数据。K 线图以图形化的方式展示一段时间内的开盘价、收盘价、最高价和最低价，不同时间周期的 K 线数据可以反映不同时间尺度的市场趋势。开发者可以指定时间周期，如 1 分钟、5 分钟、1 小时、1 天等。
  • Ticker 数据 ( /data/v1/ticker ): 此接口提供指定交易对的 Ticker 数据，包含最新的成交价格、最高价、最低价、成交量等信息，是快速了解市场动态的重要途径。Ticker 数据通常用于实时监控市场价格波动。
• 交易相关接口：

  这些接口允许开发者进行交易操作，包括下单、撤单和查询订单等。交易相关接口需要进行身份验证，以确保账户安全。

  • 下单 ( /trade/v1/order ): 此接口允许开发者提交买单或卖单，参数包括交易对、交易类型（买入或卖出）、价格和数量等。下单接口支持限价单和市价单等多种订单类型。
  • 撤单 ( /trade/v1/cancel ): 此接口允许开发者撤销尚未成交的订单，需要提供订单 ID 作为参数。撤单操作可以防止订单在市场行情不利时成交。
  • 查询订单 ( /trade/v1/orders ): 此接口允许开发者查询指定交易对的订单信息，可以根据订单状态（未成交、部分成交、全部成交、已撤销等）进行筛选。
  • 查询委托单 ( /trade/v1/entrusts ): 此接口也用于查询订单信息，但可能返回更详细的委托单数据，例如手续费等。具体返回内容取决于 API 的实现。
• 账户相关接口：

  这些接口允许开发者查询账户信息，例如余额、持仓等。账户相关接口需要进行身份验证，以确保账户安全。

  • 获取账户余额 ( /account/v1/balance ): 此接口返回用户的账户余额信息，包括可用余额、冻结余额等。可以指定查询的币种。

获取 K 线数据

/data/v1/kline 接口用于获取指定交易对的历史 K 线（也称为 OHLCV 数据，即开盘价、最高价、最低价、收盘价和成交量）数据。K 线数据是技术分析的基础，可以帮助用户了解市场趋势和价格波动情况。通过该接口，可以获取不同时间周期的 K 线数据，例如 1 分钟、5 分钟、15 分钟、30 分钟、1 小时、4 小时、1 天、1 周和 1 月等。不同的时间周期适用于不同类型的交易策略和分析需求。正确理解和使用 K 线数据对于制定有效的交易决策至关重要。

请求参数：

• symbol : 交易对标识符，用于指定要查询的加密货币交易对。例如， btc_usdt 表示比特币兑 USDT 的交易对。 该参数必须符合交易所规定的交易对命名规则。
• type : K 线的时间周期类型，定义了每根 K 线所代表的时间长度。可选值包括：
  • 1min : 1 分钟 K 线
  • 5min : 5 分钟 K 线
  • 15min : 15 分钟 K 线
  • 30min : 30 分钟 K 线
  • 1hour : 1 小时 K 线
  • 1day : 1 天 K 线
  • 1week : 1 周 K 线
  不同的时间周期 K 线适用于不同时间维度的交易策略分析。选择合适的时间周期是技术分析的关键。
• size : 返回的 K 线数据条数，控制响应中包含的历史 K 线数量。 默认为 100 条。 增大该参数可以获取更长时间的历史数据，但可能会增加服务器响应时间和数据传输量。请注意交易所对每次请求返回的最大数据条数可能有限制。

示例：

在加密货币交易和分析中，K线（Candlestick）数据是至关重要的信息来源。通过程序化方式获取这些数据，可以进行自动化的交易策略分析和回测。以下Python代码展示了如何使用 requests 库从指定API获取K线数据：

requests 库是Python中一个常用的HTTP请求库，可以方便地发送各种HTTP请求，例如GET、POST等。确保你已经安装了这个库。如果没有安装，可以使用 pip install requests 命令进行安装。

import requests

def get_kline_data(symbol, kline_type, size):
    """
    从ZB交易所的API获取指定交易对的K线数据。

    Args:
        symbol (str): 交易对名称，例如 'btc_usdt'。
        kline_type (str): K线类型，例如 '1min', '5min', '15min', '30min', '1hour', '2hour', '4hour', '6hour', '12hour', '1day', '3day', '1week'。
        size (int): 获取的K线数据数量，最大值为500。

    Returns:
        list: 包含K线数据的列表，每个元素是一个K线数据条目。如果获取失败，则返回None。
               K线数据条目的结构通常为 [时间戳, 开盘价, 最高价, 最低价, 收盘价, 成交量]。

    Raises:
        requests.exceptions.RequestException: 如果HTTP请求发生错误。
        KeyError: 如果返回的JSON数据格式不符合预期。
    """
    url = "https://api.zb.com/data/v1/kline"
    params = {
        "symbol": symbol,
        "type": kline_type,
        "size": size
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # 检查HTTP状态码，如果不是200，则抛出异常

        data = response.() # 将响应内容解析为JSON格式

        if data["code"] == 200:
            return data["data"]
        else:
            print(f"Error: {data['message']}")
            return None
    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        return None
    except KeyError as e:
        print(f"JSON data format error: {e}")
        return None

# 示例用法
if __name__ == '__main__':
    symbol = "btc_usdt"  # 比特币/USDT 交易对
    kline_type = "1hour"  # 1小时K线
    size = 100  # 获取100条K线数据
    kline_data = get_kline_data(symbol, kline_type, size)

    if kline_data:
        print(f"成功获取到{symbol}的{kline_type} K线数据:")
        for kline in kline_data:
            print(kline)  # 打印每一条K线数据
    else:
        print("获取K线数据失败。")

上述代码使用ZB交易所的API获取K线数据。 get_kline_data 函数接收交易对名称（symbol）、K线类型（kline_type）和数据大小（size）作为参数。该函数首先构造API请求URL和参数，然后使用 requests.get 方法发送GET请求。如果请求成功（状态码为200），函数将解析返回的JSON数据，并提取K线数据。如果请求失败，函数将打印错误信息并返回 None 。

请注意，实际使用时需要替换示例中的交易对名称和K线类型。由于交易所API可能会发生变化，建议在使用前查阅相关API文档，并根据实际情况修改代码。

示例

symbol = "btc usdt" 该变量定义了交易对的符号，这里是比特币（BTC）兑泰达币（USDT）。 例如，"eth usdt" 表示以太坊兑泰达币，"bnb_usdt" 表示币安币兑泰达币。

kline type = "1min" 此变量指定了K线（蜡烛图）的时间周期。 "1min" 代表1分钟K线， 其他常见周期包括 "5min"（5分钟K线）, "15min" (15分钟K线), "30min" (30分钟K线), "1hour" (1小时K线), "4hour" (4小时K线), "1day" (日K线), "1week" (周K线), "1month" (月K线)。 选择合适的K线周期对于技术分析至关重要。

size = 10 size 变量定义了要获取的K线数据的数量。 在这个例子中，将获取最近的10个K线数据点。 增加 size 的值可以获取更多历史数据，但也可能增加API请求的时间和资源消耗。 例如， size = 100 将获取100个K线数据点。

kline data = get kline data(symbol, kline type, size) 这行代码调用名为 get kline data 的函数，从指定交易对 ( symbol ) 获取对应时间周期 ( kline_type ) 的K线数据。 参数 size 决定了返回的数据点的数量。 get_kline_data 函数的具体实现取决于使用的交易平台API或数据源。 它通常会发送一个API请求到交易所，并解析返回的JSON数据。

if kline_data: print(.dumps(kline_data, indent=4)) 这段代码检查是否成功获取了K线数据。 如果 kline_data 不为空（即成功获取了数据）， 它使用 .dumps() 函数将数据格式化为JSON字符串，并以缩进4个空格的形式打印到控制台。 .dumps() 函数是Python标准库 模块的一部分，用于处理JSON数据的序列化和反序列化。 indent=4 参数使JSON输出更具可读性。 如果未能成功获取K线数据（例如，API请求失败或返回错误），则不会执行打印操作。

下单

/trade/v1/order 接口用于提交交易订单。该接口属于需要身份验证的保护接口，因此在调用前必须确保已获得有效的身份验证凭证，例如API密钥和签名。通过此接口，用户可以执行买入或卖出操作，并指定交易对、订单类型（例如市价单、限价单）、数量和价格等参数，以实现其交易策略。请务必仔细检查订单参数，避免因参数错误导致交易失败或产生不必要的损失。

请求参数：

• symbol : 交易对。指定您希望交易的加密货币对，例如 btc_usdt (比特币/USDT)。务必使用交易所支持的精确符号格式，否则请求可能会失败。不同的交易所可能对同一交易对使用不同的符号约定。
• type : 交易类型。定义交易的执行方式。
  • 1 : 限价买入。以指定的价格或更低的价格购买指定数量的加密货币。只有当市场价格达到或低于您的指定价格时，交易才会被执行。
  • 2 : 限价卖出。以指定的价格或更高的价格出售指定数量的加密货币。只有当市场价格达到或高于您的指定价格时，交易才会被执行。
  • 3 : 市价买入。以当前市场最佳可用价格立即购买指定数量的加密货币。订单执行速度快，但实际成交价格可能与下单时看到的略有不同。
  • 4 : 市价卖出。以当前市场最佳可用价格立即出售指定数量的加密货币。订单执行速度快，但实际成交价格可能与下单时看到的略有不同。
• price : 委托价格。当交易类型为限价买入 ( 1 ) 或限价卖出 ( 2 ) 时，此参数是必需的。它指定了您愿意买入或卖出的目标价格。确保价格精度符合交易所的要求。
• amount : 委托数量。指定您希望购买或出售的加密货币数量。数量精度也需要符合交易所的最小交易单位和数量步长要求。
• tradePwd : 交易密码。某些交易所或账户启用了额外的安全措施，需要提供交易密码才能执行交易。如果您的账户启用了交易密码，则必须包含此参数。未启用交易密码的账户则不需要此参数。

示例：使用Python进行加密货币交易下单

本示例展示了如何使用Python的 requests 库与加密货币交易所ZB.com的API进行交互，实现下单功能。代码片段包含了必要的参数设置、签名生成以及API请求过程。

import requests

此行代码导入Python的 requests 库，该库用于发送HTTP请求，例如POST请求，用于与交易所API进行通信。

def place_order(api_key, secret_key, symbol, order_type, price, amount, trade_pwd=""):

定义了一个名为 place_order 的函数，该函数接受以下参数：

• api_key : 用户的API密钥，用于身份验证。
• secret_key : 用户的私钥，用于生成请求签名，确保请求的安全性。
• symbol : 交易对，例如"BTC_USDT"，表示比特币兑美元。
• order_type : 订单类型，例如"buy"（买入）或"sell"（卖出）。部分交易所支持更细化的订单类型，如"buy_market"（市价买入）或"sell_limit"（限价卖出）。
• price : 订单价格，仅在限价单中有效。
• amount : 订单数量，即要买入或卖出的加密货币数量。
• trade_pwd : 交易密码，一些交易所需要此参数进行额外的安全验证，默认为空字符串。

""" 下单 """

文档字符串，简要描述了函数的功能：下单。

url = "https://api.zb.com/trade/v1/order"

定义了API的URL，指向ZB.com交易所的下单接口。请注意，不同的交易所可能有不同的API URL，需要根据交易所的官方文档进行调整。

params = { "symbol": symbol, "type": order_type, "price": price, "amount": amount, "tradePwd": trade_pwd }

创建了一个字典 params ，用于存储POST请求的参数。这些参数包括交易对、订单类型、价格、数量和交易密码。这些参数将作为请求体发送到交易所API。

signature = generate_signature(secret_key, params)

headers = {
  "X-ZB-ACCESSKEY": api_key,
  "X-ZB-SIGNATURE": signature
}

response = requests.post(url, headers=headers, data=params)

if response.status_code == 200:
  data = response.()
  if data["code"] == 200:
    return data["data"]
  else:
    print(f"Error: {data['message']}")
    return None
else:
  print(f"Request failed with status code: {response.status_code}")
  return None

这段代码实现了以下步骤：

1. signature = generate_signature(secret_key, params) : 调用 generate_signature 函数（未在本例中定义，需要根据交易所的签名算法实现）生成签名。签名是根据私钥和请求参数生成的，用于验证请求的完整性和真实性。
2. headers = { "X-ZB-ACCESSKEY": api_key, "X-ZB-SIGNATURE": signature } : 创建HTTP头部信息，包含API密钥和签名。API密钥用于标识用户，签名用于验证请求的合法性。一些交易所可能还需要其他头部信息，例如时间戳。
3. response = requests.post(url, headers=headers, data=params) : 使用 requests.post 函数发送POST请求到交易所API。 url 是API的URL， headers 是HTTP头部信息， data 是请求参数。
4. if response.status_code == 200: : 检查HTTP响应状态码是否为200，表示请求成功。
5. data = response.() : 将响应内容解析为JSON格式。
6. if data["code"] == 200: return data["data"] : 检查JSON响应中的 code 字段是否为200，表示API调用成功。如果是，则返回API返回的数据。
7. else: print(f"Error: {data['message']}") return None : 如果API调用失败，则打印错误信息并返回 None 。
8. else: print(f"Request failed with status code: {response.status_code}") return None : 如果HTTP请求失败，则打印错误信息并返回 None 。

重要提示：

• 请务必妥善保管您的API密钥和私钥，避免泄露。
• 在实际交易前，请先在测试环境中进行测试。
• 不同的交易所可能有不同的API接口和参数要求，请仔细阅读交易所的官方文档。
• 本示例仅供参考，请根据您的实际需求进行修改。
• 请注意资金安全，审慎投资。

示例

api_key = "YOUR_API_KEY" # 将 "YOUR_API_KEY" 替换为你的交易平台提供的API密钥。API密钥用于验证你的身份并授权你访问交易平台的API接口。 请妥善保管你的API密钥，避免泄露给他人。

secret_key = "YOUR_SECRET_KEY" # 将 "YOUR_SECRET_KEY" 替换为你的交易平台提供的私钥。 私钥用于对你的API请求进行签名，确保请求的真实性和完整性。请务必保管好你的私钥，绝对不要泄露给任何人，也不要上传到公共代码仓库。

symbol = "btc_usdt" # 设置交易对为 "btc_usdt"，表示比特币 (BTC) 兑美元稳定币 (USDT) 的交易市场。 根据你的需要修改为你想要交易的其他交易对，例如 "eth_usdt" (以太坊兑USDT)。 请确保交易平台支持你选择的交易对。

order_type = 1 # 订单类型设置为 1， 通常代表限价买入订单。不同的交易平台可能使用不同的数值或枚举来表示订单类型。请查阅你所使用的交易平台的API文档，确认订单类型的具体定义。 常见的订单类型包括：限价单 (Limit Order)、市价单 (Market Order)、止损单 (Stop-Loss Order) 等。

price = 30000 # 设置限价买入的价格为 30000 USDT。 当市场价格达到或低于 30000 USDT 时，你的买入订单将被执行。 根据市场情况和你的交易策略，设置合适的买入价格。

amount = 0.01 # 设置买入数量为 0.01 BTC。 这意味着你将以指定的价格购买 0.01 个比特币。请根据你的资金情况和风险承受能力，设置合理的交易数量。 请注意，不同的交易平台对于最小交易数量有不同的限制，需要满足平台的最低要求。

order_id = place_order(api_key, secret_key, symbol, order_type, price, amount)

# 调用 place_order 函数，提交订单到交易平台。 place_order 函数接收 API 密钥、私钥、交易对、订单类型、价格和数量等参数，并返回订单 ID。 订单 ID 是交易平台为你的订单分配的唯一标识符，可用于查询订单状态或取消订单。 该函数的具体实现会根据不同的交易平台API而有所不同。

if order_id: # 检查订单是否成功提交。 如果 order_id 不为空，则表示订单已成功提交到交易平台。

print(f"Order placed successfully. Order ID: {order_id}") # 如果订单成功提交，则打印订单提交成功的消息，并显示订单 ID。 你可以使用该订单 ID 在交易平台上查询订单的执行状态，例如是否已经成交、部分成交或未成交。

错误处理

在使用 ZB.com API 接口进行数字资产交易、账户管理或数据查询时，务必重视错误处理机制。 ZB.com API 遵循标准 RESTful 架构，并采用 JSON 格式返回数据，其中包括详细的错误信息。 这些错误信息通常包含 code 和 message 两个关键字段，用于指示错误的类型和提供相关的描述。

开发者需要深入理解并有效利用 code 字段，因为它提供了关于错误性质的明确信号。 通过解析 code 值，应用程序可以准确地识别错误类型，并执行适当的补救措施。 例如，可以向用户显示清晰的错误消息，重新提交请求并进行必要的修正，或者采取其他适合特定错误的应对策略。 message 字段通常会提供更详细的错误描述，有助于开发人员诊断和解决问题。

常见的错误码及其含义如下：

• 1000 : 参数错误。 这通常表示请求中缺少必需的参数，或者提供的参数值不符合预期的格式或范围。 请检查请求参数的拼写、数据类型、长度和取值范围，并确保所有必需的参数都已正确提供。
• 2001 : 签名错误。 签名用于验证请求的完整性和真实性，防止请求被篡改。 如果签名计算不正确，API 将拒绝请求。 请检查 API 密钥是否正确配置，签名算法是否正确实现，以及请求参数是否与签名算法匹配。 确保使用正确的密钥对请求进行签名，并验证签名算法的实现是否符合 ZB.com API 的要求。
• 3001 : 账户余额不足。 在进行交易或转账操作时，如果账户余额不足以支付所需的金额，API 将返回此错误码。 请检查账户余额是否足够，或者减少交易或转账的金额。 考虑获取最新的账户余额信息，并根据可用余额调整交易策略。
• 4001 : 交易密码错误。 交易密码用于保护账户安全，防止未经授权的交易。 如果交易密码输入错误，API 将拒绝交易。 请确保输入的交易密码是正确的。 某些 API 提供了重置交易密码的机制，如果忘记密码，可以使用该机制进行重置。

注意事项

• 安全至上： 务必妥善保管 API Key 和 Secret Key，切勿以任何方式泄露给任何第三方。这两种密钥是访问账户和执行交易的关键凭证，一旦泄露可能导致资金损失或其他严重安全问题。 建议采取离线存储、加密存储等措施，并且定期更换密钥。
• 文档先行： 在进行任何交易操作前，务必仔细阅读并理解 API 文档。重点关注接口参数的含义、数据类型、取值范围，以及返回值的格式、状态码和错误信息。务必确保理解所有相关细节，避免因参数错误或理解偏差导致交易失败或意外后果。
• 频率控制： API 调用通常存在频率限制，这是交易所或平台为了保证系统稳定性和公平性所采取的措施。需要严格控制 API 调用频率，避免触发频率限制，否则可能导致 API 调用被拒绝或账户被暂时禁用。建议实施速率限制策略，例如使用令牌桶算法或漏桶算法，根据实际情况调整调用频率。
• HTTPS 协议： 强烈建议使用 HTTPS 协议进行 API 调用，确保数据在客户端和服务器之间传输过程中的安全性。HTTPS 协议通过 TLS/SSL 加密技术，防止数据被窃听、篡改或伪造，保障交易数据的机密性和完整性。避免使用不安全的 HTTP 协议，防止敏感信息泄露。
• 异常处理： 在生产环境中，必须对 API 调用进行全面的异常处理。API 调用可能因网络问题、服务器故障、参数错误或其他未知原因而失败。需要捕获这些异常，并采取适当的措施，例如重试、记录错误日志、发出警报等，防止程序崩溃或数据丢失。同时，也要针对不同的异常类型进行分类处理，提供更精细的错误处理机制。

其他接口

ZB.com提供了一系列额外的API接口，旨在满足开发者在加密货币交易和数据分析方面的多样化需求。除了常见的交易接口外，还包括：

• 获取所有交易对： 此接口允许开发者获取ZB.com平台上所有可交易的加密货币交易对的完整列表，包含交易对名称、交易代码等关键信息。这对于构建交易策略、监控市场动态至关重要。
• 获取实时交易信息： 此接口提供实时的交易数据，包括最新成交价、成交量、买一价、卖一价等信息。开发者可以利用这些数据进行高频交易、套利交易以及市场深度分析。
• K线数据接口： 获取指定交易对的历史K线数据，包括开盘价、收盘价、最高价、最低价以及成交量。K线数据是技术分析的基础，可用于预测价格走势。
• 深度图接口： 获取指定交易对的实时买卖盘深度信息，反映市场的买卖力量对比，帮助开发者评估市场的供需关系。
• Ticker信息接口： 获取指定交易对的24小时行情概要信息，包括最高价、最低价、成交量、涨跌幅等。

开发者应仔细研读ZB.com官方提供的API文档，该文档详细描述了每个接口的请求参数、响应格式、调用频率限制等重要信息。根据自身的应用场景和需求，选择合适的接口进行集成，构建高效、稳定的加密货币应用。