Bithumb API交易教程：从入门到实战指南

研究 97℃

Bithumb API 交易教程：从入门到实战

本文档旨在帮助读者理解并掌握如何使用 Bithumb API 进行交易。我们将涵盖API密钥的获取、常用接口的调用、以及一些实战策略的运用。

1. 准备工作：API 密钥的获取与设置

要利用 Bithumb API 访问其交易功能，首要步骤是获取并配置有效的 API 密钥。API 密钥是您与 Bithumb 服务器进行安全通信的凭证，允许您通过编程方式执行交易、获取市场数据和管理您的账户。

  1. 获取 API 密钥： 您需要在 Bithumb 交易所的官方网站上注册一个账户。登录后，导航至“API 管理”或类似的页面（具体名称可能因网站更新而有所变化）。在这里，您可以创建一个新的 API 密钥对，包括一个 API Key 和一个 Secret Key。请务必妥善保管您的 Secret Key，切勿泄露给他人。
注册 Bithumb 账户： 访问 Bithumb 官网 (假设地址为https://www.bithumb.com) 并按照流程注册一个账户。请务必完成实名认证(KYC) 以解锁 API 交易权限。
  • 创建 API 密钥： 登录 Bithumb 账户后，在账户设置或 API 管理页面寻找 "API 密钥管理" 选项。点击 "创建 API 密钥" 并根据提示填写必要信息，例如 API 密钥的名称、IP 白名单（强烈建议设置，限制 API 密钥的使用范围）。
  • 权限设置： 在创建 API 密钥时，务必设置合适的权限。对于交易用途，你需要授予 "交易" 权限。此外，根据你的需求，还可以设置 "查询账户信息"、"查询交易历史" 等权限。注意权限越大，风险越高，请谨慎选择。
  • 保存 API 密钥： 成功创建 API 密钥后，系统会生成 API Key (公钥) 和 Secret Key (私钥)。请务必妥善保存这两个密钥，私钥绝对不能泄露给任何人。建议使用加密工具保存。
  • IP 白名单设置： 为了安全起见，强烈建议设置 IP 白名单，限制 API 密钥只能从指定的 IP 地址访问。在 API 密钥管理页面可以添加或修改 IP 白名单。如果你在家用电脑上运行交易程序，可以将你的公网 IP 地址添加到白名单中。

    • 2. API 接口调用：常用接口详解

    Bithumb API 提供了全面的接口，方便用户进行各种操作，包括但不限于查询实时市场数据、提交交易订单、查询订单执行状态、获取账户余额和交易历史等。这些接口的设计旨在满足不同用户的需求，无论是程序化交易员、数据分析师还是普通用户，都能找到合适的工具进行操作。

    市场数据查询： 通过API，可以实时获取Bithumb交易所的各种加密货币的交易对的最新价格、成交量、买卖盘口信息等。这些数据对于制定交易策略、进行风险评估至关重要。常用的市场数据接口包括：

    • Ticker API： 获取指定交易对的最新成交价、最高价、最低价、成交量等信息。
    • Order Book API： 获取指定交易对的买单和卖单的挂单信息，展示市场的深度和流动性。
    • Transaction History API： 获取指定交易对的最新成交记录，包括成交价格、成交数量和成交时间。

    交易下单： API提供了程序化交易下单的功能，用户可以通过编写程序自动进行买卖操作。为了保障交易的安全性，API通常需要进行身份验证和授权。常用的下单接口包括：

    • Place Order API： 提交买入或卖出订单，可以指定交易对、订单类型（市价单、限价单等）、价格和数量。
    • Cancel Order API： 撤销尚未成交的订单。

    订单状态查询： 用户可以通过API查询订单的当前状态，例如是否已经成交、部分成交或被撤销。这对于监控交易进度、调整交易策略非常有帮助。常用的订单状态查询接口包括：

    • Order Status API： 查询指定订单的详细信息，包括订单状态、成交数量、成交价格等。

    账户信息获取： API允许用户获取账户的余额信息、交易历史等，方便用户进行账户管理和财务分析。为了保护用户隐私，账户信息通常需要进行严格的权限控制。常用的账户信息获取接口包括：

    • Balance API： 获取账户中各种加密货币的可用余额和冻结余额。
    • Transaction History API： 获取账户的交易历史记录，包括充值、提现、买入、卖出等操作。

    2.1 公共 API (Public API): 无需 API 密钥

    • 公共 API 允许开发者在无需身份验证的情况下访问某些数据。这意味着它们不需要 API 密钥即可使用，简化了开发流程，特别是在初期探索和快速原型设计阶段。然而，为了保障平台资源和防止滥用，公共 API 通常会受到速率限制，例如每分钟或每小时允许的请求次数。开发者需要仔细阅读 API 文档，了解具体的速率限制策略，并在代码中进行相应的处理，例如实现重试机制和缓存策略。公共 API 提供的数据通常是公开可访问的，例如历史价格数据、交易对信息、以及其他非敏感的市场信息。开发者在使用公共 API 时，仍然需要遵守服务条款和数据使用协议。
    获取市场行情： GET /public/ticker/{currency} (例如: GET /public/ticker/BTC_KRW)
    • 描述：获取指定币种的实时行情数据，包括最新成交价、最高价、最低价、成交量等。
    • 返回值示例：

    { "status": "0000", "data": { "closingprice": "50000000", "openingprice": "48000000", "minprice": "47500000", "maxprice": "50500000", "units_traded": "100.5", "date": "1678886400000" } }

  • 获取交易历史： GET /public/transaction_history/{currency} (例如: GET /public/transaction_history/BTC_KRW)
    • 描述：获取指定币种的交易历史记录。
    • 返回值示例：

    { "status": "0000", "data": [ { "transactiondate": "2023-03-15 10:00:00", "type": "ask", "unitstraded": "0.01", "price": "50000000", "total": "500000" }, { "transactiondate": "2023-03-15 09:59:59", "type": "bid", "unitstraded": "0.02", "price": "49990000", "total": "999800" } ] }

    • 2.2 私有 API (Private API): 需要 API 密钥

    私有 API，也称为认证 API，要求开发者在使用前进行身份验证。 这是为了保护用户的账户安全和隐私，确保只有授权的应用程序才能访问用户的敏感数据，例如交易记录、账户余额和订单管理等功能。 为了实现这一目标，Bithumb 的私有 API 采用 API Key 和 Secret Key 机制来进行身份验证。API Key 用于标识应用程序，而 Secret Key 则用于生成数字签名，防止数据篡改。

    Bithumb 使用 HMAC-SHA512 算法对 API 请求进行签名。HMAC-SHA512 是一种消息认证码算法，它结合了哈希函数 SHA512 和密钥，能够有效地验证消息的完整性和来源。 使用 HMAC-SHA512 签名可以确保只有持有 Secret Key 的用户才能生成有效的签名，从而防止未经授权的访问和恶意攻击。开发者需要仔细理解 Bithumb 的签名机制，并按照官方文档的要求正确生成签名，才能成功调用私有 API。

    获取账户信息： POST /info/account
    • 描述：获取账户信息，包括账户余额、可用余额等。
    • 请求参数：currency: 币种 (例如: "BTC")
    • 返回值示例：

    { "status": "0000", "data": { "accountid": "xxxxxxxx", "accounttype": "normal", "balance": "1.5", "inuse": "0.5", "available": "1.0", "tradefee": "0.0015" } }

  • 下单： POST /trade/place
    • 描述：下单买入或卖出指定币种。
    • 请求参数：
      • currency: 币种 (例如: "BTC_KRW")
      • type: 订单类型 ("bid" - 买入, "ask" - 卖出)
      • price: 订单价格
      • units: 订单数量
    • 返回值示例：

    { "status": "0000", "data": { "order_id": "xxxxxxxx" } }

  • 查询订单状态： POST /info/order_detail
    • 描述：查询指定订单的详细信息。
    • 请求参数：
      • order_id: 订单 ID
      • type: 订单类型 ("bid" - 买入, "ask" - 卖出)
      • currency: 币种 (例如: "BTC_KRW")
    • 返回值示例：

    { "status": "0000", "data": { "orderid": "xxxxxxxx", "type": "bid", "currency": "BTCKRW", "orderdate": "2023-03-15 10:00:00", "units": "0.01", "price": "50000000", "fee": "7500", "orderstatus": "completed" } }

  • 取消订单： POST /trade/cancel
    • 描述：取消指定订单。
    • 请求参数：
      • order_id: 订单 ID
      • type: 订单类型 ("bid" - 买入, "ask" - 卖出)
      • currency: 币种 (例如: "BTC_KRW")
    • 返回值示例：

    { "status": "0000", "data": { "order_id": "xxxxxxxx" } }

    • 2.3 签名认证：HMAC-SHA512

    调用私有 API 接口时，为了确保交易安全和数据完整性，需要对请求进行签名认证。此签名用于验证请求的来源和内容的合法性，防止恶意篡改或伪造请求。Bithumb 交易所采用 HMAC-SHA512（Hash-based Message Authentication Code with SHA-512）算法来实现这一签名认证机制。

    HMAC-SHA512 是一种消息认证码算法，结合了密钥和哈希函数，可以有效地防止中间人攻击和重放攻击。它通过使用只有发送者和接收者知道的密钥，以及 SHA-512 哈希函数，来生成一个唯一的签名，附加在请求中。接收者使用相同的密钥和算法，重新计算签名，并与请求中的签名进行比较，以验证请求的有效性。这种方式确保了只有拥有密钥的参与者才能发起有效的 API 请求。

    构造请求参数： 将所有请求参数按照字母顺序排序，并将其拼接成字符串。
  • 生成随机数： 生成一个随机字符串 (Nonce)，用于防止重放攻击。
  • 计算签名： 使用 Secret Key 作为密钥，对排序后的请求参数字符串和 Nonce 进行 HMAC-SHA512 签名。
  • 添加请求头： 将 API Key、Nonce 和签名添加到请求头中。
    • Api-Key: API Key
    • Api-Sign: 签名
    • Api-Nonce: Nonce

    • 3. 实战策略：精简高效的网格交易策略

    网格交易，又称区间交易，是一种量化交易策略，旨在通过预先设定的价格区间和买卖规则，在价格波动中实现低买高卖，赚取差价利润。它尤其适用于震荡行情，能够有效利用市场波动积累收益。

    确定交易区间： 选择一个合适的交易区间，例如价格在 45000000 KRW 到 55000000 KRW 之间。
  • 设置网格密度： 将交易区间划分成多个网格，例如每 100000 KRW 一个网格。
  • 下单： 在每个网格的底部设置买单，在每个网格的顶部设置卖单。
  • 监控： 监控市场价格，当价格触及买单时，买入；当价格触及卖单时，卖出。
  • 循环： 重复步骤 3 和 4，利用价格波动进行低买高卖。
    • 风险提示： 网格交易并非稳赚不赔的策略。如果市场价格持续单边上涨或下跌，可能会导致买入的币无法卖出，或者卖出的币无法买回。因此，在使用网格交易策略时，务必设置止损点，控制风险。此外，交易手续费也会影响网格交易的盈利能力。

    4. 代码示例 (Python)

    以下是一个使用 Python 调用 Bithumb API 下单的示例代码。请注意，这仅仅是一个演示，实际生产环境中需要包含更完善的错误处理、异常处理、重试机制以及安全措施。

    为了保证安全性，密钥请勿直接硬编码在脚本中，建议从环境变量或配置文件中读取。

    import hashlib import hmac import time import requests import urllib.parse import API_KEY = "YOUR_API_KEY" # 替换为你的 API Key SECRET_KEY = "YOUR_SECRET_KEY" # 替换为你的 Secret Key API_URL = "https://api.bithumb.com" # Bithumb API 基本 URL def create_signature(endpoint, params, secret_key): """ 创建 Bithumb API 请求签名。 Args: endpoint (str): API 接口地址。 params (dict): 请求参数。 secret_key (str): 用户的 Secret Key。 Returns: str: 生成的签名字符串。 """ params_string = urllib.parse.urlencode(params, doseq=True) # 将参数转换为 URL 编码字符串 encoded_secret_key = secret_key.encode('utf-8') message = (endpoint + chr(0) + params_string).encode('utf-8') # 构建签名消息 signature = hmac.new(encoded_secret_key, message, hashlib.sha512).hexdigest() # 使用 HMAC-SHA512 算法生成签名 return signature def bithumb_api_call(endpoint, params=None, method='POST'): """ 调用 Bithumb API。 Args: endpoint (str): API 接口地址。 params (dict, optional): 请求参数。默认为 None。 method (str, optional): 请求方法，'POST' 或 'GET'。默认为 'POST'。 Returns: dict: API 返回的 JSON 数据，如果发生错误则返回 None。 """ nonce = str(int(time.time() * 1000)) # 生成当前时间的毫秒级时间戳作为 Nonce headers = { 'Api-Key': API_KEY, 'Api-Nonce': nonce, } if params is None: params = {} signature = create_signature(endpoint, params, SECRET_KEY) # 生成签名 headers['Api-Sign'] = signature try: if method.upper() == 'GET': response = requests.get(API_URL + endpoint + "?" + urllib.parse.urlencode(params), headers=headers) elif method.upper() == 'POST': response = requests.post(API_URL + endpoint, headers=headers, data=params) else: print("Error: Invalid HTTP method specified. Must be 'GET' or 'POST'.") return None response.raise_for_status() # 检查HTTP状态码，如果不是200则抛出异常 return response.() # 将返回的 JSON 数据解析为 Python 字典 except requests.exceptions.RequestException as e: print(f"Error: Request failed - {e}") if response is not None: print(f"Error: {response.status_code} - {response.text}") return None # 示例：查询账户信息 # account_info = bithumb_api_call("/info/account", {"currency": "BTC"}, method="POST") # Use POST for some /info endpoints # if account_info: # print("Account Info:", .dumps(account_info, indent=4)) # # # # 示例：下单 # order_params = { # "order_currency": "BTC", # "payment_currency": "KRW", # "units": "0.001", # 订单数量 # "price": "50000000", # 订单价格 # "type": "bid" # 订单类型：bid (买入), ask (卖出) # } # order_result = bithumb_api_call("/trade/place", order_params) # if order_result: # print("Order Result:", .dumps(order_result, indent=4)) #

    示例：下单

    以下代码示例展示了如何使用Python及 urllib.parse 库构建请求参数，并通过Bithumb API进行下单操作。该示例使用假设存在的 bithumb_api_call 函数来模拟API调用。实际应用中，你需要替换为真实可用的Bithumb API调用方法，并妥善处理API密钥等敏感信息。 

    import urllib.parse

params = {
    "currency": "BTC_KRW",  # 交易对：比特币/韩元
    "type": "bid",       # 交易类型：买入 (bid) 或 卖出 (ask)
    "price": "50000000",   # 委托价格：50,000,000 韩元
    "units": "0.001"      # 委托数量：0.001 BTC
}

endpoint = "/trade/place"  # API端点：下单

# 模拟Bithumb API调用 (需要替换为真实API调用)
response = bithumb_api_call(endpoint, params)  #  假设bithumb_api_call函数已定义

if response:
    print(.dumps(response, indent=4)) # 以JSON格式美观地打印响应信息
else:
    print("下单失败或API调用出错") # 增加错误处理
    参数说明：
    • currency : 指定交易的货币对，例如 "BTC_KRW" 表示比特币兑韩元。务必确认交易平台支持该货币对。
    • type : 指定交易类型。"bid" 代表买入（挂买单），"ask" 代表卖出（挂卖单）。请根据实际需求选择。
    • price : 设置委托价格，单位为目标货币（在此例中为韩元）。 该价格将决定你的订单以何种价格成交。
    • units : 设置委托数量，单位为基础货币（在此例中为比特币）。这是你希望买入或卖出的比特币数量。
    • endpoint :API的端点。
    注意事项：
    • 请务必使用安全的HTTPS连接，防止信息泄露。
    • 妥善保管你的API密钥，避免泄露。
    • 在真实交易前，建议先在测试环境中进行验证。
    • 根据Bithumb API的规范，正确处理API的返回结果，并进行必要的错误处理。
    • 实际的API调用可能需要添加身份验证信息（例如API密钥）。
    • 检查交易平台的最小交易单位限制，确保下单数量符合要求。

    示例：查询账户信息

    为了获取指定加密货币的账户信息，你需要构建一个包含所需参数的请求。以下是一个使用Python字典定义参数的示例，用于查询比特币（BTC）账户信息。

    params = { "currency": "BTC" }

    在这个 params 字典中， "currency" 键指定了要查询的加密货币类型，这里设置为"BTC"代表比特币。你可以根据需要将其更改为其他支持的加密货币代码，例如"ETH"代表以太坊。

    接下来，你需要指定API的端点，该端点负责处理账户信息查询请求。在本例中，我们使用 "/info/account" 作为端点。

    endpoint = "/info/account"

    利用Bithumb API调用函数 bithumb_api_call(endpoint, params) , 并传入endpoint 和 params 来查询账户信息。如果请求成功，服务器将返回包含账户信息的响应。该函数负责构建完整的API请求URL、添加必要的身份验证信息，并将请求发送到Bithumb服务器。

    response = bithumb_api_call(endpoint,params)

    为了确保能够正确处理API调用，需要检查 response 变量是否包含有效数据。如果 response 不为空（即请求成功），我们可以使用 .dumps() 函数将其格式化为易于阅读的JSON格式，并打印到控制台。

    if response: print(.dumps(response, indent=4))

    .dumps(response, indent=4) 的作用是将API返回的JSON格式数据进行美化输出。 indent=4 参数指定了缩进量为4个空格，使得输出结果更具可读性。通过这种方式，你可以清晰地查看账户余额、可用资金、交易历史等详细信息。

    重要提示：

    • 参数动态调整： 在进行加密货币交易时，市场波动性极高，静态的交易参数往往无法适应市场的快速变化。 因此，需要密切关注市场动向，包括价格走势、交易量、市场深度等关键指标，并基于这些数据实时调整交易策略中的各项参数，例如止损位、止盈位、仓位大小、交易频率等。 通过动态调整参数，可以更好地捕捉市场机会，同时降低潜在的风险。
    • 风险评估与控制： 加密货币市场存在高度的投机性和不确定性，价格波动剧烈，潜在风险巨大。 在进行任何交易之前，必须进行全面的风险评估，包括评估自身的风险承受能力、了解交易标的的特性、分析市场趋势、制定风险管理策略等。 风险控制措施应包括但不限于设置止损位、控制仓位大小、分散投资、避免过度杠杆等。 务必确保在可承受的风险范围内进行交易。
    • 代码示例的适用性： 提供的代码示例仅用于演示和参考目的，旨在帮助用户理解相关概念和技术实现方法。 然而，实际的交易环境远比示例复杂，代码示例可能无法直接应用于实际交易。 在使用代码示例之前，务必仔细阅读代码注释，理解代码逻辑，并根据自身的实际需求进行修改和完善。 同时，需要对代码进行充分的测试和验证，确保其在实际交易中能够正常运行并达到预期效果。 代码的优化，bug修复需要开发者根据自身需求进行完善。

    上一篇

    欧易平台理财：解锁加密货币被动收入，实现财富增长

    下一篇

    币安与OKX智能交易深度对比：算法交易策略解析

    相关推荐