Bithumb API 交易：新手指南！你不能错过的关键步骤！

Bithumb API 设置详细教程

1. 注册 Bithumb 账户并完成身份验证

开始使用 Bithumb API 之前，您必须拥有一个 Bithumb 账户。如果您还没有账户，请访问 Bithumb 官方网站 (www.bithumb.com) 进行注册。注册流程通常需要提供一个有效的邮箱地址，并设置一个安全强度高的密码。请务必使用未在其他平台使用过的复杂密码，并启用双重验证（2FA），以增强账户的安全性，防止潜在的安全风险。

成功注册后，为了能够充分利用 Bithumb API 的全部功能，特别是进行交易操作，您需要完成身份验证（KYC）。Bithumb 对 API 交易用户的身份验证等级要求通常更高，这是为了符合监管要求，并确保交易的合法性和安全性。请仔细阅读 Bithumb 官方网站或应用程序中关于 KYC 要求的说明，按照指示逐步完成验证流程。您可能需要提供包括但不限于护照、身份证、居住证明等个人身份证明文件。请确保您上传的文件清晰可辨，并且信息准确无误，这可以加快验证速度。身份验证过程可能需要几个工作日才能完成，在此期间请耐心等待 Bithumb 官方的审核结果。 在完成身份验证之前，您可能无法使用某些 API 功能，尤其是涉及资金操作的功能。

2. 开启 API 功能

完成身份验证后，访问 Bithumb 交易所的官方网站并登录您的账户。 导航至您的用户设置或账户安全中心，通常在此处可以找到 "API 管理" 或类似的选项。 请注意，Bithumb 的用户界面可能随时间推移而变化，建议仔细浏览相关菜单以定位 API 设置。

激活 API 功能通常需要额外的安全验证措施。 例如，系统可能会提示您使用 Google Authenticator 应用生成的验证码，或者通过短信接收验证码。 请严格按照 Bithumb 网站上的说明进行操作，以确保 API 功能成功启用并绑定到您的账户。

3. 创建 API 密钥

在 Bithumb 账户的 API 管理页面，你可以生成新的 API 密钥对，包括公钥（API Key）和私钥（Secret Key）。创建 API 密钥时，务必根据你的具体使用场景，为其配置最小权限原则。不必要的权限授予会增加账户安全风险。

Bithumb API 通常提供细粒度的权限控制，以下是常见的权限选项及其详细说明：

• 查询权限 (Info API/行情信息权限): 允许你通过 API 接口查询各种市场数据和账户相关信息。具体包括：实时行情数据（价格、交易量等）、历史交易记录、订单簿深度、账户余额查询、持仓信息查询等。此权限通常是只读权限，无法进行交易操作。
• 交易权限 (Trade API/交易下单权限): 允许你通过 API 接口执行买入和卖出操作。具体包括：创建限价单、市价单，撤销订单，查询订单状态，查询成交明细等。在使用此权限时，务必谨慎编写交易逻辑，并充分测试，以避免意外交易发生。
• 提现权限 (Withdrawal API/资金提取权限): 允许你通过 API 接口将加密货币从 Bithumb 账户转移到其他地址。 强烈建议你禁用此权限，除非你确实需要自动提现功能，并且已经充分理解由此带来的潜在安全风险。开启提现权限后，一旦 API 密钥泄露，你的资产将面临被盗风险。务必采取严格的安全措施，例如IP地址白名单限制。

非常重要： 为了安全起见，请根据你的实际需求，授予 API 密钥最小的权限。 例如，如果你只需要读取市场数据，那么只需要授予查询权限，而不需要授予交易权限。 并且，强烈建议不要开启提现权限，除非你有非常明确的需求，并且明白滥用此权限的后果。 任何密钥的泄露都可能导致你的资金损失。

在创建 API 密钥时，系统会生成两个字符串：

• API Key (API 密钥): 相当于你的用户名。
• Secret Key (密钥): 相当于你的密码。

务必妥善保管你的 API Key 和 Secret Key！ 它们是访问 Bithumb API 的凭证。 不要将它们泄露给任何人。 建议将它们存储在安全的地方，例如加密的文本文件或者密码管理器中。 API Key 和 Secret Key 通常只会显示一次，之后你将无法再次查看 Secret Key。 如果你忘记了 Secret Key，你必须删除当前的 API 密钥并创建一个新的。

