Bithumb API密钥申请指南
Bithumb 作为韩国领先的加密货币交易所之一，提供了强大的 API (应用程序编程接口)，允许开发者和交易者通过编程方式访问其平台，进行数据查询、交易执行等操作。 要使用 Bithumb 的 API，首先需要申请 API 密钥。 本文将详细介绍如何在 Bithumb 平台上申请 API 密钥。
准备工作
在开始申请 Bithumb API 密钥之前，为了确保流程顺利并保障账户安全，请务必完成以下准备工作。这些准备工作是成功申请和安全使用 API 密钥的必要步骤。
- Bithumb 账户 : 您需要拥有一个有效的 Bithumb 账户。 如果您尚未拥有账户，请立即前往 Bithumb 官方网站（例如：bithumb.com，请自行验证官方网址的安全性）进行注册。注册过程可能包括提供您的个人信息、设置用户名和密码，以及验证您的电子邮件地址。请务必使用强密码，并妥善保管您的账户信息。
- 完成身份验证 (KYC) : Bithumb 作为一家合规的加密货币交易所，要求所有用户完成身份验证 (KYC) 才能使用 API 密钥，这是为了防止洗钱和其他非法活动。 确保您的账户已经通过 KYC 验证。 通常，这需要您上传身份证明文件（例如护照、身份证或驾驶执照）和进行人脸识别。请仔细阅读 Bithumb 的 KYC 要求，并按照指示提交准确的信息，以避免验证失败。 您可以在 Bithumb 的账户设置或个人资料页面找到 KYC 验证的入口。
- 开启双重验证 (2FA) : 为了最大程度地保护您的账户安全，强烈建议开启双重验证 (2FA)。 双重验证会在您登录时要求输入除了密码之外的另一种验证码，从而大大提高了账户的安全性，即使您的密码泄露，攻击者也无法轻易访问您的账户。 Bithumb 支持多种 2FA 方式，例如 Google Authenticator、短信验证或硬件安全密钥。 建议您使用 Google Authenticator 或类似的身份验证器应用程序，因为它比短信验证更安全。在 Bithumb 的账户安全设置中，您可以找到开启和配置 2FA 的选项。请务必备份您的 2FA 恢复密钥，以便在您更换设备或丢失身份验证器时可以恢复您的账户。
API 密钥申请步骤
- 登录 Bithumb 账户 : 使用您的注册邮箱、用户名和密码安全地登录 Bithumb 官方网站。 确保您访问的是 Bithumb 的官方域名，谨防钓鱼网站。建议开启双重身份验证(2FA)，例如Google Authenticator或短信验证码，以增强账户安全性。
- 进入 API 管理页面 : 成功登录后，寻找“API 管理”、“API 密钥”或类似的入口。 具体位置可能因 Bithumb 网站界面的更新迭代而略有不同。 通常可以在账户设置、个人中心或安全设置等选项中找到。您可以在页面上使用浏览器的搜索功能(通常按`Ctrl+F`或`Cmd+F`键)输入 "API" 关键词来快速定位相关链接。请注意，API管理页面可能会要求您再次进行身份验证。
- 创建新的 API 密钥 : 在 API 管理页面，查找并点击“创建 API 密钥”、“添加 API 密钥”、“生成新密钥”或类似的按钮。 该按钮通常会引导您进入一个表单，用于配置新的 API 密钥。
-
填写 API 密钥信息
:
您需要仔细填写 API 密钥的相关信息，这部分是设置密钥的关键：
- API 密钥名称 : 为您的 API 密钥设置一个具有描述性的、易于记忆和识别的名称，例如 "My Trading Bot"、"Data Analysis Script" 或 "Arbitrage Strategy"。 密钥名称应该清晰地反映该密钥的用途，方便您日后对多个 API 密钥进行有效的管理和追踪。 使用驼峰命名法或下划线命名法是一个良好的实践。
- IP 地址限制 (可选) : 为了显著提高安全性，强烈建议您限制 API 密钥只能从特定的、预先定义的 IP 地址进行访问。 这被称为 IP 地址白名单。 只允许您的服务器或特定电脑的 IP 地址访问 API，可以有效防止未经授权的访问和潜在的恶意攻击。 如果您不确定您的公网 IP 地址，可以使用在线 IP 查询工具来获取。请务必将所有可能访问 API 的 IP 地址添加到白名单中。 如果您需要在本地开发环境中使用 API，也需要将本地 IP 地址加入白名单。 如果您使用的是动态 IP 地址，请考虑使用动态 DNS 服务。
-
API 权限
: 仔细选择您需要授予 API 密钥的权限。 Bithumb 提供了细粒度的权限选项，允许您精确控制 API 密钥可以执行的操作。 请遵循最小权限原则，只授予 API 密钥完成其特定任务所需的最小权限集。 这可以最大程度地降低潜在的安全风险。
- 查询余额 : 允许 API 密钥查询您的账户余额信息，包括各种加密货币的持有数量和可用余额。 这对于监控账户状态和执行交易策略至关重要。
- 交易 (买/卖) : 允许 API 密钥执行买入和卖出加密货币的交易操作。 请务必谨慎授予此权限，并进行充分的风险评估。 只有在您完全信任您的代码，并且已经进行了全面的测试之后，才能授予此权限。 严格实施安全措施，例如输入验证、速率限制和异常处理，以防止潜在的漏洞被利用。 请务必使用限价单，而不是市价单，以更好地控制交易价格。
- 查看历史交易 : 允许 API 密钥访问和检索您的历史交易记录，包括交易时间、交易对、交易价格和交易数量。 这对于审计、绩效分析和税务报告非常有用。
- 访问市场数据 : 允许 API 密钥访问 Bithumb 交易所的实时和历史市场数据，例如最新价格、交易量、深度图和订单簿信息。 这对于开发交易策略、进行市场分析和构建数据驱动型应用程序至关重要。
- 提现 (Withdrawal) : 强烈建议不要授予此权限，除非您对风险有充分的了解，并且有极强的安全需求。 如果您的 API 密钥被未经授权的第三方盗用或泄露，攻击者可能会利用此权限将您的资金转移到他们控制的地址，造成不可挽回的损失。 只有在极少数情况下，例如您需要自动化资金管理流程，并且已经实施了多重安全措施，才应该考虑授予此权限。 在任何情况下，都应该设置提现地址白名单，只允许提现到预先批准的地址。
- 确认 API 密钥信息 : 仔细、认真地检查您填写的 API 密钥的所有信息，包括 API 密钥名称、IP 地址限制和权限设置。 确保所有信息准确无误，并且符合您的预期。 特别注意权限设置，只授予必要的权限，避免过度授权。
- 提交申请 : 点击“提交”、“创建”、“生成”、“确认”或类似的按钮，提交您的 API 密钥申请。 请注意，某些交易所可能会要求您阅读并同意服务条款和隐私政策。
- 进行身份验证 : 为了进一步验证您的身份，增强安全性，Bithumb 可能会要求您进行额外的身份验证步骤。 这可能包括输入通过短信发送到您注册手机号码的验证码、输入您的 Google Authenticator 或其他 2FA 应用程序生成的代码，或者完成人脸识别验证。
- 获取 API 密钥 : 在您成功完成身份验证后，您将获得您的 API 密钥 (API Key) 和密钥密码 (Secret Key)。 务必采取一切必要的措施来妥善保管您的 API 密钥和密钥密码，不要以任何方式泄露给任何人。 它们是访问 Bithumb API 的唯一凭证，拥有它们的人可以代表您执行您所授予的权限。 将 API 密钥和密钥密码存储在安全的位置，例如加密的配置文件、硬件钱包或密钥管理系统。 避免将它们硬编码到您的代码中，或者存储在版本控制系统中。 定期轮换您的 API 密钥，以降低安全风险。 强烈建议启用 API 密钥的访问日志，以便您可以监控 API 密钥的使用情况，并及时发现任何异常活动。 如果您怀疑您的 API 密钥可能已被泄露，请立即撤销该密钥，并生成新的密钥对。
API 密钥安全注意事项
- 妥善保管 API 密钥和密钥密码 : API 密钥和密钥密码是您访问 Bithumb API 的唯一凭证，如同银行账户的用户名和密码。务必将其视为高度敏感信息，采取一切必要的措施进行保护，切勿以任何形式泄露给任何第三方。泄露这些信息将直接导致您的账户和资产面临风险。
- 使用 IP 地址限制（IP 白名单） : 为您的 API 密钥配置 IP 地址白名单功能，只允许特定的服务器或计算机 IP 地址范围访问 Bithumb API。这样即使 API 密钥泄露，未经授权的 IP 地址也无法使用该密钥，有效降低安全风险。强烈建议设置尽可能精确的 IP 地址范围。
- 限制 API 权限 : 授予 API 密钥最小权限原则。仔细评估您需要执行的操作，并仅授予必要的 API 权限。例如，如果您只需要查询市场数据，则不要授予交易或提现权限。这可以最大限度地减少潜在的安全漏洞影响范围。
- 定期更换 API 密钥 : 定期轮换 API 密钥是重要的安全实践。建议至少每三个月更换一次，或者在发现任何可疑活动后立即更换。每次更换密钥后，务必更新您的应用程序和脚本，以确保其继续正常运行。
- 监控 API 使用情况 : 密切监控 API 密钥的使用情况，包括请求频率、交易量和错误日志。通过监控 API 使用情况，您可以及时发现未经授权的访问、异常交易活动或其他可疑行为，并及时采取应对措施。
- 禁用不使用的 API 密钥 : 如果您有不再使用的 API 密钥，请立即禁用它。这可以防止这些密钥被恶意利用。即使您认为将来可能会再次使用某个密钥，也建议先禁用它，并在需要时再重新启用。
- 避免将 API 密钥硬编码到代码中 : 切勿将 API 密钥直接嵌入到应用程序的代码中。这样做会将密钥暴露给潜在的攻击者。应将 API 密钥存储在安全的位置，例如服务器上的环境变量、加密的配置文件、专门的密钥管理系统（KMS）或硬件安全模块（HSM）。
- 使用 HTTPS (TLS) : 始终使用 HTTPS（通过 TLS 加密）连接 Bithumb API。HTTPS 可以确保数据在您的应用程序和 Bithumb 服务器之间传输过程中受到加密保护，防止中间人攻击和数据窃取。验证您使用的 API 客户端库或工具是否支持 HTTPS，并确保已启用。
- 警惕钓鱼网站和恶意软件 : 高度警惕网络钓鱼攻击。犯罪分子可能会伪装成 Bithumb 或其他可信来源，诱骗您提供 API 密钥和密码。请务必只通过 Bithumb 官方网站 (bithumb.com) 申请和管理 API 密钥。切勿点击可疑链接或下载来自未知来源的文件，并使用信誉良好的防病毒软件保护您的设备。
API 使用示例 (伪代码)
以下是一个使用 Python 编写的伪代码示例，旨在演示如何利用 Bithumb 交易所提供的 API 来查询账户余额。请注意，这仅仅是伪代码，需要替换成真实的 API 密钥和调用逻辑才能正常运行。
import requests
import hashlib
import hmac
import time
# 替换为你的 Bithumb API 密钥和 Secret Key
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
# Bithumb API 账户余额查询接口地址
api_url = "https://api.bithumb.com/info/account"
# 构造请求头部
def get_headers(api_key, secret_key, endpoint, data):
nonce = str(int(time.time() * 1000))
string = endpoint + chr(0) + str(data) + chr(0) + nonce
h = hmac.new(secret_key.encode('utf-8'), string.encode('utf-8'), hashlib.sha512)
signature = h.hexdigest()
headers = {
'Api-Key': api_key,
'Api-Sign': signature,
'Api-Nonce': nonce
}
return headers
# 构造请求参数 (例如，指定要查询的币种)
params = {
"currency": "BTC" # 可以更改为其他币种，如 ETH, XRP 等
}
headers = get_headers(api_key, secret_key, "/info/account", params)
# 发送 GET 请求
try:
response = requests.get(api_url, headers=headers, params=params)
response.raise_for_status() # 检查请求是否成功 (HTTP 状态码 200)
data = response.()
if data['status'] == "0000":
print("账户余额信息：", data['data'])
# 在这里可以进一步解析 data['data']，提取可用余额、冻结余额等信息
else:
print("API 请求失败：", data['message'])
except requests.exceptions.RequestException as e:
print("请求发生错误：", e)
except Exception as e:
print("发生未知错误：", e)
替换为您的 API 密钥和密钥密码
进行交易前，务必将
api_key
和
secret_key
替换为您的 Bithumb 交易所 API 密钥和密钥密码。API 密钥用于身份验证，密钥密码则用于生成签名，确保请求的安全性。
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
get_nonce()
函数用于生成一个 nonce 值。Nonce 是一个单调递增的数字，用于防止重放攻击。使用当前时间的毫秒数作为 nonce 可以确保其唯一性。
def get_nonce():
return str(int(time.time() * 1000))
get_signature()
函数用于生成 API 请求的签名。签名是通过 HMAC-SHA512 算法对请求数据进行加密生成的，用于验证请求的完整性和真实性。该函数接受 endpoint 和 params 作为输入，并使用您的
secret_key
对数据进行哈希处理。
def get_signature(endpoint, params):
data = endpoint + chr(0) + params + chr(0) + get_nonce()
h = hmac.new(secret_key.encode('utf-8'), data.encode('utf-8'), hashlib.sha512)
return h.hexdigest()
get_account_balance()
函数演示了如何获取您的 Bithumb 账户余额。定义了要访问的 API endpoint（
/info/balance
）和要查询的货币（例如：韩元 "KRW"）。 然后，构造请求参数。
def get_account_balance():
endpoint = "/info/balance"
currency = "KRW" # 例如：韩元
params = "currency=" + currency
nonce = get_nonce()
signature = get_signature(endpoint, params)
headers = {
"Api-Key": api_key,
"Api-Sign": signature,
"Api-Nonce": nonce
}
url = "https://api.bithumb.com" + endpoint + "?" + params
response = requests.get(url, headers=headers)
if response.status_code == 200:
data = response.()
print(data)
# 处理返回的 JSON 数据
else:
print("Error:", response.status_code, response.text)
上述代码片段展示了如何构建 API 请求并发送到 Bithumb 交易所。关键步骤包括：生成 nonce 值，生成签名，构造请求头（包含 API 密钥、签名和 nonce），以及发送 GET 请求。如果请求成功（状态码为 200），则解析返回的 JSON 数据。务必处理不同类型的错误，例如网络错误或 API 返回的错误信息。
调用函数获取账户余额
使用
get_account_balance()
函数是检索指定加密货币账户当前余额的关键步骤。该函数通常存在于与特定区块链或加密货币交易所交互的软件开发工具包（SDK）或应用程序编程接口（API）中。调用此函数时，需要提供必要的参数，例如账户地址或账户标识符。函数执行后，将返回账户余额，通常以特定加密货币的最小单位（例如，比特币的聪或以太坊的Wei）表示。开发者可以进一步处理返回的值，将其转换为更易读的格式，例如比特币或以太坊，以便在用户界面或报告中使用。此函数对于构建加密货币钱包、交易平台和账户管理系统至关重要。
申请 API 密钥后，请仔细阅读 Bithumb 的 API 文档，了解 API 的使用方法和限制。 祝您使用愉快!
