BigONE API全攻略：用Python玩转数字货币交易，交易不再迷茫！

2025-03-07 研究 16℃

BigONE API 使用指南

BigONE 提供了一套功能强大的 API，允许开发者访问平台的数据，执行交易，并构建自己的应用程序。本文档旨在帮助开发者了解和使用 BigONE API。

身份验证

访问 BigONE API 的特定端点，尤其是那些涉及用户资产管理、交易执行和账户信息的端点，需要进行严格的身份验证机制。BigONE 采用 API 密钥认证方式，确保只有授权用户才能访问敏感数据并执行相关操作。

API 密钥由一对密钥组成：公共 API 密钥（也称为 API Key）和私有密钥（也称为 Secret Key）。公共 API 密钥用于识别您的身份，而私有密钥则用于对您的请求进行签名，以验证请求的真实性和完整性。请务必妥善保管您的私有密钥，切勿泄露给任何第三方，因为它等同于您的账户密码，泄露可能导致资产损失。

要获得 API 密钥，您需要在 BigONE 交易所注册账户并完成必要的身份验证流程（KYC）。在账户设置中，您可以创建新的 API 密钥对，并为其设置相应的权限，例如交易权限、提现权限或只读权限。请根据您的实际需求，授予 API 密钥所需的最低权限，以最大程度地降低安全风险。

使用 API 密钥进行身份验证时，您需要在每个 API 请求的头部或查询参数中包含公共 API 密钥，并在请求中包含使用私有密钥生成的签名。签名的生成通常涉及对请求参数、时间戳和私有密钥进行哈希运算。BigONE 提供了详细的 API 文档和示例代码，帮助您正确地生成签名并完成身份验证。

为了增强安全性，建议您定期轮换 API 密钥，并监控 API 密钥的使用情况，及时发现并处理异常行为。如果您的 API 密钥泄露或怀疑被盗用，请立即禁用该密钥并创建新的密钥对。您还可以启用双重验证（2FA）等安全措施，进一步保护您的 BigONE 账户安全。

获取 BigONE API 密钥

为了能够通过编程方式与 BigONE 交易所进行交互，您需要获取 API 密钥。API 密钥允许您访问 BigONE 提供的各种功能，例如交易、查询账户余额、获取市场数据等。请按照以下步骤操作：

登录您的 BigONE 账户。 确保您已拥有一个 BigONE 账户，并且已经完成必要的身份验证流程（KYC）。使用您的用户名和密码安全地登录您的账户。
前往“API 管理”页面。 登录后，导航到您的账户设置或个人资料页面，通常可以在用户中心的某个位置找到“API 管理”、“API 密钥”或类似的选项。此页面是您创建和管理 API 密钥的地方。不同版本页面位置可能存在差异。
创建新的 API 密钥对。 在 API 管理页面，点击“创建 API 密钥”、“生成新的密钥对”或类似的按钮。系统可能会要求您为该密钥对指定一个名称或描述，以便您日后识别其用途。请务必仔细设置 API 密钥的权限。 BigONE 允许您为每个 API 密钥分配特定的权限，例如只读访问、交易权限、提现权限等。选择与您的应用程序需求相匹配的最小权限集，以提高安全性。 请注意，创建后请务必保存 Secret Key，仅会显示一次。 Secret Key 是您访问 API 的重要凭证，丢失后将无法恢复。请将 Secret Key 安全地存储在您的本地，不要分享给他人。
您将获得一个 API Key (Access Key) 和一个 Secret Key。 创建成功后，您将获得一个 API Key（也称为 Access Key 或 Public Key）和一个 Secret Key（也称为 Private Key）。 API Key 用于标识您的身份，而 Secret Key 用于验证您的请求。

重要提示：

请务必妥善保管您的 API Key 和 Secret Key，避免泄露。
不要将您的 Secret Key 存储在代码库中或公开的存储库中。
定期更换您的 API Key，以提高安全性。
如果您怀疑您的 API Key 已泄露，请立即撤销该密钥对并生成新的密钥对。

请求签名

