Bithumb API 设置与使用教程：获取API Key、签名验证与常见操作

发布于 2025-02-07 17:18:26 · 阅读量: 179211

Bithumb的API如何设置与使用

想撸 Bithumb 的 API？稳住，哥们儿，咱们一步步来，别一上来就整懵了。Bithumb 作为韩国的大牌交易所，API 还是挺给力的，支持现货、杠杆、提现啥的，玩儿得转的话，搬砖、量化都能搞。

1. 注册并获取 API Key

首先，得有个 Bithumb 账号，没有的话赶紧注册一个。然后：

登录 Bithumb 官网，进入“API管理”页面。
创建 API Key，勾选需要的权限（比如读取市场数据、交易、提现等）。
生成 API Key 和 Secret Key，这俩东西别丢了，丢了你就得重置。

2. API 连接基础配置

Bithumb 的 API 地址是：

https://api.bithumb.com

支持 RESTful API 和 WebSocket，前者适合查询、下单，后者适合高频交易和监听市场。

公共接口（无需 API Key）

可以直接访问，不用身份验证，适合拉取市场数据，比如获取当前币价：

bash curl -X GET "https://api.bithumb.com/public/ticker/BTC_KRW"

私有接口（需要 API Key）

这里就得用 API Key 了，并且需要 HMAC-SHA512 进行签名，不然 Bithumb 不鸟你。

3. API 签名与身份验证

每次请求都得加上这些请求头：

Api-Key: 你的 API Key
Api-Sign: 用 HMAC-SHA512 算出来的签名
Api-Nonce: 随机数（一般用当前时间戳）

签名算法示例（Python）：

import hashlib import hmac import base64 import time import requests

api_key = "你的API Key" api_secret = "你的API Secret" endpoint = "/info/account" url = f"https://api.bithumb.com{endpoint}"

nonce = str(int(time.time() * 1000)) data = f"endpoint={endpoint}&nonce={nonce}" hmac_hash = hmac.new(api_secret.encode(), data.encode(), hashlib.sha512).digest() signature = base64.b64encode(hmac_hash).decode()

headers = { "Api-Key": api_key, "Api-Sign": signature, "Api-Nonce": nonce }

response = requests.post(url, headers=headers) print(response.json())

4. 常见 API 用法

获取账户余额

bash curl -X POST "https://api.bithumb.com/info/balance" \ -H "Api-Key: 你的API Key" \ -H "Api-Sign: 计算出来的签名" \ -H "Api-Nonce: 当前时间戳"

返回示例：
json { "status": "0000", "data": { "total_btc": "1.2345", "available_btc": "0.9876", "total_krw": "10000000", "available_krw": "5000000" } }

下单交易（限价买入）

bash curl -X POST "https://api.bithumb.com/trade/place" \ -H "Api-Key: 你的API Key" \ -H "Api-Sign: 计算出来的签名" \ -H "Api-Nonce: 当前时间戳" \ -d "order_currency=BTC&payment_currency=KRW&units=0.01&price=30000000&type=bid"

返回示例：
json { "status": "0000", "order_id": "C0101000000000000000" }

查询订单状态

bash curl -X POST "https://api.bithumb.com/info/order_detail" \ -H "Api-Key: 你的API Key" \ -H "Api-Sign: 计算出来的签名" \ -H "Api-Nonce: 当前时间戳" \ -d "order_id=C0101000000000000000"

5. WebSocket 订阅市场数据

如果你要做高频交易，WebSocket 绝对是个好东西。

WebSocket 服务器地址：

wss://pubwss.bithumb.com/pub/ws

Python 订阅示例：

import websocket import json

def on_message(ws, message): print("收到消息:", message)

ws = websocket.WebSocketApp( "wss://pubwss.bithumb.com/pub/ws", on_message=on_message )

ws.run_forever()

这个代码会监听市场数据，适合做策略交易。

6. 提现 API（高级玩法）

提现 API 需要单独申请权限，并且 Bithumb 可能会人工审核，防止撸毛党乱搞。

bash curl -X POST "https://api.bithumb.com/withdraw/coin" \ -H "Api-Key: 你的API Key" \ -H "Api-Sign: 计算出来的签名" \ -H "Api-Nonce: 当前时间戳" \ -d "currency=BTC&units=0.01&address=你的比特币地址"

如果你是做套利或者资金转移，最好别频繁操作，避免被风控。

Bithumb 的 API 还支持更多功能，比如市场深度查询、批量下单、自动撤单等，官方文档在这里：Bithumb API 文档。玩儿之前建议先看看，别直接上去怼，免得踩坑。