4. 理解 Bithumb API 的基本概念

在使用 Bithumb API 之前，深入理解其基本概念至关重要，这能确保你有效地与交易所进行交互并构建可靠的应用程序。

• RESTful API： Bithumb API 遵循 RESTful (Representational State Transfer) 架构风格。这意味着你可以利用标准的 HTTP 方法，如 GET (获取资源), POST (创建资源), PUT (更新资源), 和 DELETE (删除资源)，来与 Bithumb 服务器进行通信。 RESTful API 的设计原则包括无状态性、可缓存性以及分层系统，这些都有助于提高 API 的可伸缩性和可靠性。 例如，使用 GET 方法可以请求市场数据，而使用 POST 方法可以提交交易订单。理解每种 HTTP 方法的语义对于正确使用 API 至关重要。
• Endpoint (端点)： 每个 API 功能都通过一个唯一的 Endpoint 暴露出来。Endpoint 本质上是一个 URL，它指向服务器上特定的资源或功能。 例如，获取市场最新交易价格的 Endpoint 可能是 /public/ticker ，提交一个新的限价订单的 Endpoint 可能是 /trade/place 。 Endpoint 的命名通常具有描述性，以便开发者可以快速理解其用途。 仔细阅读 Bithumb API 文档，了解每个 Endpoint 的具体功能和用法。
• Parameters (参数)： 当你发送 API 请求时，可能需要提供一些参数来精确地指定你的需求。这些参数可以控制请求的行为，例如筛选数据、指定交易对或设置交易数量。 参数通常以键值对的形式传递，可以通过 URL 查询字符串或请求体来传递。例如，要获取 BTC/KRW 交易对的行情，你需要将 symbol=BTC_KRW 作为参数添加到请求中。 不同的 Endpoint 可能需要不同的参数，因此务必查阅 API 文档以了解每个 Endpoint 的必需和可选参数。
• Response (响应)： Bithumb 服务器在收到你的 API 请求后，会返回一个响应。该响应包含了你请求的数据或操作的结果。 响应通常采用 JSON (JavaScript Object Notation) 格式，这是一种轻量级的数据交换格式，易于解析和处理。 响应中可能包含诸如市场行情数据、订单状态、账户余额或错误信息等内容。 理解响应的结构和每个字段的含义对于编写能够正确处理 API 返回数据的应用程序至关重要。 同时，需要注意处理可能出现的错误代码和消息。
• Rate Limiting (频率限制)： 为了保护 API 的稳定性和可用性，并防止恶意滥用，Bithumb 对 API 请求的频率进行了限制。 这意味着你在一定时间内只能发送一定数量的请求。 如果你的请求频率超过了限制，服务器可能会返回错误代码 (例如 429 Too Many Requests)，并且你的请求可能会被拒绝。 Bithumb 通常会为不同的 API Endpoint 设置不同的频率限制，并且会根据用户的身份和权限进行调整。 在开发应用程序时，务必考虑到频率限制，并采取适当的措施来避免超过限制，例如使用队列来控制请求的发送速率，或者实施指数退避策略来处理被拒绝的请求。

5. 使用编程语言调用 API

为了与 Bithumb 交易所进行交互，开发者可以使用各种编程语言来调用其提供的 API。 这使得自动化交易、数据分析和集成其他系统成为可能。 常见的编程语言包括 Python、Java、JavaScript 和 Go 等。 下面我们将以 Python 为例，详细介绍如何通过编程方式调用 Bithumb 的 API。

在开始之前，你需要确保你的开发环境中已经安装了一个 HTTP 客户端库。 这种库简化了发送 HTTP 请求和处理响应的过程。 在 Python 中， requests 库是一个非常流行和易于使用的选择。 你可以使用 pip 包管理器轻松安装它： pip install requests 。

以下是一个使用 Python 调用 Bithumb API 的示例代码片段。 该示例展示了如何导入必要的库，并为后续的 API 调用做准备，包括签名生成所需的库。

import requests
import hashlib
import hmac
import base64
import time