所有需要身份验证的请求都需要使用您的 Secret Key 进行签名。 BigONE 为了保证API请求的安全性，采用 HMAC-SHA256 算法生成数字签名，用于验证请求的来源和完整性。签名过程涉及到将请求的关键信息，例如时间戳、请求方法、请求路径和请求参数，与您的 Secret Key 结合，通过 HMAC-SHA256 算法进行哈希运算，生成一个唯一的签名字符串。

在发起API请求时，您需要将生成的签名字符串添加到请求头中，以便 BigONE 服务器能够验证您的身份。请务必妥善保管您的 Secret Key，避免泄露，以防止未经授权的访问。如果您的 Secret Key 泄露，请立即更换，以确保您的账户安全。

签名算法的详细步骤包括：

构建签名字符串： 将请求方法（如GET、POST）、请求路径、查询参数（如果有）以及请求体（如果是POST请求且有请求体）按照特定的格式连接成一个字符串。连接的顺序和格式必须与 BigONE API 文档中规定的严格一致。
计算 HMAC-SHA256 哈希值： 使用您的 Secret Key 作为密钥，对构建的签名字符串进行 HMAC-SHA256 哈希运算。
将哈希值转换为十六进制字符串： 将计算得到的哈希值转换为十六进制字符串，作为最终的签名。
将签名添加到请求头： 将签名字符串添加到请求头的特定字段中，字段名称通常在 BigONE API 文档中指定。

请参考 BigONE API 文档，获取更详细的签名算法说明和示例代码，以确保您能够正确地生成签名并成功发起API请求。错误的签名会导致请求被拒绝。

签名步骤:

构建规范化的请求字符串。 请求字符串的构造至关重要，它必须准确反映你的 API 调用。请求字符串的格式取决于请求的 HTTP 方法（例如 GET、POST、PUT、DELETE）和目标端点。细致地整理你的请求参数，并按照API文档规定的顺序和编码方式进行拼接。这一步是确保签名有效性的基础。
使用 Secret Key 进行 HMAC-SHA256 签名。 使用你的 Secret Key 对上一步构建的请求字符串进行 HMAC-SHA256 加密。HMAC-SHA256 是一种安全的哈希算法，它使用密钥来生成唯一的签名。确保你使用的 Secret Key 是保密的，并且只在你的服务器端使用。任何泄露都可能导致安全风险。
添加签名到 Authorization 请求头。 将生成的 HMAC-SHA256 签名添加到 HTTP 请求头的 Authorization 字段中。通常，签名会以某种预定义的格式（例如 HMAC-SHA256=<签名> ）包含在 Authorization 头中。 API 服务端会使用该签名来验证请求的真实性和完整性。
添加 API Key (Access Key) 到 ONE-API-KEY 请求头。 将你的 API Key (Access Key) 添加到请求头的 ONE-API-KEY 字段中。 API Key 用于标识你的应用程序或用户。服务端会使用 API Key 来进行身份验证，并限制你的 API 使用量。确保你的 API Key 是有效的，并且拥有访问所需端点的权限。

请求字符串构建方式：

GET 请求： 将所有查询参数按照字母顺序进行严格排序，务必确保排序的准确性，然后使用 & 符号将排序后的参数对连接起来。每个参数对的形式应为 参数名=参数值 。例如： symbol=BTC-USDT&limit=100 。请注意，参数值本身如果包含特殊字符，需要进行URL编码，以确保其正确传递。务必检查API文档，确认是否对时间戳、签名等特定参数有额外的排序或编码要求。
POST/PUT/DELETE 请求： 将请求体的 JSON 字符串，严格按照标准的 JSON 格式进行序列化，并将结果字符串直接作为请求字符串。JSON 字符串必须符合规范，包括正确的键值对结构、引号使用以及数据类型。后端服务会对该 JSON 字符串进行解析，因此务必保证其格式的正确性。请注意，发送请求时，Content-Type 头部应设置为 application/ ，以告知服务器请求体的内容类型。对于复杂数据结构，建议仔细检查 JSON 序列化后的结果，避免出现数据丢失或类型转换错误。

