KuCoin API 接口调用管理指南详解
简介
KuCoin API 提供了一套全面的程序化接口,使开发者能够以自动化方式与 KuCoin 数字资产交易平台进行交互。 通过这些 API,用户可以构建定制化的交易策略、实时监控市场动态、高效管理账户资金,并执行一系列交易操作,而无需手动干预。 本文深入探讨 KuCoin API 的调用和管理机制,旨在为开发者提供详细的指导,助力他们充分利用 KuCoin API 构建功能强大的交易应用程序、量化交易系统以及其他创新型金融科技解决方案。
KuCoin API 允许用户执行以下关键操作:
- 交易执行: 自动化下单、撤单,支持市价单、限价单等多种订单类型,满足不同的交易需求。
- 市场数据获取: 实时获取行情数据,包括最新成交价、交易量、深度图等,为交易决策提供数据支持。
- 账户管理: 查询账户余额、交易历史、订单状态等信息,方便用户全面了解账户状况。
- WebSocket 推送: 订阅实时市场数据和账户信息,以低延迟的方式接收数据更新。
本文将重点介绍以下内容,以帮助开发者更好地使用 KuCoin API:
- API 认证: 安全地访问 KuCoin API 的方法,包括 API 密钥的生成和管理。
- API 调用频率限制: 理解和遵守 KuCoin API 的调用频率限制,避免触发限制并影响应用程序的正常运行。
- 错误处理: 识别和处理 API 调用过程中可能出现的错误,确保应用程序的稳定性和可靠性。
- 最佳实践: 提供一些使用 KuCoin API 的最佳实践建议,帮助开发者编写高效、安全的代码。
准备工作
在使用 KuCoin API 之前,您需要进行一系列的准备,以确保安全、高效地进行交易和数据访问。
- 注册 KuCoin 账户: 访问 KuCoin 官方网站 (kucoin.com) 并按照注册流程创建一个账户。确保使用安全的密码,并启用双重验证(2FA),以增强账户的安全性。
- 完成 KYC 认证: 为了解锁 KuCoin API 的全部功能,并提高账户的交易限额,强烈建议您完成 KYC(Know Your Customer)身份验证。KYC 认证通常需要提供您的身份证明文件、地址证明以及其他个人信息。按照 KuCoin 的指示完成 KYC 流程,并耐心等待审核结果。完成 KYC 认证后,您将能够访问更高级别的 API 功能,并享受更高的交易限额。
- 创建 API Key: 登录您的 KuCoin 账户,导航至 "API 管理" 页面(通常位于账户设置或安全设置中)。在这里,您可以创建新的 API Key。在创建 API Key 时,务必仔细设置 API Key 的权限。您可以选择启用或禁用特定权限,例如交易权限(允许使用 API 进行买卖操作)、读取权限(允许获取市场数据和账户信息)、提现权限(允许使用 API 进行提现操作)。同时,为了进一步提高安全性,强烈建议您设置 IP 限制,只允许特定的 IP 地址或 IP 地址段访问您的 API Key。请务必妥善保管您的 API Key 和 Secret Key,切勿将其泄露给他人。Secret Key 仅在创建 API Key 时显示一次,请务必将其安全保存。如果您的 API Key 或 Secret Key 泄露,请立即删除并重新创建一个新的 API Key。
- 选择编程语言和 SDK: 根据您的技术背景和项目需求,选择您熟悉的编程语言(例如 Python、Java、JavaScript、Go、C# 等)。然后,查找适用于您选择的编程语言的 KuCoin API SDK。SDK 可以简化 API 的调用过程,并提供常用的功能,例如签名生成、请求发送和响应解析。如果您找不到合适的 SDK,您也可以直接使用 HTTP 请求库(例如 Python 的 requests 库、Java 的 HttpClient 库)来调用 KuCoin API。在使用 HTTP 请求库时,您需要自行处理 API 签名、请求头设置和响应解析等细节。
API 认证
KuCoin API 通过 API Key、Secret Key 和 passphrase 三重认证机制来确保账户安全和数据完整性。这种认证方式允许开发者安全地访问和管理其 KuCoin 账户,进行交易、获取市场数据等操作。
- API Key: 这是一个公开的密钥,用于唯一标识您的身份。类似于用户名,它告诉 KuCoin 服务器哪个用户正在发起请求。API Key 应该被视为公开信息,但切勿与他人分享 Secret Key 和 passphrase。
- Secret Key: 这是一个私密的密钥,用于对 API 请求进行签名。它类似于您的密码,必须严格保密。Secret Key 用于验证请求的真实性和完整性,防止恶意篡改。
- Passphrase: 这是您在创建 API Key 时设置的自定义密码,它进一步增强了安全性。Passphrase 与 Secret Key 结合使用,共同生成请求签名。请务必设置一个强密码,并妥善保管。
所有对 KuCoin API 的请求都需要在 HTTP Header 中包含特定的信息,以完成认证。这些信息将由 KuCoin 服务器验证,以确保请求的合法性和安全性。
-
KC-API-KEY
: 您唯一的 API Key,用于识别您的账户。将此值设置为您的 API Key 字符串。 -
KC-API-SIGN
: 使用您的 Secret Key 和 passphrase 对请求内容(包括请求路径、查询参数、请求体和时间戳)进行哈希运算后生成的签名字符串。此签名用于验证请求的完整性,确保数据未被篡改。签名算法通常为 HMAC-SHA256。 -
KC-API-TIMESTAMP
: 当前 Unix 时间戳(以秒为单位)。时间戳用于防止重放攻击,确保请求的时效性。服务器会检查时间戳的有效性,超出一定时间范围的请求将被拒绝。 -
KC-API-PASSPHRASE
: 您在创建 API Key 时设置的 passphrase。在生成签名时需要使用此 passphrase。请确保 passphrase 的准确性,否则签名验证将会失败。 -
KC-API-KEY-VERSION
: API Key 的版本号,用于标识 API Key 的生成方式和支持的功能。目前 KuCoin API 使用的版本为2
。
签名生成方法:
在与加密货币交易所API进行交互时,为了保障数据安全,需要对请求进行签名。本节详细介绍签名生成过程,确保请求的真实性和完整性。
-
构建签名字符串:
将以下四个要素按照指定顺序拼接成一个字符串,该字符串将作为后续 HMAC-SHA256 加密的输入:
-
timestamp
: 请求发起时的 Unix 时间戳,精确到秒。务必使用服务器时间,防止因本地时间偏差导致签名验证失败。 -
method
: HTTP 请求方法,必须是大写,例如GET
、POST
、PUT
、DELETE
。 -
requestPath
: API 接口的绝对路径,包含版本号,例如/api/v1/market/tickers
。注意区分不同版本的 API 路径。 -
requestBody
: 如果请求包含 Body(例如,POST 请求的 JSON 数据),则为 Body 的字符串内容;如果没有 Body,则为空字符串""
。对于 JSON 数据,需确保按照字典排序并序列化为字符串,以保证签名的一致性。
示例:
1678886400GET/api/v1/market/tickers
或1678886400POST/api/v1/orders{"symbol":"BTC-USDT","side":"buy","type":"market","size":"1"}
-
-
HMAC-SHA256 加密:
使用 Secret Key 和 passphrase 作为密钥,对上一步构建的字符串进行 HMAC-SHA256 加密。 Secret Key 是您的账户私钥,务必妥善保管,切勿泄露。passphrase 是您在创建 API 密钥时设置的口令,也需要保密。
HMAC (Hash-based Message Authentication Code) 是一种消息认证码算法,结合了密钥和哈希函数,用于验证消息的完整性和真实性。SHA256 是一种常用的安全哈希算法,输出 256 位的哈希值。
-
Base64 编码:
将 HMAC-SHA256 加密后的二进制结果进行 Base64 编码,得到最终的签名字符串。 Base64 是一种将二进制数据转换成 ASCII 字符串的编码方式,方便在 HTTP Header 中传输。
以下是一个 Python 示例,演示如何生成签名:
import time
import hmac
import hashlib
import base64
# 请替换成您自己的 API Key、Secret Key 和 passphrase
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
passphrase = "YOUR_PASSPHRASE"
def generate_signature(timestamp, method, request_path, request_body):
"""
生成请求签名。
Args:
timestamp (str): Unix 时间戳.
method (str): HTTP 方法 (GET, POST, PUT, DELETE).
request_path (str): API 接口路径.
request_body (str): 请求 Body (JSON 字符串).
Returns:
str: Base64 编码后的签名字符串.
"""
message = timestamp + method + request_path + request_body
mac = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
mac.update(passphrase.encode('utf-8'))
signature = base64.b64encode(mac.digest()).decode('utf-8')
return signature
# 示例参数
timestamp = str(int(time.time()))
method = "GET"
request_path = "/api/v1/market/tickers"
request_body = ""
# 生成签名
signature = generate_signature(timestamp, method, request_path, request_body)
# 构建 HTTP Header
headers = {
"KC-API-KEY": api_key,
"KC-API-SIGN": signature,
"KC-API-TIMESTAMP": timestamp,
"KC-API-PASSPHRASE": passphrase,
"KC-API-KEY-VERSION": "2" # 推荐使用 API 版本 2
}
# 打印 Header,用于调试
print(headers)
注意事项:
-
KC-API-KEY-VERSION
: API 版本号,强烈建议使用"2"
,因为它提供了更强的安全性和功能。 - 时间戳的同步至关重要。请确保您的服务器时间与交易所服务器时间同步,误差应尽量小。
- Secret Key 和 passphrase 必须妥善保管。切勿硬编码到客户端代码中,避免泄露。
- 在生产环境中,建议使用更安全的密钥管理方案,例如硬件安全模块 (HSM) 或密钥管理服务 (KMS)。
- 对包含 JSON 数据的 POST 请求,务必对 JSON 数据进行规范化处理,例如排序键值对、去除多余空格等,确保签名的一致性。
- 不同的交易所可能采用不同的签名方法,请仔细阅读交易所的 API 文档。
使用您喜欢的 HTTP 请求库发送请求
例如:
import requests
response = requests.get("https://api.kucoin.com/api/v1/market/tickers", headers=headers)
print(response.())
常用 API 接口
以下是一些常用的 KuCoin API 接口,它们提供了访问市场数据、管理账户和执行交易的关键功能。 在开始使用 API 之前,请务必阅读 KuCoin 官方 API 文档,了解所有参数、限制和最佳实践,以确保应用程序的稳定性和安全性。
-
市场数据:
-
/api/v1/market/tickers
: 获取所有交易对的最新价格和交易量信息。此接口提供快速的市场概览,包括交易对的最新成交价、最高价、最低价、成交量(过去24小时)以及价格变动百分比。 这些信息对于快速评估市场趋势和识别潜在的交易机会至关重要。 -
/api/v1/market/orderbook/level2_{depth}
: 获取指定交易对的深度订单簿 (depth 可以是 5, 20, 50, 100)。 订单簿显示了买单和卖单的价格和数量,`depth`参数控制显示的订单簿深度。 较高的深度值提供更完整的市场视图,而较低的深度值则提供更简洁的信息。 level2 订单簿数据提供了比 level1 更精细的市场结构信息,有助于识别支撑位和阻力位。 -
/api/v1/market/candles
: 获取指定交易对的历史 K 线数据。 K 线图是技术分析的基础,通过调整时间间隔(例如,1分钟、5分钟、1小时、1天),可以观察不同时间范围内的价格走势。 此接口允许您获取开盘价、最高价、最低价、收盘价和成交量等数据,用于构建各种技术指标和交易策略。 不同的交易所或数据提供商对于K线数据的定义可能会略有差异,请仔细阅读文档。
-
-
账户信息:
-
/api/v1/accounts
: 获取所有账户信息。 此接口返回与您的 API 密钥关联的所有账户的列表,包括账户类型(例如,交易账户、保证金账户)、可用余额和冻结余额。 请注意,您需要有效的 API 密钥和权限才能访问此接口。 -
/api/v1/accounts/
: 获取指定账户信息。 通过提供特定的 `account_id`,您可以获取该账户的详细信息,包括余额、已实现的盈亏和未实现的盈亏。 账户 ID 是唯一标识符,用于区分您的不同类型的账户。
-
-
交易:
-
/api/v1/orders
: 下单、撤单、查询订单。 此接口是交易操作的核心,允许您创建新的订单、取消未完成的订单以及查询订单的状态。 下单需要指定交易对、订单类型(例如,市价单、限价单)、买卖方向和数量。 撤单需要提供要取消的订单的 ID。 查询订单可以根据订单 ID 或其他参数过滤。 -
/api/v1/orders/
: 获取指定订单信息。 通过提供 `order_id`,您可以获取有关特定订单的详细信息,包括订单状态(例如,已提交、已部分成交、已完全成交、已取消)、成交价格、成交数量和手续费。 此接口对于监控订单执行情况和分析交易结果至关重要。
-
-
WebSocket API:
- 使用 WebSocket 连接可以实时接收市场数据和账户信息。 WebSocket 是一种持久连接协议,允许服务器主动向客户端推送数据,而无需客户端发送请求。 这对于需要实时数据更新的应用程序非常有用,例如交易机器人和实时图表。 KuCoin WebSocket API 提供了各种频道,用于订阅不同的市场数据和账户事件。 使用WebSocket API 需要进行身份验证,并遵循 KuCoin 的速率限制。
API 调用示例
以下是一个 Python 示例,展示如何使用 KuCoin API 获取所有交易对的最新价格和交易量信息。该示例详细展示了如何构造认证头部,发起 API 请求,以及处理响应数据。在使用前,请确保您已拥有 KuCoin 账户,并生成了 API 密钥、密钥和密码。
import time
import hmac
import hashlib
import base64
import requests
import # 引入库,用于处理JSON格式的API响应
api_key = "YOUR_API_KEY" # 替换为你的API密钥
secret_key = "YOUR_SECRET_KEY" # 替换为你的密钥
passphrase = "YOUR_PASSPHRASE" # 替换为你的密码
api_url = "https://api.kucoin.com" # KuCoin API 的基本URL
def generate_signature(timestamp, method, request_path, request_body):
"""
生成 KuCoin API 请求所需的签名。
签名通过 HMAC-SHA256 算法,结合密钥、时间戳、HTTP 方法、请求路径和请求体计算得出。
"""
message = timestamp + method + request_path + request_body
mac = hmac.new(bytes(secret_key, 'utf-8'), bytes(message, 'utf-8'), hashlib.sha256)
mac.update(bytes(passphrase, 'utf-8'))
signature = base64.b64encode(mac.digest())
return signature.decode('utf-8')
def get_all_tickers():
"""
获取所有交易对的最新价格和交易量信息。
该函数构造 API 请求,包括认证头部,并处理响应数据。
"""
timestamp = str(int(time.time()))
method = "GET"
request_path = "/api/v1/market/tickers"
request_body = ""
signature = generate_signature(timestamp, method, request_path, request_body)
headers = {
"KC-API-KEY": api_key,
"KC-API-SIGN": signature,
"KC-API-TIMESTAMP": timestamp,
"KC-API-PASSPHRASE": passphrase,
"KC-API-KEY-VERSION": "2" # 显式指定API版本
}
try:
response = requests.get(api_url + request_path, headers=headers)
response.raise_for_status() # 抛出HTTPError,以处理错误的状态码
data = response.() # 使用()方法解析JSON响应
if data["code"] == "200000":
return data["data"]["ticker"]
else:
print(f"API Error: {data['code']} - {data['msg']}")
return None
except requests.exceptions.RequestException as e:
print(f"HTTP Error: {e}") # 更加详细的错误信息
return None
signature = generate_signature(timestamp, method, request_path, request_body)
headers = {
"KC-API-KEY": api_key,
"KC-API-SIGN": signature,
"KC-API-TIMESTAMP": timestamp,
"KC-API-PASSPHRASE": passphrase,
"KC-API-KEY-VERSION": "2"
}
response = requests.get(api_url + request_path, headers=headers)
if response.status_code == 200:
data = response.()
if data["code"] == "200000":
return data["data"]["ticker"]
else:
print(f"API Error: {data['code']} - {data['msg']}")
return None
else:
print(f"HTTP Error: {response.status_code}")
return None
if __name__ == "__main__":
tickers = get_all_tickers()
if tickers:
for symbol, info in tickers.items():
print(f"Symbol: {symbol}, Last Price: {info['last']}, Volume: {info['vol']}") # 增加交易量显示
else:
print("Failed to retrieve tickers.")
API 调用注意事项
-
频率限制:
KuCoin API 为了保障系统稳定性和公平性,实施了频率限制策略。请务必仔细查阅官方文档中关于请求频率的具体规定,包括每个接口的限制次数以及重置周期。频繁超出限制可能导致您的请求被暂时或永久阻止,并收到
429 Too Many Requests
错误。建议您实现请求排队或指数退避机制,以避免触发频率限制。同时,合理规划API调用策略,避免不必要的请求,优化数据获取效率。 - 错误处理: 在进行API集成时,完善的错误处理机制至关重要。请认真解析API返回的JSON数据,特别是错误码和错误信息字段。根据不同的错误码,采取相应的处理措施,例如,对于权限不足的错误,检查API Key的权限配置;对于参数错误的错误,修正请求参数;对于服务器内部错误,进行重试或联系技术支持。针对常见错误,编写相应的处理函数,提高代码的健壮性和容错能力。
- 数据安全: API Key 和 Secret Key 是访问 KuCoin API 的重要凭证,务必妥善保管,切勿泄露给他人。为了增强安全性,强烈建议启用 IP 限制功能,只允许来自特定 IP 地址的请求访问API。定期更换 API Key 和 Secret Key,并使用安全的存储方式(例如,加密存储)来保护这些敏感信息。避免将API Key 和 Secret Key 存储在代码中或提交到公共代码仓库。
- 版本更新: KuCoin API 会定期进行版本更新,以引入新的功能、优化性能或修复漏洞。请密切关注官方文档、更新日志以及社区公告,及时了解API的最新变化。为了保证您的应用程序能够正常运行,建议您定期检查并更新您的代码,以兼容最新的API版本。升级前,务必进行充分的测试,以确保升级过程不会影响现有功能。
- 参数校验: 在调用 API 之前,必须对所有请求参数进行严格的校验,确保它们符合 API 的数据类型、取值范围以及格式要求。例如,检查日期时间格式是否正确,数字是否在允许范围内,字符串长度是否符合要求等等。进行参数校验可以有效避免因参数错误导致的API调用失败,提高程序的稳定性和可靠性。利用编程语言提供的校验工具或自定义校验函数,可以简化参数校验的过程。
- 精度问题: 数字货币交易涉及到高精度的数值计算,必须注意数据类型的选择和计算方式,以避免出现精度损失。建议使用高精度的数据类型(例如,Decimal)来存储和处理数字货币相关的数据。在进行加减乘除运算时,使用高精度的计算方法,并注意舍入规则。避免使用浮点数进行精确计算,因为浮点数在计算机中的存储方式可能导致精度误差。同时,需要了解 KuCoin API 中各个参数的精度要求,确保传递的数据符合精度标准。
WebSocket API
KuCoin WebSocket API 提供了一种高效且实时的途径,用于访问市场数据和账户信息。与传统的 REST API 相比,WebSocket API 建立的是持久的双向通信连接,服务器可以在数据更新时主动推送信息给客户端,而无需客户端发起重复的请求。这种机制显著降低了延迟,并且极大地减少了客户端的资源消耗,避免了频繁轮询操作带来的性能瓶颈。
通过订阅不同的频道,您可以接收各种类型的实时数据,例如:
- 实时市场行情: 包括最新成交价格、成交量、买卖盘口信息等。这使交易者能够快速响应市场变化,抓住交易机会。
- K线数据: 不同时间周期的K线图数据,例如1分钟、5分钟、1小时等,方便技术分析和策略制定。
- 逐笔成交: 每一笔交易的详细信息,包括成交时间、价格和数量,提供更精细的市场观察视角。
- 账户信息: 账户余额、持仓情况、订单状态等,方便用户监控账户动态。
使用 WebSocket API 的优势在于:
- 低延迟: 数据实时推送,延迟极低,适用于高频交易和快速决策。
- 高效率: 避免频繁轮询,降低客户端和服务器的资源消耗。
- 实时性: 实时获取市场动态和账户信息,及时掌握市场脉搏。
- 双向通信: 客户端可以发送控制指令,例如订阅频道、取消订阅等。
要使用 KuCoin WebSocket API,您需要:
- 获取 API 密钥和密钥密码。
- 连接到 KuCoin WebSocket 服务器。
- 进行身份验证。
- 订阅感兴趣的频道。
- 处理接收到的数据。
KuCoin 提供了详细的文档和示例代码,帮助开发者快速上手 WebSocket API。 请参考官方文档了解更多细节和最佳实践,从而构建稳定可靠的实时交易应用。
连接地址:
KuCoin WebSocket API 的连接地址为:
wss://ws-api.kucoin.com/endpoint
。 该地址是您与 KuCoin 交易所建立实时数据连接的关键入口点。 通过 WebSocket 协议,您可以订阅各种市场数据流,例如实时交易价格、订单簿更新和ticker信息,而无需轮询。
wss://
前缀表示 WebSocket 连接是通过安全加密的 TLS/SSL 通道建立的,确保数据传输的安全性。 请务必使用此安全连接地址,以防止中间人攻击和数据泄露。
为了成功建立连接,您需要使用兼容 WebSocket 协议的客户端库。 不同的编程语言都提供了相应的库,例如 JavaScript 的
ws
库,Python 的
websockets
库等。选择适合您开发环境的库,并确保正确配置身份验证信息(如果需要)。
在连接后,您可以使用 KuCoin WebSocket API 提供的订阅和取消订阅功能,选择您感兴趣的频道和主题。 例如,您可以订阅特定交易对的实时交易数据,或者整个市场的订单簿快照。 请参考 KuCoin 官方 API 文档,了解可用的频道和消息格式。
请注意,KuCoin WebSocket API 可能会根据市场情况和系统维护进行更新。 建议您定期查阅 KuCoin 官方文档,以获取最新的连接地址和 API 使用说明。 请遵守 KuCoin 交易所的 API 使用条款和限制,避免过度请求或滥用 API 资源。
订阅频道:
您可以通过发送 JSON 消息来订阅不同的频道,以实时获取市场数据。订阅消息需符合特定格式,并发送至指定的 WebSocket 端点。以下示例展示了如何订阅 KuCoin 交易所 BTC-USDT 交易对的深度订单簿(Level 2 数据)。深度订单簿包含多个买单和卖单的价格和数量,提供更全面的市场深度信息。
以下 JSON 消息展示了如何订阅特定频道:
{
"type": "subscribe",
"topic": "/market/level2:BTC-USDT",
"id": "12345" // 可选,用于区分不同的订阅
}
字段解释:
-
type
: 消息类型,设置为 "subscribe" 表示订阅频道。 -
topic
: 订阅的主题,格式为 "/market/level2:交易对",其中 "交易对" 需要替换为实际的交易对,例如 "BTC-USDT"、"ETH-BTC" 等。/market/level2
表示订阅该交易对的 Level 2 深度订单簿数据。有些交易所可能提供其他类型的topic,比如/market/ticker:交易对
用于订阅交易对的ticker数据(最新成交价、成交量等)。 -
id
: (可选) 订阅 ID,用于区分不同的订阅请求。如果同时订阅了多个频道,建议为每个订阅分配一个唯一的 ID,以便在收到数据时能够区分数据来源。该字段类型通常为字符串或数字。
其他订阅示例:
- 订阅 ETH-USDT 交易对的 ticker 数据:
{
"type": "subscribe",
"topic": "/market/ticker:ETH-USDT",
"id": "eth_ticker"
}
{
"type": "subscribe",
"topic": "/market/trade:BTC-USDT",
"id": "btc_trades"
}
重要提示:
- 请务必参考交易所的官方 API 文档,以获取准确的频道名称和数据格式。不同交易所的 API 规范可能存在差异。
- 有些交易所可能对订阅频率或订阅数量有限制。请遵守交易所的 API 使用规则,避免被限制访问。
- 订阅成功后,交易所会通过 WebSocket 连接推送数据。你需要编写相应的代码来处理接收到的数据。
常用频道:
-
/market/ticker:{symbol}
: 实时价格和交易量信息。此频道提供指定交易对(例如 BTC/USDT)的最新成交价、24 小时交易量、最高价、最低价等关键数据,是监控市场动态的核心频道。{symbol}
需替换为具体的交易对代码,如BTC-USDT
。 -
/market/level2:{symbol}
: 实时深度订单簿。通过订阅此频道,您可以获取市场上买单和卖单的实时分布情况,深度了解市场买卖力量对比。订单簿信息对于高频交易和策略制定至关重要。{symbol}
同样需要替换为具体交易对,数据更新频率较高,请注意处理性能。 -
/market/candles:{symbol}_{type}
: 实时 K 线数据。{symbol}
代表交易对,{type}
代表 K 线周期,例如1min
代表 1 分钟 K 线,5min
代表 5 分钟 K 线,以此类推,可选周期包括1min
,5min
,15min
,30min
,1hour
,8hour
,1day
,1week
。K 线数据是技术分析的基础,通过此频道可以构建各种技术指标和交易策略。例如:/market/candles:BTC-USDT_15min
订阅 BTC/USDT 的 15 分钟 K 线。 -
/account/balance
: 实时账户余额信息。此频道提供您在交易所账户中的资产余额情况,包括可用余额、冻结余额等。订阅此频道需要进行身份验证,以确保账户安全。该频道实时更新,方便您及时了解账户资金变动。 -
/trade/execution
: 实时交易执行信息。通过此频道,您可以获取您的交易订单的实时执行情况,包括成交价格、成交数量、交易手续费等信息。订阅此频道同样需要进行身份验证,保证交易信息的安全性。
请参考 KuCoin 官方文档了解更多关于 WebSocket API 的信息,包括身份验证方法、请求频率限制、错误代码说明以及更高级的频道订阅方式。