请注意，后续的代码示例将会使用这些导入的库来构建 API 请求并处理 Bithumb 的响应。 务必仔细阅读 Bithumb 官方 API 文档，了解每个 API 端点的具体参数要求和返回格式。

你的 API Key 和 Secret Key

在使用Bithumb API之前，您需要获取API Key和Secret Key。 这些密钥用于身份验证和授权，允许您的应用程序安全地访问您的Bithumb账户并执行交易。 请务必妥善保管您的密钥，不要与他人分享。

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"

以下是一个Python函数，用于调用Bithumb API。此函数支持公共和私有API调用，并处理必要的身份验证步骤。

def bithumb_api_call(endpoint, params=None, api_key=None, secret_key=None):
"""
调用 Bithumb API 的通用函数。
"""
api_url = "https://api.bithumb.com" + endpoint
nonce = str(int(time.time() * 1000)) #Bithumb要求 nonce 为毫秒级时间戳

    if params is  None:

        params = {}


    if api_key and  secret_key:    #私有API

        # 构建签名所需的消息

        query_string  = "&".join([f"{k}={v}" for k, v in params.items()])

        if query_string:

            string_to_sign  = endpoint[5:] + chr(0)  + query_string  + chr(0)  + nonce  #endpoint[5:] 去除'/info'

        else:

            string_to_sign = endpoint[5:]  + chr(0)  + nonce


        # 使用HMAC-SHA512算法对消息进行签名

        h = hmac.new(secret_key.encode('utf-8'), string_to_sign.encode('utf-8'),  hashlib.sha512)

        signature = base64.b64encode(h.digest()).decode('utf-8')


        # 构造HTTP头部信息

        headers = {

            "Api-Key":  api_key,

            "Api-Sign": signature,

            "Api-Nonce":  nonce,

        }

        # 发送POST请求

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

    else: # 公有API

        # 发送GET请求

        response  =  requests.get(api_url, params=params)


    # 检查响应状态码

    response.raise_for_status()   #  如果响应状态码不是 200，则抛出异常

    # 返回JSON格式的响应数据

    return response.()

示例：获取 BTC/KRW 交易对的行情

通过Bithumb API获取比特币 (BTC) 与韩元 (KRW) 交易对的实时行情信息，是进行量化分析和程序化交易的重要一步。以下代码展示了如何使用Python以及 requests 库来调用Bithumb的公共API，并处理可能出现的网络请求异常。

try: 语句块用于捕获可能出现的异常，保证程序的健壮性。 ticker = bithumb api call("/public/ticker/BTC_KRW") 这行代码调用自定义的 bithumb_api_call 函数，该函数负责构造并发送HTTP请求到Bithumb的指定API端点 /public/ticker/BTC_KRW 。这个API端点专门用于获取指定交易对的实时行情数据。 函数返回的 ticker 变量包含了诸如最新成交价、最高价、最低价、交易量等关键信息。 print(ticker) 将获取到的行情数据打印到控制台，方便用户查看和进一步处理。

except requests.exceptions.RequestException as e: 语句块用于捕获 requests 库可能抛出的网络请求异常，例如连接超时、DNS解析失败等。如果出现异常， print(f"API 请求出错: {e}") 会打印包含错误信息的提示，帮助用户诊断问题。 requests.exceptions.RequestException 是一个通用的异常类，可以捕获多种网络请求相关的错误。 在实际应用中，可以根据需要捕获更具体的异常类型，例如 requests.exceptions.Timeout 或 requests.exceptions.ConnectionError ，以便进行更精细的错误处理。

示例：获取账户余额 (需要 API Key 和 Secret Key)

以下代码展示了如何通过 Bithumb API 查询指定货币的账户余额。进行此操作需要您拥有有效的 API Key 和 Secret Key，并确保已安装必要的 Python 库（例如 requests ）。

代码示例 (Python):

import requests
import 