示例 (Python):

以下 Python 代码演示了如何使用 BigONE 交易所的 API 接口进行数据获取和订单创建。请确保已安装必要的 Python 库，如 hashlib , hmac , time , 和 requests 。可以使用 pip install requests 安装 requests 库。

import hashlib import hmac import time import requests import

api_key = "YOUR_API_KEY" # 替换为你的 API Key。API Key 用于身份验证。 secret_key = "YOUR_SECRET_KEY" # 替换为你的 Secret Key。Secret Key 用于生成签名。 base_url = "https://api.big.one/openapi/v3" # BigONE API 的基础 URL。

def generate_signature(message, secret_key): """生成 HMAC-SHA256 签名。签名用于验证请求的完整性和真实性。""" message = message.encode('utf-8') # 将消息编码为 UTF-8 格式。 secret = secret_key.encode('utf-8') # 将密钥编码为 UTF-8 格式。 hmac_obj = hmac.new(secret, message, hashlib.sha256) # 创建 HMAC 对象，使用 SHA256 算法。 return hmac_obj.hexdigest() # 返回十六进制表示的签名。

def get_markets(): """获取市场列表。返回所有可交易的市场信息。""" endpoint = "/markets" # API 端点。 url = base_url + endpoint # 完整的 API URL。 response = requests.get(url) # 发送 GET 请求。 return response.() # 将响应解析为 JSON 格式。

def get_ticker(symbol): """获取指定市场 Ticker 信息。Ticker 信息包括最新成交价、成交量等。""" symbol = symbol.upper() # 强制转换为大写，确保符合API的要求 endpoint = f"/markets/{symbol}/ticker" # API 端点，使用 f-string 格式化字符串。 url = base_url + endpoint # 完整的 API URL。 response = requests.get(url) # 发送 GET 请求。 return response.() # 将响应解析为 JSON 格式。

def create_order(symbol, side, type, price, amount): """创建订单。允许用户提交买入或卖出订单。""" symbol = symbol.upper() # 强制转换为大写，确保符合API的要求 endpoint = "/orders" # API 端点。 url = base_url + endpoint # 完整的 API URL。 timestamp = str(int(time.time())) # Unix 时间戳，精确到秒。用于防止重放攻击。 body = { "symbol": symbol, "side": side, # "ASK" (卖出) 或 "BID" (买入)。指定订单的方向。 "type": type, # "LIMIT" (限价单) 或 "MARKET" (市价单)。指定订单类型。 "price": str(price), # 订单价格，字符串类型。限价单需要指定价格。 "amount": str(amount) # 订单数量，字符串类型。 } body_str = .dumps(body) # 将请求体转换为 JSON 字符串。 signature = generate_signature(body_str, secret_key) # 生成签名。

headers = {
    "ONE-API-KEY": api_key, # API Key，用于身份验证。
    "Authorization": signature, # 签名，用于验证请求的完整性。
    "Content-Type": "application/", # 指定内容类型为 JSON。
    "ONE-TIME": timestamp # 时间戳，用于防止重放攻击。
}
response = requests.post(url, headers=headers, data=body_str) # 发送 POST 请求。
return response.() # 将响应解析为 JSON 格式。

示例

在Python编程中， if name == ' main ': 语句块常用于判断当前脚本是否作为主程序运行。当Python解释器执行一个脚本时，会设置内置变量 __name__ 。如果脚本是直接运行的，那么 __name__ 的值会被设置为 '__main__' 。如果脚本是被导入的， __name__ 的值则会被设置为模块名。因此，该语句块内的代码只会在脚本作为主程序运行时执行，而不会在被导入时执行。这对于组织代码、编写可复用的模块以及进行单元测试非常有用。例如： markets = get_markets() print("Markets:", markets) 这段代码调用 get_markets() 函数获取市场列表，并将结果打印到控制台。 get_markets() 函数的具体实现会根据不同的交易所或API而有所不同，它通常会返回一个包含可用交易对信息的列表。在实际应用中，可以根据返回的市场列表进行进一步的处理，例如筛选特定的交易对、获取交易数据等。

    
# 获取 BTC-USDT Ticker
ticker = get_ticker("BTC-USDT")
print("BTC-USDT Ticker:", ticker)

