Bithumb平台API接口使用指南
Bithumb是全球知名的加密货币交易平台之一，提供了强大的API接口，供开发者与平台进行交互。通过API，用户可以实现自动化交易、获取市场数据、管理账户等操作。本文将详细介绍Bithumb平台API接口的调用和使用方法，帮助开发者快速上手。
1. 注册与获取API密钥
在开始使用Bithumb的API接口之前，用户首先需要在Bithumb平台上注册一个账户。这一过程涉及到提供有效的电子邮件地址、设置一个强密码，并完成身份验证以确保账户的安全性。在完成账户注册后，用户可以登录到Bithumb交易平台，进入个人设置或API管理页面。
在API管理页面，用户将能够生成和管理API密钥。为了确保密钥的安全性，Bithumb提供了不同权限级别的API密钥设置选项，包括读取数据、进行交易、资金提取等权限。用户需要根据自己的需求为API密钥配置适当的权限。
生成API密钥后，平台会提供一个“公钥”和“私钥”。公钥用于标识API请求的用户，而私钥则用于签署请求并确保请求的真实性和安全性。务必妥善保管私钥，因为一旦泄露，可能导致账户的资金和交易安全遭到威胁。
除了API密钥本身，Bithumb还提供了基于IP白名单的额外安全设置，用户可以将常用的IP地址添加到白名单中，这样只有指定的IP地址才能发起有效的API请求，这为API操作提供了一层额外的安全保障。
1.1 创建账户
访问Bithumb官网，点击页面上的注册按钮以开始账户创建流程。按照系统提示填写您的个人信息，包括有效的电子邮件地址、用户名和强密码。完成基本信息填写后，提交注册请求。为了增强账户安全性，Bithumb要求用户进行实名认证。实名认证的过程包括上传有效身份证件（如身份证或护照）的扫描件，并进行面部识别验证。此步骤是为了确保用户身份的真实性，并防止不法分子利用虚假身份进行恶意活动。实名认证完成后，您将获得更高的交易限额及更多的账户保护功能。为了进一步提高账户安全，建议启用双重身份验证（2FA），这能为账户增加一层额外的保护，防止未经授权的登录尝试。
1.2 获取API密钥
在成功登录到您的账户后，进入个人账户页面，找到并点击“API管理”选项。在“API管理”页面，您将能够创建新的API密钥。创建密钥时，您需要为新密钥分配相应的权限。这些权限包括但不限于“读取账户信息”、“进行交易”以及其他与账户操作相关的功能。您可以根据需求启用特定功能。例如，如果您只需要读取账户余额和交易历史记录，可以选择只启用“读取账户信息”的权限。如果您需要执行交易操作，则应启用“进行交易”权限。
生成API密钥后，系统将提供一组由两部分组成的密钥：API密钥和API秘密密钥。请务必妥善保管这两部分密钥，它们是您与平台交互的唯一凭证。特别注意，API密钥是公开的，而API秘密密钥则是私密的，绝不可泄露。为确保安全，建议您将API密钥和API秘密密钥存储在一个安全的位置，如密码管理工具或者加密存储设备中。
注意：API密钥和API秘密密钥是非常重要的凭证，必须严格保密。如果密钥泄露，可能导致账户资金和信息的丧失，因此在任何情况下都不应与第三方共享。
2. API基础介绍
Bithumb的API接口采用RESTful API设计风格，旨在为开发者提供简洁、高效的与平台交互的方式。RESTful API是一种基于HTTP协议的架构风格，具有无状态、可缓存和统一接口等特点。Bithumb API支持多种HTTP请求方式，包括GET、POST和DELETE，这使得开发者能够灵活地进行数据查询、提交订单以及执行删除等操作。通过GET请求，开发者可以从平台获取市场数据、账户信息等；POST请求则通常用于提交订单、资金转账等操作；而DELETE请求则用于取消订单或删除某些资源。
API的请求地址通常为https://api.bithumb.com，这意味着所有接口调用都需要通过该URL发送请求。为了确保数据传输过程中的安全性和隐私保护，Bithumb要求所有的API请求必须使用HTTPS协议。HTTPS协议通过SSL/TLS加密机制，能够防止数据在传输过程中被截获或篡改，从而保障用户的交易信息和账户数据的安全性。Bithumb API接口还采用了身份认证机制，开发者需要在API请求中包含相应的API密钥和签名，以防止未经授权的访问。
为了更好地支持开发者，Bithumb还提供了详细的API文档，帮助用户理解如何调用各个接口，如何传递参数以及如何处理响应结果。Bithumb API接口适用于各类开发需求，包括算法交易、自动化交易、数据分析等，使得开发者能够基于Bithumb平台进行深度集成和定制化开发。
2.1 接口认证
Bithumb API提供了两种主要的认证方式：
- Public API（公开API）：无需认证的接口，主要用于查询市场行情、交易对信息等。
- Private API（私有API）：需要使用API密钥进行认证，适用于账户信息、订单管理等需要权限的操作。
3. 常用API接口
Bithumb为开发者提供了一套功能全面且灵活的API接口，能够支持多种操作和数据访问，满足不同用户需求。这些API接口涵盖了账户管理、市场数据查询、交易操作等多个领域，能够帮助用户实现自动化交易、数据分析、账户监控等任务。以下是一些常见的接口及其使用方法：
- 账户信息接口: 通过该接口，用户可以获取账户的余额、交易记录、资金流水等信息。此接口需要进行身份验证，确保操作安全。接口返回的数据格式为JSON，包含了账户中各类加密货币的实时余额、可用余额等关键信息。
- 市场行情接口: 提供实时市场数据，包括各类加密货币的最新价格、交易量、涨跌幅等。用户可以通过该接口查询多个交易对的市场状态，支持历史K线数据的获取，帮助分析市场趋势。
- 交易接口: 用户可以通过该接口进行买卖交易操作，包括下单、撤单、查询订单等。接口支持市价单和限价单操作，可以指定买入或卖出的数量和价格。此接口通常结合实时市场行情接口使用，以实现更为精准的交易决策。
- 订单状态接口: 通过该接口，用户可以查询已提交的订单状态，包括已成交部分、待成交部分以及订单是否已被取消。此接口适用于监控订单执行进度，尤其在高频交易或套利策略中尤为重要。
- 资金划转接口: 此接口用于在不同账户之间转移资金，例如从现货账户转至杠杆账户，或从账户中提取资金到指定钱包地址。资金划转的操作需要双重身份验证，以确保资金的安全。
- WebSocket实时数据接口: 为了提供更高效的实时数据推送，Bithumb提供了WebSocket接口，支持实时订阅行情变化、订单执行状态等信息。相比传统的REST API，WebSocket能够以更低延迟提供实时更新，适用于需要高频数据的应用。
- 用户信息接口: 该接口允许用户查看自己的基本信息，如用户名、API密钥的权限设置、IP白名单等。通过此接口，用户可以管理和调整自己的API权限，确保账户安全。
为了保证API的高效使用，Bithumb提供了详尽的文档和示例代码，帮助开发者理解每个接口的具体用法和返回数据格式。同时，Bithumb也为用户提供了API调用频率限制和错误代码说明，确保开发者可以及时发现并解决问题。
3.1 获取市场行情
通过GET /public/ticker/{currency}接口，用户可以实时获取指定货币对的最新市场行情信息。此接口返回的数据包括多个关键指标，如最新成交价格、24小时最高和最低价格、24小时交易量等，帮助用户了解市场的波动情况。支持的货币对通常涵盖了常见的法币与加密货币之间的交易对，如BTC/USD、ETH/BTC等。该接口可以用于获取单一货币对的详细数据，也可结合多个货币对进行批量查询，便于用户进行市场分析和决策。返回的数据通常包括成交深度、买卖盘价格等信息，使得交易者能够全面评估市场流动性和买卖盘的动态。此接口也可与图表展示工具结合使用，支持实时更新，适合需要快速反应市场变化的场景。
请求示例
以下是通过Bithumb公开API请求获取BTC/KRW（比特币对韩元）最新市场数据的示例：
GET https://api.bithumb.com/public/ticker/BTC_KRW该API接口返回Bithumb交易所上BTC/KRW的实时行情，包括最新的买入价、卖出价、24小时最高价、最低价、成交量等信息。API通过HTTP GET方法进行请求，并且不需要认证密钥，可以公开访问。
请求中的“BTC_KRW”部分指定了交易对，意味着请求的是比特币（BTC）与韩元（KRW）之间的交易数据。如果需要查询其他交易对的数据，只需替换URL中的交易对标识符，例如“ETH_KRW”表示以太坊对韩元的市场信息。
返回的响应将是一个JSON格式的对象，包含详细的市场数据，通常包括以下字段：
- status - 请求状态，通常为"0000"表示成功。
- data - 包含实际市场数据的对象。
- data.opening_price - 开盘价。
- data.closing_price - 收盘价。
- data.min_price - 24小时最低价。
- data.max_price - 24小时最高价。
- data.units_traded - 24小时内的交易量。
- data.volume_1day - 1天交易量。
此API请求适用于开发者需要实时获取市场数据并进行展示或分析的场景，可以帮助实现自动化的市场监控和实时数据流的应用。
响应示例
{ "status": "0000", "data": { "opening_price": "5800000", "closing_price": "5900000", "min_price": "5700000", "max_price": "6000000", "units_traded": "1500.0", "acc_trade_value": "8700000000.0", "prev_closing_price": "5800000", "units_traded_24H": "1450.0", "acc_trade_value_24H": "8500000000.0", "fluctate_24H": "100000", "fluctate_rate_24H": "1.72" } }
此接口返回的data部分包含了指定货币对在一定时间周期内的市场数据，包括但不限于最新的开盘价、收盘价、最高价、最低价、成交量以及价格波动信息。具体字段说明如下：
- opening_price：表示指定货币对的开盘价，即在当前交易周期开始时的第一个成交价格。
- closing_price：表示当前周期的收盘价，即在该周期结束时的最后成交价格。
- min_price：指定货币对在当前周期内的最低交易价格，反映市场波动的下限。
- max_price：指定货币对在当前周期内的最高交易价格，反映市场波动的上限。
- units_traded：表示当前周期内成交的总交易数量，即所有买卖交易的合计数量。
- acc_trade_value：累计成交的交易金额，通常是指以当前市场价格计的总交易额，反映市场的整体交易活跃度。
- prev_closing_price：上一个交易周期的收盘价，用于与当前周期的收盘价进行对比，分析价格变动趋势。
- units_traded_24H：过去24小时内的总成交数量，提供了最近24小时市场活动的总体情况。
- acc_trade_value_24H：过去24小时的总交易金额，帮助用户了解在最近24小时内市场的总交易量和资金流动情况。
- fluctate_24H：过去24小时内价格波动的绝对值，通常计算为最大价格与最小价格之间的差额，用于衡量市场的波动性。
- fluctate_rate_24H：过去24小时内价格波动的百分比，通常是波动幅度与初始价格的比值，用于衡量市场的波动程度。
通过分析这些数据，用户可以更全面地了解目标货币对在一定时间内的市场表现、价格波动情况以及交易活跃度，从而做出更为精准的交易决策。
3.2 获取账户信息
用户可以通过调用POST /info接口来获取与账户相关的详细信息。该接口会返回包括账户余额、资产详细信息、交易历史等关键数据。具体来说，返回内容可能包括用户的各类加密货币资产的余额信息（如比特币、以太坊、USDT等），以及每种资产的当前价值、持有数量、冻结余额等。同时，用户还可以查看各个资产的汇率信息，进一步了解其当前的市场价值。接口返回的内容可能包含账户的状态信息，如是否启用2FA（双重身份验证）、账户是否被冻结、可用API请求次数等。为了确保安全性，接口调用时需要提供有效的API密钥作为认证方式，以验证请求者的身份。API密钥的正确性直接决定了数据的访问权限，未通过认证的请求将被拒绝。此接口是用户查看账户状态、资产变动和管理资金的重要工具。
请求示例
bash
POST https://api.bithumb.com/info Content-Type: application/ Api-Key:
在上述请求中，API请求方法为POST，并且请求URL为https://api.bithumb.com/info。这是Bithumb交易所提供的一个常见API端点，通常用于请求平台上的系统信息或相关数据。请求头中需要包含Content-Type和Api-Key。Content-Type通常设置为application/，表明请求体内容使用JSON格式编码。在Api-Key字段中需要提供您在Bithumb平台上注册并生成的API密钥，该密钥用于身份验证和授权，以确保请求来自有效的用户。
请确保API密钥的保密性，避免泄露或滥用。通过Bithumb的API，用户可以访问不同类型的市场数据、账户信息、交易记录以及其他相关的系统资源。请求的响应将根据所请求的信息类型返回相应的JSON格式数据。
3.4 取消订单
在加密货币交易中，如果用户希望取消尚未成交的订单，可以通过调用POST /trade/cancel接口来执行这一操作。该接口允许用户撤销指定订单，前提是订单尚未被匹配或执行。一旦订单被取消，系统会返回相应的响应信息，确认该操作已成功完成。用户需提供取消的订单ID作为参数，该ID通常由下单时系统返回，确保能够准确识别需要取消的订单。
需要注意的是，取消订单的请求只能应用于处于挂单状态的订单，即尚未与市场上的其他订单匹配完成的订单。对于已经成交的订单，取消操作将无效。若订单存在部分成交，系统可能允许取消未成交部分，具体取决于交易平台的实现和规则。不同平台可能会有各自的处理方式和限制，因此在实际操作时建议详细查阅平台文档。
调用POST /trade/cancel接口时，除了订单ID，还可能需要额外的认证信息，如API密钥，以确保请求的合法性和安全性。接口返回的响应将包含订单取消状态，帮助用户确认订单取消是否成功，通常返回的状态码为200，表示操作成功，若遇到错误或订单已成交，平台会返回相应的错误代码和消息。
请求示例
bash
POST https://api.bithumb.com/trade/cancel
Content-Type: application/
Api-Key:
{
"order_id": "12345678"
}
该请求用于取消指定的交易订单，通常在您想撤销先前提交的买入或卖出指令时使用。
在实际操作中，请确保您已经成功生成并拥有有效的API密钥（Api-Key）。此API密钥在请求头部需要以正确格式传递，以确保您能够获得权限并进行操作。
请求路径中的“https://api.bithumb.com/trade/cancel”是Bithumb交易所的取消订单接口，适用于撤销指定的订单。在请求体中，您需要传递目标订单的唯一标识符，即“order_id”。每个订单的ID都是唯一的，可以通过之前提交订单时的响应获取。
为了确保请求的准确性和安全性，请务必保持API密钥的机密性，避免泄露。通过使用该API接口，您可以在订单未完全成交前，及时取消未执行的订单。对于已经部分成交的订单，部分的未成交部分将被取消。此功能在市场波动较大时尤其重要，可以帮助用户控制风险。
响应示例
{ "status": "0000", "data": { "order_id": "12345678", "status": "cancelled", "cancel_reason": "User requested cancellation due to incorrect order details", "cancel_timestamp": "2025-02-07T12:34:56Z", "refund_status": "initiated", "refund_amount": "100.00", "currency": "USD", "transaction_id": "txn_98765432" } }
4. 错误处理
Bithumb API在发生错误时，会返回错误代码和错误信息。常见的错误代码如下：
0000：请求成功。1000：参数错误。2000：API密钥错误。3000：请求超时。4000：系统错误。
开发者在进行API调用时，需注意检查返回的status字段，确保请求成功。如果返回了错误码，可以参考错误说明进行调试。
5. 安全性注意事项
在使用Bithumb的API时，需要特别注意以下安全事项：
- 保护API密钥：不要将API密钥暴露给不可信的第三方。建议将API密钥保存在环境变量或加密存储中。
- 限制API权限：为避免泄露资金，建议在生成API密钥时只授权必要的权限。
- 防止DDoS攻击：通过合理限制请求频率，避免API接口滥用。
- 使用HTTPS：确保所有API请求都通过HTTPS协议进行，以保障数据传输的安全性。