def bithumb_api_call(endpoint, params, api_key, secret_key):
    """
    调用 Bithumb API 的通用函数。

    Args:
        endpoint (str): API 端点，例如 "/info/balance"。
        params (dict): API 请求的参数。
        api_key (str): 您的 API Key。
        secret_key (str): 您的 Secret Key。

    Returns:
        dict: API 响应的 JSON 数据。
    """
    url = f"https://api.bithumb.com/public{endpoint}" # 请注意，此处使用 public endpoint，查询余额需要使用 private endpoint。实际使用请修改为：https://api.bithumb.com/trade
    headers = {
        "Api-Key": api_key,
        "Api-Secret": secret_key,
        "Content-Type": "application/"  # 明确指定 Content-Type
    }

    try:
        response = requests.post(url, headers=headers, data=.dumps(params)) # 使用 POST 方法，并添加请求体
        response.raise_for_status()  # 检查 HTTP 状态码，如果不是 200，则抛出异常
        return response.()
    except requests.exceptions.RequestException as e:
        print(f"API 请求出错: {e}")
        return None  # 或者抛出异常，根据你的程序需求

try:
    api_key = "YOUR_API_KEY"  # 替换为您的 API Key
    secret_key = "YOUR_SECRET_KEY"  # 替换为您的 Secret Key
    params = {
        "currency": "KRW"  # 查询韩元余额
    }
    account_info = bithumb_api_call("/info/balance", params, api_key, secret_key)

    if account_info:
        print(account_info)
    else:
        print("获取账户信息失败。")

except Exception as e: # 捕获更广泛的异常类型
    print(f"程序出错: {e}")

代码解释：

• 您需要导入 requests 和 库。 requests 用于发送 HTTP 请求， 用于处理 JSON 数据。
• bithumb_api_call 函数封装了 API 调用逻辑。它接受 API 端点、参数、API Key 和 Secret Key 作为输入。
• 该函数构建 API 请求的 URL，并设置必要的 HTTP 头部，包括 API Key 和 Secret Key。为了保证安全性，请勿在客户端代码中硬编码您的 Secret Key。
• 使用 requests.post 方法发送 POST 请求，并将参数作为 JSON 数据传递。 请注意：查询余额需要使用 POST 方法，并将相关参数通过body传输。
• 使用 response.raise_for_status() 检查 HTTP 状态码。如果状态码不是 200，则会引发 HTTPError 异常，表明请求失败。
• 如果请求成功，该函数将解析 JSON 响应并返回。如果发生任何错误，该函数将打印错误消息并返回 None 。
• 在主程序中，您需要替换 YOUR_API_KEY 和 YOUR_SECRET_KEY 为您的实际 API Key 和 Secret Key。
• params 字典指定要查询的货币。在本例中，我们查询韩元 (KRW) 的余额。
• 调用 bithumb_api_call 函数获取账户信息，并打印结果。

注意事项：

• 请务必妥善保管您的 API Key 和 Secret Key，不要将其泄露给他人。
• Bithumb API 有请求频率限制。请查阅 Bithumb API 文档以了解具体的限制。
• 请根据 Bithumb API 文档正确设置 API 请求的参数。
• 实际应用中，您可能需要处理更多的错误情况，例如网络连接错误、API 权限错误等。
• 确保您的 API Key 具有查询账户余额的权限。

代码解释：

1. 导入必要的库： 为了顺利与Bithumb API交互并执行必要的加密操作，代码首先导入了以下Python库：
   • requests ：用于发送HTTP请求，这是与API进行通信的基础。它允许程序向Bithumb服务器发送各种类型的请求（GET、POST等）并接收响应。
   • hashlib ：提供多种哈希算法，例如SHA-256。虽然示例中没有直接使用SHA-256，但它是数据完整性校验和加密的基础，在更复杂的API交互中可能用到。
   • hmac ：用于生成基于哈希的消息认证码 (HMAC)。HMAC 使用一个密钥来增强哈希函数的安全性，常用于API请求的签名，以验证请求的真实性和完整性。
   • base64 ：用于将二进制数据编码为 ASCII 字符串。在API通信中，签名后的数据通常需要进行Base64编码，以便在HTTP头部中安全地传输。
   • time ：提供与时间相关的功能，例如获取当前时间戳。时间戳通常用作API请求的一部分，以防止重放攻击。
2. 设置 API Key 和 Secret Key： 要访问Bithumb的私有API（例如，查询账户余额、下单等），必须提供有效的API Key和Secret Key。
   • YOUR_API_KEY ：这是您的公钥，用于标识您的身份。
   • YOUR_SECRET_KEY ：这是您的私钥，用于对您的请求进行签名。务必妥善保管此密钥，不要泄露给他人。
   在实际使用时，请将占位符 YOUR_API_KEY 和 YOUR_SECRET_KEY 替换为您的真实API Key和Secret Key。 这些密钥可以在您的Bithumb账户的API管理页面中找到。