#  创建一个限价买单 (需要 API 密钥和 Secret Key)
# 确保您的账户有足够的资金
# 确保您理解交易风险
# result = create_order(symbol="BTC-USDT", side="BID", type="LIMIT", price=30000, amount=0.001)
# print("Create Order Result:", result)

上述代码片段展示了如何获取BTC-USDT的最新交易信息（Ticker）以及如何创建一个限价买单。 get_ticker("BTC-USDT") 函数负责从交易所的API获取BTC-USDT交易对的实时数据，例如最新成交价、最高价、最低价、交易量等。返回值 ticker 通常是一个包含这些信息的字典或对象。创建限价单的示例代码被注释掉了，因为它涉及到实际的交易操作，需要用户提供API密钥和Secret Key。为了安全起见，不建议在公共环境中直接展示或运行包含密钥的代码。 create_order() 函数的功能是向交易所提交订单。参数 symbol 指定交易对（例如 "BTC-USDT"）， side 指定买卖方向（"BID" 表示买入，"ASK" 表示卖出）， type 指定订单类型（"LIMIT" 表示限价单）， price 指定价格， amount 指定数量。 重要提示： 在进行任何交易操作之前，务必确保您的账户有足够的资金，并且充分理解交易风险。加密货币市场波动剧烈，请谨慎操作。

API 端点

BigONE API 提供了一系列端点，开发者可以通过这些端点访问市场数据、账户信息以及执行交易操作。这些端点遵循 RESTful 架构，使用标准的 HTTP 方法（如 GET、POST、PUT、DELETE）进行数据交互，并通常以 JSON 格式返回数据。理解这些端点及其参数是构建任何与 BigONE 交易所交互的应用程序的基础。

/markets : 获取 BigONE 交易所支持的所有交易市场列表。返回的信息通常包含交易对的符号、交易精度、手续费率等。开发者可以使用此端点来动态获取交易所支持的交易对，避免硬编码交易对信息。
/markets/{symbol}/ticker : 获取指定市场的实时 Ticker 信息，如最新成交价、最高价、最低价、成交量、24 小时涨跌幅等。 {symbol} 需要替换为实际的市场符号，例如 "BTC-USDT"。Ticker 数据是进行量化交易和监控市场动态的关键数据来源。
/markets/{symbol}/depth : 获取指定市场的深度数据 (Order Book)，展示当前市场上买单和卖单的挂单情况。深度数据通常包含多个价格等级的买单和卖单，以及每个价格等级对应的挂单数量。深度数据对于分析市场供需关系、评估流动性以及进行高频交易至关重要。
/markets/{symbol}/trades : 获取指定市场的成交记录，展示最近发生的交易信息。每条成交记录通常包含成交时间、成交价格、成交数量以及交易方向（买入或卖出）。成交记录可以用于分析市场趋势、验证交易策略的回测结果。
/assets : 获取用户的资产信息，包括账户中持有的各种加密货币的余额。此端点需要通过 API 密钥进行身份验证，以确保账户安全。返回的信息通常包含每种资产的可用余额、冻结余额以及总余额。
/orders : 创建、查询和取消订单。此端点同样需要身份验证。开发者可以使用此端点来编写自动交易程序，实现自动化交易策略。创建订单时需要指定交易对、订单类型（市价单、限价单等）、交易方向（买入或卖出）、价格和数量等参数。
/orders/{id} : 获取指定 ID 的订单信息。通过订单 ID 可以查询特定订单的详细状态，如订单状态（已提交、已成交、已取消等）、成交价格、成交数量等。此端点需要身份验证。
/orders/multi : 批量创建订单，允许一次性提交多个订单。此端点通常用于执行复杂的交易策略，如套利交易、网格交易等。使用批量创建订单可以减少网络延迟，提高交易效率。此端点需要身份验证。
/withdrawals : 发起提现请求，将账户中的加密货币转移到外部钱包地址。提现请求需要指定提现币种、提现地址和提现数量。出于安全考虑，提现操作通常需要进行二次验证，如短信验证码或 Google Authenticator。此端点需要身份验证。
/deposits : 查询充值记录，查看最近的充值历史。充值记录通常包含充值币种、充值数量、充值地址、交易哈希等信息。此端点需要身份验证。

