如何使用Bithumb的API？

使用Bithumb的API可以增强交易策略并自动化流程；本指南涵盖注册，API密钥设置以及有效的第一个API调用。

2025/04/18 20:49

使用Bithumb的API可以显着增强您的交易策略，自动化流程和访问实时数据。在本指南中，我们将引导您浏览有效使用Bithumb的API的步骤，从而涵盖从注册到执行第一个API呼叫的所有内容。

注册和设置API密钥

在使用Bithumb的API之前，您需要注册一个帐户并设置API密钥。您可以做到这一点：

• 访问Bithumb网站并注册一个新帐户，如果您还没有一个帐户。您需要提供个人详细信息并完成验证过程。
• 登录您的BitHumb帐户。导航到API管理部分，通常在帐户设置或安全设置下找到。
• 创建一个新的API键。将提示您输入API键的名称，该名称可帮助您在需要时管理多个键。请确保根据您打算使用API​​来启用必要的权限。
• 生成API键。您将收到一个API密钥和一个API秘密。这些对于对您的API请求进行身份至关重要，因此请确保它们安全。

了解Bithumb的API端点

Bithumb的API分为几个端点，每个端点都有特定目的。这是您应该知道的一些关键端点：

• 公共API ：这些端点不需要身份验证，并且用于获取市场数据，例如股票信息，订单书和交易历史记录。
• 私有API ：这些端点需要身份验证，并允许您执行诸如下订单，取消订单和管理帐户余额之类的操作。

进行第一个API电话

要进行第一个API调用，您需要使用Python，JavaScript或任何其他支持HTTP请求的语言等编程语言。这是使用Python的分步指南：

• 安装必要的库。您需要requests提出HTTP请求和hmac来签署请求。您可以使用PIP安装它们：

 pip install requests

• 在您的Python脚本中导入库：

 import requests
 import hmac
 import hashlib
 import time

• 设置您的API凭据：

 api_key = 'YOUR_API_KEY'
 api_secret = 'YOUR_API_SECRET'

• 构建API调用。让我们使用公共API获取Bitcoin（BTC）的股票信息：

 endpoint = 'https://api.bithumb.com/public/ticker/BTC'
 response = requests.get(endpoint)
 print(response.json())

• 对于私人API电话，您需要签署请求。这是如何下订单的一个示例：

 endpoint = 'https://api.bithumb.com/trade/place'
 params = { 'order_currency': 'BTC', 'payment_currency': 'KRW', 'units': '0.001', 'price': '1000000', 'type': 'bid'

}
params ['endpoint'] =端点
nonce = str（int（time.time（） * 1000））
params ['nonce'] = nonce

创建签名

query_string ='＆'。join（[f'{k} = {v}'for K，v in sorted（params.items（）））
signature = hmac.new（api_secret.encode（'utf-8'），query_string.encode（'utf-8'），hashlib.sha512）.hexdigest（）

标题= {

'Api-Key': api_key, 'Api-Sign': signature, 'Content-Type': 'application/x-www-form-urlencoded'

}

响应= requests.post（端点，data = params，headers =标题）
打印（response.json（））

处理错误和响应

使用Bithumb的API时，正确处理错误和解析响应很重要。您可以做到这一点：

• 检查响应的状态代码。 200个状态代码表示成功，而其他代码表示错误。
• 解析JSON响应。 Bithumb的API以JSON格式返回数据，您可以使用Python的json模块轻松解析数据。

 import json如果响应。STATUS_CODE== 200：







data = response.json() if data['status'] == '0000': print('Success:', data) else: print('Error:', data['message'])
别的：
 
print('HTTP Error:', response.status_code)
使用Bithumb的Websocket API
对于实时数据，BitHumb提供了Websocket API。这是您可以使用Python连接到它的方式：
 
安装websocket-client库：
 pip install websocket-client
连接到Websocket ：
 import websocket
进口JSON
 
def on_message（WS，消息）：
 
data = json.loads(message) print(data)
 DEF ON_ERROR（WS，错误）：
 
print(error)
 def on_close（WS）：
 
print('### closed ###')
 def on_open（WS）：
 
print('### opened ###')
 websocket.enabletrace（true）
 ws = websocket.websocketapp（'wss：//pubwss.bithumb.com/pub/ws'，
 
 on_message=on_message, on_error=on_error, on_close=on_close)
 ws.on_open = on_open
 ws.run_forever（）

使用Bithumb的API的最佳实践

为了确保您有效，安全地使用Bithumb的API，请考虑以下最佳实践：

• 保护您的API键。切勿共享您的API键或将它们存储在版本控制系统中。使用环境变量或安全库存储它们。
• 费率限制。请注意Bithumb的速率限制，以免受到API访问的限制。实施重试机制，并以指数向后进行处理率限制错误。
• 错误处理。始终在代码中包含强大的错误处理以优雅地处理API失败。
• 测试。在将代码部署到生产之前，请在沙箱或测试环境中彻底测试它，以确保其按预期工作。

常见问题

问：我可以使用Bithumb的API进行自动交易吗？

答：是的，Bithumb的API通过其私人端点支持自动交易，使您可以按编程方式下订单，取消订单并管理您的帐户余额。

问：有关Bithumb API的数据多久更新一次？

答：公共API端点，例如股票和订单数据数据，通常是实时更新的，而私有API端点可能会根据您的帐户的活动具有不同的更新频率。

问：我可以在BitHumb上创建的API键的数量有限制吗？

答：BitHumb可能会限制您可以创建每个帐户的API键的数量。您应该检查API文档或联系BitHumb支持以获取特定详细信息。

问：我可以使用Bithumb的API获取历史数据吗？

答：Bithumb的API主要提供实时数据。对于历史数据，您可能需要使用第三方服务或手动收集和存储数据。