3. bithumb_api_call 函数： 这是一个核心函数，它封装了与Bithumb API交互的通用逻辑。
   • 参数：
     • endpoint ：API端点，指定要调用的API的路径。例如， /public/ticker/BTC_KRW 用于获取BTC/KRW交易对的行情， /info/balance 用于获取账户余额。
     • params ：请求参数，以字典的形式传递给API。例如，可以指定 currency 参数来查询特定币种的余额。
     • api_key ：您的 API Key，用于标识您的身份。
     • secret_key ：您的 Secret Key，用于对请求进行签名。
   • 私有 API 签名： 对于需要身份验证的私有API，该函数会执行以下步骤来生成签名：
     1. 构建消息： 将API端点、请求参数和时间戳组合成一条消息。消息的格式需要符合Bithumb API的要求。
     2. HMAC-SHA512 签名： 使用Secret Key作为密钥，对消息进行HMAC-SHA512哈希运算。这将生成一个唯一的签名，用于验证请求的完整性和真实性。
     3. Base64 编码： 将生成的签名进行Base64编码，以便在HTTP头部中安全地传输。
     4. 添加头部： 将API Key、签名和时间戳添加到HTTP请求的头部。这些头部信息用于Bithumb服务器验证请求的身份。
   • 发送 HTTP 请求： 使用 requests 库发送HTTP请求到Bithumb API服务器。请求的类型（GET、POST等）取决于API的要求。
   • 处理响应： 接收来自Bithumb API服务器的响应，并将其解析为JSON格式。如果请求成功，将返回包含API数据的JSON对象。如果请求失败，将返回包含错误信息的JSON对象。
   • 错误处理： 函数应该包含适当的错误处理机制，以便在API调用失败时能够捕获异常并进行处理。例如，可以检查HTTP状态码和JSON响应中的错误代码。
4. 示例代码：
   • bithumb_api_call("/public/ticker/BTC_KRW") ： 这是一个公开API的调用示例，用于获取BTC/KRW交易对的实时行情数据。由于是公开API，因此不需要提供API Key和Secret Key。
   • bithumb_api_call("/info/balance", params, api_key, secret_key) ： 这是一个私有API的调用示例，用于获取账户余额信息。需要提供API Key和Secret Key进行身份验证。 注意需要设置 currency 参数，指定要查询的币种。例如， currency='BTC' 可以查询BTC的余额。 请务必注意，不同的API端点可能需要不同的参数。请参考Bithumb API文档，了解每个API端点的具体要求。

重要提示：

• 务必细致研读 Bithumb API 官方文档： 全面掌握 Bithumb API 的各个端点，深入理解每个端点所要求的参数类型、参数结构，以及 API 响应的详细格式。 清晰了解请求方法（例如：GET, POST）及数据传输方式，确保正确构建和发送 API 请求。
• 签名算法复杂度提示： Bithumb API 的签名机制可能涉及复杂的加密运算和参数组合。 请务必认真研究官方文档中关于签名算法的描述，包括所需参数的排序、加密算法的选择（如 HMAC-SHA512），以及时间戳的使用。 同时，参考官方提供的示例代码，进行实际操作和验证，确保签名生成过程的正确性，避免因签名错误导致 API 请求失败。
• 错误代码处理： 在处理 Bithumb API 返回的响应时，务必高度关注错误代码。 Bithumb API 会返回不同类型的错误代码，指示请求失败的原因。 请查阅官方文档中关于错误代码的详细说明，了解每个错误代码的具体含义，并根据错误代码的类型，采取相应的措施，例如：重试请求、修改请求参数、检查 API 密钥权限等。 针对不同错误情况进行妥善处理，确保程序的健壮性和稳定性。

6. 处理 API 返回数据和错误

Bithumb API 返回的数据格式通常为 JSON (JavaScript Object Notation)。这是一种轻量级的数据交换格式，易于人阅读和编写，同时也易于机器解析和生成。为了有效利用这些数据，您需要使用编程语言提供的 JSON 解析库。这些库可以将 JSON 字符串转换为程序可以操作的数据结构，例如字典或对象。