请参考 BigONE 官方 API 文档获取完整的端点列表、详细参数说明、请求示例以及错误代码解释。官方文档通常会提供更详细的示例代码和最佳实践，帮助开发者快速上手并避免常见的错误。

请求参数

不同的 API 端点接收各不相同的请求参数，正确提供这些参数是成功调用 API 的关键。以下列出了一些常见的请求参数及其详细解释：

symbol : 市场代码，用于指定交易对。例如，"BTC-USDT" 代表比特币兑 USDT 的交易对。该参数通常区分大小写，请确保输入正确的市场代码。务必参考交易所提供的市场代码列表。
limit : 返回结果的数量限制。API 通常会限制单次请求返回的数据量，该参数用于控制返回结果的最大数量。例如， limit=100 表示最多返回 100 条数据。合理设置 limit 可以提高数据处理效率，避免服务器资源过度占用。
offset : 返回结果的偏移量，用于分页查询。当结果集非常大时，可以通过 offset 和 limit 参数实现分页查询。例如， offset=0&limit=100 表示返回第一页的 100 条数据， offset=100&limit=100 表示返回第二页的 100 条数据。使用分页查询可以有效处理大量数据。
side : 订单方向，指定是买入 (BID) 还是卖出 (ASK)。"ASK" 代表卖出，即卖出某种加密货币；"BID" 代表买入，即买入某种加密货币。该参数是订单请求中必不可少的参数。
type : 订单类型，常见的订单类型包括限价单 (LIMIT) 和市价单 (MARKET)。 "LIMIT" 表示限价单，只有当市场价格达到指定价格时才会成交；"MARKET" 表示市价单，会立即以当前市场最优价格成交。不同的订单类型适用于不同的交易策略。
price : 订单价格，仅在创建限价单时需要指定。该参数指定了希望成交的价格。如果市场价格未达到指定价格，订单将不会成交，并保留在订单簿中等待成交。
amount : 订单数量，指定要买入或卖出的加密货币的数量。该参数通常以最小交易单位为单位。请仔细核对订单数量，避免因数量错误导致交易失败或损失。

请务必参考 BigONE 官方 API 文档，详细了解每个 API 端点的具体请求参数要求和数据格式。不同的 API 端点可能需要不同的参数，或者对参数的取值范围有不同的限制。准确理解 API 文档是成功开发交易程序的关键。

响应格式

BigONE API 采用业界标准的 JSON (JavaScript Object Notation) 格式返回响应。JSON 是一种轻量级的数据交换格式，易于阅读和解析，方便开发者进行数据处理。

API 的响应结构通常包含以下关键组成部分：

状态码 (Status Code): 一个数字代码，用于指示 API 请求的处理结果。常见的状态码包括 200 (成功), 400 (错误请求), 401 (未授权), 404 (未找到), 500 (服务器内部错误) 等。详细的状态码定义可以参考 BigONE API 的文档。

错误信息 (Error Message, 仅在发生错误时):

数据 (Data):

例如，一个成功的请求可能会返回如下 JSON 结构：


{
  "code": 200,
  "data": {
    "symbol": "BTCUSDT",
    "price": "30000.00"
  }
}

而一个失败的请求可能会返回如下 JSON 结构：


{
  "code": 400,
  "message": "Invalid parameter: symbol"
}

开发者应该始终检查响应中的状态码，并根据状态码和错误信息来处理 API 请求的结果。使用合适的 JSON 解析库来处理 API 返回的数据。

示例 (成功响应):

此示例展示了一个成功的API响应，用于查询特定加密货币交易对（在此例中为BTC-USDT）的实时市场数据。响应采用JSON格式，易于解析和处理。

