发布于 2025-01-07 12:15:02 · 阅读量: 68784

Bithumb交易所API使用教程

Bithumb作为全球知名的加密货币交易所，提供了丰富的API接口，帮助开发者与交易所进行交互，实现自动化交易、数据抓取等功能。本文将带你一步步了解如何使用Bithumb交易所API，快速上手并进行基础操作。

1. 注册并获取API密钥

首先，你需要在Bithumb注册一个账号，并创建API密钥。这是进行API交互的基础。

1. 登录Bithumb官网，进入“API管理”页面。
2. 点击“创建API密钥”，并设置API权限（如查询账户信息、下单等）。
3. 保存生成的API Key和API Secret，它们是进行API操作时的凭证，千万不要泄露。

2. API请求格式

Bithumb提供的API支持RESTful风格，所有请求都是HTTP请求，并且以JSON格式返回数据。基本的请求格式如下：

• HTTP请求方式：GET 或 POST
• 请求URL：https://api.bithumb.com
• 返回格式：JSON

例如，要查询市场的当前行情，可以通过以下GET请求：

https://api.bithumb.com/public/ticker/{currency_pair}

其中，{currency_pair}是你要查询的交易对，例如BTC_KRW表示比特币对韩元的行情。

3. 常用API接口

3.1 获取市场行情

要获取指定交易对的市场行情，可以调用public/ticker接口。例如，查询比特币对韩元的最新行情：

bash GET https://api.bithumb.com/public/ticker/BTC_KRW

返回结果示例：

json { "status": "0000", "data": { "closing_price": "54000000", "opening_price": "54500000", "min_price": "53000000", "max_price": "55000000", "average_price": "54000000", "units_traded": "2345.67", "volume_1day": "234567", "date": "1633002800" } }

3.2 获取账户信息

获取账户的余额、已完成的订单等信息需要使用私有API。你需要使用POST请求并携带你的API密钥和签名。

请求示例：

bash POST https://api.bithumb.com/info/account

请求参数包括：

• apiKey：你的API Key
• secretKey：你的API Secret
• request：请求类型
• nonce：请求序列号（防重放攻击）
• signature：API签名（根据API文档计算）

3.3 下单交易

通过API下单交易同样需要调用私有API。常用的下单接口有限价单和市价单。下面是限价单的请求格式：

bash POST https://api.bithumb.com/trade/place

请求参数示例：

json { "order_currency": "BTC", "payment_currency": "KRW", "units": "0.1", "price": "54000000", "type": "bid", "apiKey": "你的API Key", "secretKey": "你的API Secret", "nonce": "请求序列号", "signature": "计算出的签名" }

3.4 查询订单状态

如果你想查询某个订单的状态，可以调用order/detail接口。

bash POST https://api.bithumb.com/order/detail

请求参数包括：

• order_id：订单ID
• apiKey：API Key
• secretKey：API Secret
• nonce：请求序列号
• signature：签名

4. 签名生成

由于Bithumb的API接口需要请求的签名（Signature），你需要根据API文档提供的方法计算签名。签名的生成一般是通过哈希加密算法（如HMAC-SHA512）来处理请求的参数。

签名计算方法示例（伪代码）：

import hashlib import hmac import time

api_key = "你的API Key" secret_key = "你的API Secret"

nonce = str(int(time.time() * 1000)) params = { 'apiKey': api_key, 'nonce': nonce, 'order_currency': 'BTC', 'payment_currency': 'KRW', 'units': '0.1', 'price': '54000000', }

message = urlencode(params) signature = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha512).hexdigest()

添加signature到请求参数

params['signature'] = signature

4.1 注意事项

• 签名的生成需要包括所有请求参数，且参数的顺序不可更改。
• nonce是为了防止请求重放攻击，每次请求时要生成一个唯一的序列号。
• 使用HMAC-SHA512算法计算签名。

5. 错误处理

当你通过API发送请求时，可能会遇到一些错误响应。Bithumb API的错误响应格式如下：

json { "status": "0001", "message": "Invalid API Key" }

常见的错误码及其含义：

• 0000：成功
• 0001：无效的API Key
• 0002：签名错误
• 1000：系统错误

遇到错误时，你可以根据status值和message信息进行调试，确保请求正确。

6. 速率限制

Bithumb API有请求频率限制，通常情况下，API的每分钟请求次数限制为15次。为了避免被封禁，尽量不要频繁发送请求。如果需要大规模的操作，建议合理安排请求时间，避免触发API的限制。

7. 安全提示

• 保护好你的API密钥：不要把API Key和Secret暴露在公开场合。
• 启用IP白名单：如果支持，可以启用IP白名单功能，仅允许指定的IP访问你的API。
• 使用环境变量存储API密钥：避免将密钥硬编码在程序中，使用环境变量或配置文件来管理API密钥。

8. 示例代码

以下是一个Python示例，展示如何查询市场行情并打印结果：

import requests

url = "https://api.bithumb.com/public/ticker/BTC_KRW" response = requests.get(url)

if response.status_code == 200: data = response.json() if data['status'] == '0000': print(f"当前BTC/韩元的价格为：{data['data']['closing_price']} 韩元") else: print(f"查询失败，错误信息：{data['message']}") else: print("请求失败，状态码：", response.status_code)

运行该代码后，将返回BTC/韩元的最新市场价格。

通过以上步骤，你应该能够顺利使用Bithumb的API进行基础的市场查询、账户操作和交易下单。根据自己的需求，结合API文档提供的其他接口，你可以扩展功能，实现更多自动化交易操作。