Bithumb API 密钥设置指南
本文档将详细介绍如何在Bithumb交易所设置API密钥，以便您可以通过程序化方式访问您的账户并进行交易。请务必妥善保管您的API密钥，避免泄露，以确保您的资金安全。
前提条件
- 要使用Bithumb的API，您必须先拥有一个有效的Bithumb账户。请前往Bithumb官方网站注册，并按照指示完成账户创建过程。
- 为了确保符合监管要求并提升交易安全性，您需要完成身份验证 (KYC)。 这通常涉及提交您的身份证明文件和地址证明。请确保您提供的信息准确无误，以便顺利通过验证。
- 在使用API之前，理解API的基本概念至关重要。 这包括了解API密钥的作用，它是您访问API的凭证。您还需要清楚API密钥的权限，不同的权限允许您执行不同的操作，例如交易、查询账户余额或获取市场数据。 请谨慎管理您的API密钥，避免泄露。
- 强烈建议您启用双因素认证（2FA）来增强账户的安全性。2FA会在您登录时要求提供除密码之外的第二重验证码，有效防止未经授权的访问，即使您的密码泄露。您可以选择使用Google Authenticator或其他2FA应用程序。
设置API密钥步骤
- 登录Bithumb账户 : 使用您的网页浏览器访问Bithumb官方网站（bithumb.com）并完成账户登录。务必仔细检查网址，确保您访问的是官方网站，谨防钓鱼网站窃取您的账户信息。建议启用双重验证（2FA）以提高安全性。
- 进入API管理页面 : 成功登录后，导航至账户设置区域，通常位于用户头像下拉菜单或个人资料页面内。在该区域内，寻找诸如“API管理”、“API密钥管理”或者类似命名的选项，点击进入API密钥管理专区。请注意，由于Bithumb网站界面可能会不定期更新，具体位置可能会有所变动。如果找不到，可以尝试使用网站的搜索功能。
- 创建新的API密钥 : 在API密钥管理页面，找到并点击“创建API密钥”、“添加API密钥”或类似按钮。这将启动创建新API密钥的流程。在创建过程中，系统可能会要求您进行身份验证，例如输入密码或接收验证码。
-
设置API权限
: 创建API密钥的过程中，您需要为该API密钥配置具体的权限。这是一个至关重要的步骤，请务必根据您的实际需求，审慎选择所需的权限。不必要的权限会增加您的账户风险。常见的API权限类型包括：
- 查看账户信息 : 允许API密钥访问您的账户余额信息、历史交易记录、持仓情况等。该权限通常用于监控账户状态或进行数据分析。
- 交易 : 授予API密钥执行买入和卖出操作的权限。启用此权限后，API密钥将能够代表您在Bithumb交易所进行交易。请务必谨慎授予此权限，并仅在您完全信任且经过充分测试的交易程序或机器人中使用。建议设置交易额度限制，以降低风险。
- 提现 : 允许API密钥发起提现请求，将资金从Bithumb账户转移到其他地址。 强烈不建议授予此权限，除非您对使用此API密钥的应用程序或脚本拥有绝对信任。一旦API密钥泄露且拥有提现权限，您的资产将面临极高的风险。 建议使用冷钱包或多重签名钱包进行大额资产的存储，并限制API密钥的提现额度。
如果您不确定应用程序或脚本的IP地址，您可以通过以下方法获取：
- 在应用程序或脚本中调用一个可以获取IP地址的API。
- 如果应用程序或脚本运行在服务器上，登录服务器并使用命令
curl ifconfig.me或wget -qO- ifconfig.me/ip来获取服务器的IP地址。
将获取到的IP地址添加到Bithumb的IP白名单中。注意，如果您的应用程序或脚本的IP地址是动态的，那么IP白名单可能不适用。在这种情况下，您需要寻找其他安全措施。
使用API密钥
成功生成并妥善保存您的API密钥与密钥后，您便可以利用它们安全地访问Bithumb API。API的具体使用方式与您选择的编程语言以及所采用的API客户端库息息相关。务必选择可靠且经过充分测试的客户端库，以确保通信的安全性和稳定性。
以下列举了一些常见的使用场景，展示了API密钥在实际交易与账户管理中的应用：
- 获取账户余额 : 通过API密钥，您可以实时查询您的账户余额，详细了解您所持有的各种加密货币的数量，方便资产管理和决策。API将会返回一个包含详细余额信息的JSON对象，您可以从中提取所需数据。
- 下单 : 使用API密钥，您可以程序化地下达买入或卖出订单，实现自动化交易策略。您可以设置订单类型（如市价单、限价单）、交易数量和价格，API将会根据您的指令执行交易。
- 取消订单 : 您可以通过API密钥取消尚未成交的订单，灵活调整交易策略，及时止损或调整仓位。取消订单时，需要提供订单ID，API将会取消与该ID对应的订单。
- 获取交易历史 : 通过API密钥，您可以获取详细的交易历史记录，包括交易时间、交易类型、交易价格、交易数量等信息，方便您进行交易分析和税务申报。交易历史记录通常以分页的形式返回，您可以根据需要请求不同页面的数据。
使用API密钥时，务必严格遵守Bithumb API官方文档及相关规范，确保API请求的格式正确，并注意API的使用频率限制，避免因违反规定而导致API密钥被禁用。强烈建议您启用双因素认证 (2FA)，并定期更换API密钥，以最大限度地保障您的账户安全。务必将您的API密钥和密钥妥善保管，切勿泄露给他人，防止未经授权的访问。
API密钥安全注意事项
- 妥善保管API密钥和密钥 : 这是加密货币交易安全的核心原则。API密钥和密钥如同账户的钥匙，一旦泄露，可能导致资金损失。务必将其视为高度敏感信息，切勿以任何形式分享给他人，包括通过电子邮件、聊天工具或社交媒体等渠道。请使用安全的密码管理工具存储，并定期检查其安全性。
- 使用IP白名单 : 为了进一步加强API密钥的安全性，强烈建议配置IP白名单。IP白名单允许您限制API密钥只能从预先批准的特定IP地址进行访问。这意味着即使API密钥泄露，未经授权的IP地址也无法利用它进行交易或其他操作。请仔细规划您的IP地址范围，并确保只包含必要的IP地址。许多平台都提供IP白名单设置，务必充分利用此功能。
- 定期更换API密钥 : 定期更换API密钥是预防潜在安全风险的重要措施。即使您的API密钥当前没有泄露的迹象，定期更换可以降低密钥被盗用的风险。您可以将更换API密钥视为一种例行安全维护操作，例如每隔三个月或半年更换一次。更换后，请务必更新所有使用该API密钥的应用程序和服务。
- 监控API密钥的使用情况 : 持续监控API密钥的使用情况是及时发现异常活动的关键。大多数加密货币交易所或API服务提供商都提供API使用日志或监控工具。通过这些工具，您可以跟踪API请求的来源、频率、类型等信息。如果发现任何异常行为，例如来自未知IP地址的请求、异常高的请求频率或未经授权的交易，请立即停止使用该API密钥并重新生成新的API密钥，并进一步调查事件原因。
- 避免使用公共网络 : 在设置、存储或使用API密钥时，务必避免使用公共网络，例如公共Wi-Fi。公共网络通常缺乏足够的安全保护措施，容易受到中间人攻击或数据窃取。黑客可能通过监听公共网络流量来窃取您的API密钥。请尽可能使用安全的私人网络或移动数据网络进行操作。如果必须使用公共网络，请使用VPN等安全工具来加密您的网络连接。
- 使用强密码 : 确保您的Bithumb账户或相关加密货币交易所账户使用强密码，并启用双因素认证（2FA）。强密码应包含大小写字母、数字和符号，并且长度足够。双因素认证可以在密码之外提供额外的安全保护层，即使密码泄露，攻击者也需要提供第二种身份验证方式才能访问您的账户。强烈建议您为所有重要的加密货币相关账户启用双因素认证。
- 注意钓鱼网站 : 加密货币领域存在大量的钓鱼网站，这些网站通常伪装成合法的加密货币交易所或其他服务提供商，诱骗用户输入用户名、密码或API密钥等敏感信息。请务必保持警惕，仔细检查您访问的网站地址是否正确，并确保网站具有有效的SSL证书。避免点击来自不明来源的链接或电子邮件，特别是那些要求您提供个人信息或API密钥的链接。请始终访问Bithumb或任何其他交易所的官方网站，以确保您的安全。
常见问题
- 忘记了API密钥或密钥 : 如果您不慎遗忘了您的API密钥或私钥，请务必知悉，为了账户安全，找回已丢失的密钥是不可能的。 您需要登录您的Bithumb账户，进入API管理页面，重新生成一对新的API密钥。 生成新的密钥后，请务必妥善保管，并立即停用旧的API密钥以防止潜在的安全风险。 同时，请务必审视您的密钥存储方式，建议使用加密方式存储，避免明文存储带来的风险。
-
API密钥无法使用
: 当您发现API密钥无法正常工作时，请首先检查以下几个关键方面：
- 密钥状态： 确认您的API密钥是否已成功启用。 新生成的API密钥可能需要一段时间才能激活，或者需要手动启用。
- 权限设置： 仔细检查您的API密钥所拥有的权限是否足以执行您想要进行的操作。 例如，如果您需要进行交易，则需要确保您的API密钥拥有交易权限。 缺乏相应的权限会导致API调用失败。
- IP白名单： 验证您的IP地址是否已添加到API密钥的IP白名单中。 如果启用了IP白名单限制，只有来自白名单中的IP地址才能使用该API密钥。 如果您的IP地址不在白名单中，您需要将其添加到白名单中，或选择禁用IP白名单功能。
-
API密钥被盗用
: 如果您强烈怀疑您的API密钥可能已被未经授权的第三方盗用，请采取以下紧急措施以最大程度地降低损失：
- 立即停止使用： 立即停止使用该API密钥进行任何操作。 这可以防止盗用者继续利用您的API密钥进行恶意活动。
- 重新生成密钥： 立即登录您的Bithumb账户，进入API管理页面，重新生成一对新的API密钥。 新生成的密钥将取代被盗用的密钥。
- 联系Bithumb客服： 第一时间联系Bithumb官方客服，详细报告API密钥被盗用的事件。 提供尽可能多的信息，例如可疑交易记录、异常活动等，以便客服能够协助您调查并采取必要的安全措施。 Bithumb客服可能会要求您提供身份验证信息以确认您的账户所有权。