{ "code": 0, "message": "Success", "data": { "symbol": "BTC-USDT", "open": "29000.00", "high": "30000.00", "low": "28000.00", "close": "29500.00", "volume": "1000.00" } }

字段解释：

code: 0 表示请求成功。非零值通常指示错误，并可能伴随错误信息。
message: "Success" 提供关于操作结果的文本描述，方便开发者理解。
data: 包含实际的市场数据，是一个JSON对象。

symbol: "BTC-USDT" 指定交易对，这里是比特币兑泰达币。不同的交易所可能使用不同的符号表示方式。
open: "29000.00" 表示该交易对在当前时间段（例如，一天）的开盘价格。
high: "30000.00" 表示该交易对在当前时间段内的最高价格。
low: "28000.00" 表示该交易对在当前时间段内的最低价格。
close: "29500.00" 表示该交易对在当前时间段的收盘价格。
volume: "1000.00" 表示在当前时间段内交易的该交易对的数量。单位通常是基础货币（此处为BTC）。

注意事项：

价格和交易量数据通常具有时间敏感性，请注意API提供商提供的更新频率。
数据类型（例如，字符串）可能需要根据编程语言进行转换，以便进行数学运算。
实际API响应可能包含其他字段，例如时间戳、成交笔数等。

示例 (错误响应):

当API请求未能正确执行时，服务器会返回一个错误响应。以下是一个具体的例子，展示了当请求中包含无效的交易对代码（symbol）时，API可能返回的错误信息：

{
     "code": 400,
    "message":  "Invalid parameter: symbol"
}

详细解释：

code : HTTP 状态码 400 表示“错误请求”。这意味着客户端提交的请求在语法上存在错误，服务器无法理解或处理。在这种情况下，错误的参数导致了请求失败。
message : 这是一个描述性消息，明确指出问题所在。"Invalid parameter: symbol" 表明 symbol 参数的值不正确。可能的原因包括：
- 交易对代码不存在。
- 交易对代码格式不正确（例如，大小写错误、缺少分隔符）。
- 用户尝试访问其权限不允许访问的交易对。

应对策略：

当收到此类错误响应时，开发者应该：

仔细检查请求中 symbol 参数的值，确保其拼写正确，并且是平台支持的有效交易对代码。
查阅API文档，确认正确的交易对代码格式和可用交易对列表。
检查用户的访问权限，确保他们有权访问请求的交易对。
审查代码逻辑，避免在构建API请求时出现错误。

通过正确处理此类错误响应，可以有效地调试API集成问题，并确保应用程序的稳定性和可靠性。

错误处理

在使用 BigONE API 进行交易、数据查询或其他操作时，客户端应用程序可能会遇到各种类型的错误。妥善处理这些错误对于保证应用程序的稳定性和可靠性至关重要。BigONE API 使用标准的 HTTP 状态码来指示请求的结果。以下列出了一些常见的错误类型及其可能的原因和处理建议：

400 Bad Request (错误请求) :
此错误通常表示客户端发送的请求格式不正确，或者包含无效的参数。常见原因包括：
- 请求体中的 JSON 格式错误。
- 请求参数缺失或类型不正确。
- 参数值超出允许的范围。
处理建议 : 仔细检查请求参数的名称、类型和值是否符合 API 文档的要求。使用合适的工具（如 JSON 验证器）来验证请求体的格式。
401 Unauthorized (未授权) :
此错误表示客户端未提供有效的身份验证凭据，或者提供的凭据已过期或被撤销。在使用需要身份验证的API端点时，必须在请求头中包含有效的API密钥。

处理建议 : 确认 API 密钥是否正确配置，并且没有被禁用或过期。检查请求头中是否正确包含了 `Authorization` 字段，并且其值是有效的 API 密钥。
403 Forbidden (禁止访问) :
此错误表示客户端已通过身份验证，但没有足够的权限访问请求的资源。即使提供了正确的API密钥，也可能由于帐户权限不足而导致此错误。