例如，在 Python 中，可以使用内置的 模块来解析 JSON 数据：

import 

response_ = '{"status": "0000", "data": {"closing_price": "50000000"}}'
response_data = .loads(response_)

上面的代码示例首先导入 模块。然后，它定义了一个名为 response_ 的字符串变量，该变量包含一个模拟的 Bithumb API 响应，使用 JSON 格式。 .loads() 函数用于将 JSON 字符串解析为 Python 字典，并将结果存储在 response_data 变量中。

在实际应用中，需要对 API 请求的响应状态进行检查。Bithumb API 通常使用 status 字段来指示请求是否成功。一个常见的做法是，如果 status 字段的值为 "0000"，则表示请求成功；否则，表示请求失败。以下代码演示了如何检查 API 响应状态并提取数据：

if response_data["status"] == "0000":
    closing_price = response_data["data"]["closing_price"]
    print(f"最新成交价：{closing_price}")
else:
    print(f"API 请求失败，错误代码：{response_data['status']}")

这段代码首先检查 response_data 字典中 status 字段的值。如果值为 "0000"，则从 data 字典中提取 closing_price 字段的值，并将其打印到控制台。否则，打印一条错误消息，其中包含 API 返回的错误代码。 开发者应根据实际情况处理不同的错误代码，例如，重试请求、记录错误日志或通知用户。同时务必查看Bithumb API的官方文档，了解各种状态码的含义及其对应的处理方式。

错误处理：

Bithumb API 通过返回错误代码来明确指示API请求的处理结果，以此区分请求的成功与失败。通常， 0000 状态码代表请求成功完成，而任何其他代码则表示发生了特定类型的错误。为了准确理解不同错误代码的具体含义及其潜在原因，务必详细查阅Bithumb API的官方文档。该文档提供了所有可能出现的错误代码及其对应的解释，以及建议的应对措施。

在编写与Bithumb API交互的应用程序时，至关重要的是对API响应中的 status 字段进行严格检查。如果该字段的值不是 0000 ，则表明API请求未能成功执行。此时，应用程序应当根据接收到的具体错误代码，采取相应的补救措施。例如，对于间歇性网络问题导致的错误，可以尝试重新发送请求；而对于由于无效参数或权限不足导致的错误，则需要向用户提供明确的错误提示信息，引导用户进行更正，或者记录错误日志以便后续分析和调试。更复杂的错误处理可能涉及降级服务、熔断机制等，以避免错误蔓延到整个系统。

7. 注意事项

• 安全性： 绝对不要将你的 Bithumb API Key 和 Secret Key 泄露给任何人。 这两项凭证是访问你账户的关键，泄露可能导致资金损失或其他未经授权的活动。妥善保管它们，就像保护你的银行密码一样。建议采用多重身份验证来增强账户安全性。
• 频率限制： 严格遵守 Bithumb API 的频率限制，避免被阻止访问。过高的请求频率可能会导致服务器过载，影响其他用户的正常使用。 请在开发应用程序时，合理控制API 请求的频率，并实施重试机制以应对可能的请求失败。 查阅Bithumb官方文档了解具体的频率限制规则。
• API 文档： 在开始使用 Bithumb API 之前，请务必仔细阅读其官方文档。 理解每个 API 端点的参数、请求方法（如GET、POST）以及响应格式（如JSON）。 官方文档通常包含详细的示例代码和错误代码说明，能帮助你更好地理解和使用API。
• 风险： 使用 Bithumb API 进行任何形式的交易都存在风险。 加密货币市场波动性极大，价格可能在短时间内剧烈波动。 你需要对你通过 API 执行的交易行为负全部责任。 在进行交易前，充分了解市场情况，制定合理的交易策略，并做好风险管理。
• API 更新： Bithumb 可能会定期更新其 API，包括增加新的功能、修复漏洞或改变现有端点的行为。 请定期查看 Bithumb 的官方公告、博客或开发者论坛，及时了解 API 的最新变化。关注这些更新能够确保你的应用程序与最新的 API 版本兼容，并充分利用新增的功能。不兼容的API调用可能会导致程序运行错误或数据异常。