处理建议 : 检查你的 API 密钥是否具有访问所需资源的权限。联系 BigONE 技术支持以确认你的帐户权限是否正确。
404 Not Found (未找到) :
此错误表示请求的资源不存在。可能是由于 API 端点 URL 拼写错误，或者请求的资源已被删除或移动。

处理建议 : 仔细检查请求的 URL 是否正确，并确保所请求的资源仍然存在。
429 Too Many Requests (请求过多) :
此错误表示客户端在短时间内发送了过多的请求，超过了 API 的速率限制。为了保护 API 的稳定性和可用性，BigONE 对 API 请求频率进行了限制。

处理建议 :
- 降低请求频率，并确保不超过 API 的速率限制。
- 实施重试机制，在遇到 429 错误时，等待一段时间后再次尝试发送请求。
- 使用 API 提供的速率限制信息（通常在响应头中）来动态调整请求频率。
500 Internal Server Error (服务器内部错误) :
此错误表示服务器在处理请求时遇到了意外的错误。这通常是服务器端的问题，客户端无法直接解决。

处理建议 : 等待一段时间后再次尝试发送请求。如果问题仍然存在，请联系 BigONE 技术支持并提供详细的错误信息。

在处理 API 错误时，应该根据具体的错误码和错误信息采取相应的措施。除了上述建议之外，还应该记录错误日志以便于调试和问题排查。实施适当的错误处理机制可以提高应用程序的健壮性和用户体验。例如，如果遇到 429 错误，你的应用程序应该暂停发送请求一段时间，然后在稍后重试。你也可以分析错误日志以发现并修复应用程序中的潜在问题。

交易注意事项

在使用 BigONE API 进行交易时，务必仔细阅读并理解以下重要事项，以确保交易的安全性和效率：

风险提示 : 加密货币交易具有高风险特性，价格波动剧烈且不可预测。在进行任何交易之前，请务必充分了解加密货币市场的潜在风险，包括但不限于价格波动风险、流动性风险、政策风险以及技术风险。谨慎评估自身的风险承受能力，理性投资，切勿超出自身经济承受范围。BigONE不对您的交易决策负责，请您独立承担所有交易风险。
资金安全 : API 密钥（API Key）和私钥（Secret Key）是访问您 BigONE 账户的凭证，务必将其视为高度敏感信息，妥善保管，切勿泄露给任何第三方。请勿将密钥存储在不安全的环境中，例如公共电脑或共享服务器。建议定期更换 API 密钥，并启用 BigONE 提供的双重验证（2FA）等安全措施，进一步加强账户安全。一旦发现密钥泄露，请立即禁用并更换密钥。
市场流动性 : 加密货币市场的流动性会直接影响订单的执行效率和最终成交价格。流动性不足时，可能会导致订单无法及时成交，或者以远高于或低于预期价格成交。尤其是在交易量较小的币种或市场深度不足的情况下，更容易出现滑点。交易前请务必关注市场深度和交易量，并合理设置订单类型和价格，以降低流动性风险。
API 限制 : BigONE API 为了保障系统稳定性和公平性，对请求频率和数量设置了限制。超出限制可能会导致 API 访问被暂时或永久限制。在使用 API 进行交易前，请务必详细阅读 BigONE 官方文档，了解 API 的各项限制，包括每分钟请求次数、每日请求次数等。合理控制请求频率，避免触发限制，影响交易。建议使用批量请求接口，减少请求次数，提高效率。同时，注意监控API返回的状态码，及时处理错误信息。

Websocket API

除了传统的 REST API，BigONE 还提供强大的 WebSocket API，旨在为用户提供实时的市场数据和交易信息流。与 REST API 的请求-响应模式不同，WebSocket API 采用持久连接，允许服务器主动推送数据到客户端，极大地降低了延迟，并显著提高了数据更新的效率。这种近乎实时的特性对于需要快速响应市场变化的交易者和应用程序至关重要。

通过 WebSocket API，您可以订阅特定交易对（如 BTC/USDT、ETH/BTC 等）的实时数据流。这些数据流包括但不限于以下内容：