Upbit API接口指南：入门、申请与实战技巧

Upbit API 接口：从入门到实战指南

在加密货币交易的世界里，API (应用程序编程接口) 是连接你与交易所的桥梁。Upbit 作为韩国领先的加密货币交易所，提供了强大的 API 接口，允许开发者和交易员自动化交易策略、获取实时市场数据以及管理账户。本文将详细介绍 Upbit API 接口的申请流程和使用方法，帮助你充分利用 Upbit API，提升交易效率。

一、Upbit API 接口的优势

使用 Upbit API 接口进行加密货币交易和数据获取，与手动操作相比，能够提供一系列显著的优势。这些优势不仅提升了交易效率，也增强了决策的智能化程度。

自动化交易： 通过编写程序，可以实现交易策略的自动化执行。这意味着您可以设定预先定义的规则，让程序在满足特定市场条件时自动下单、平仓，从而避免因人为延迟而错失潜在的市场机会。自动化交易消除了情绪因素的影响，确保交易决策更加理性。
实时数据获取： Upbit API 接口能够提供实时的市场行情数据、交易深度信息（如买卖盘口深度），以及历史交易数据。这些数据对于进行技术分析、识别市场趋势至关重要。利用实时数据，您可以更准确地评估市场状况，从而做出更明智的交易决策。
高效性： API 接口支持批量处理订单和数据请求。这使得您可以同时管理多个交易对，或者快速地分析大量的历史数据。相比手动操作，API 接口能够显著提高交易和数据处理的效率，节省时间和精力。
灵活性： Upbit API 接口允许用户根据自身的需求，定制个性化的交易策略和数据分析工具。您可以结合不同的技术指标、风险管理策略，构建符合自己投资风格的自动化交易系统。还可以利用 API 接口获取的数据，开发自定义的图表和分析工具，更深入地了解市场动态。

二、Upbit API 接口申请流程

申请 Upbit API 接口需要进行身份验证，以确保账户及交易安全。Upbit API 允许开发者通过程序化方式访问交易所的数据和功能，例如获取实时行情、下单交易、查询账户信息等。因此，为了防止恶意使用和保障用户资产安全，身份验证是必不可少的环节。以下是详细的申请步骤：

登录 Upbit 账户： 您需要访问 Upbit 官方网站 (upbit.com) 并使用您的账户凭据登录。如果您还没有 Upbit 账户，则需要先注册一个账户。注册过程通常需要提供个人信息、进行邮箱或手机验证，并设置安全密码。
访问 API 密钥管理页面： 登录后，在账户设置或个人中心页面寻找“API 密钥管理”、“开发者 API”或类似的选项。不同交易所的页面布局可能略有不同，但通常可以在安全设置或账户信息相关区域找到。
创建 API 密钥： 在 API 密钥管理页面，点击“创建 API 密钥”、“生成密钥”或类似的按钮。系统会提示您设置 API 密钥的权限。 Upbit 允许您选择只读权限 (Read Only) 或读写权限 (Read & Write)。如果您的应用只需要获取市场数据，建议仅授予只读权限以降低安全风险。如果您的应用需要进行交易操作，则需要授予读写权限。
设置 API 密钥权限： 选择合适的 API 密钥权限后，系统会要求您进行二次身份验证，例如通过 Google Authenticator、短信验证码或其他安全验证方式。这是为了确保只有账户所有者才能创建 API 密钥。
获取 API 密钥： 完成二次身份验证后，系统会生成您的 API 密钥 (API Key) 和密钥Secret (API Secret)。 请务必妥善保管您的 API 密钥和密钥 Secret。 密钥Secret只会在创建时显示一次，之后将无法再次查看。如果密钥Secret丢失，您需要重新生成 API 密钥。请不要将 API 密钥和密钥Secret泄露给他人，也不要将其保存在不安全的地方，例如代码库或公共服务器。
启用 IP 白名单（可选但强烈推荐）： 为了进一步增强 API 密钥的安全性，强烈建议您启用 IP 白名单功能。 IP 白名单允许您指定只有来自特定 IP 地址的请求才能使用该 API 密钥。通过设置 IP 白名单，即使 API 密钥泄露，未经授权的 IP 地址也无法使用该密钥访问您的 Upbit 账户。您可以在 API 密钥管理页面设置 IP 白名单。请确保您添加的 IP 地址是您的服务器或应用程序的公网 IP 地址。
阅读 Upbit API 文档： 获得 API 密钥后，您需要仔细阅读 Upbit 官方提供的 API 文档。 API 文档详细介绍了 Upbit API 的各个接口的功能、参数、返回值和使用方法。熟悉 API 文档是成功使用 Upbit API 的关键。您可以在 Upbit 官方网站的开发者中心或 API 文档页面找到 Upbit API 文档。

1. Upbit 账户注册与身份验证:

账户注册: 你需要一个 Upbit 账户才能开始使用其 API 服务。如果你还没有账户，请访问 Upbit 官方网站 ( https://upbit.com ) 进行注册。注册过程中，请务必使用真实有效的个人信息，以便顺利通过后续的身份验证。
KYC 身份验证: 注册完成后，登录你的 Upbit 账户，并完成 KYC (Know Your Customer) 身份验证。 KYC 身份验证是金融机构为了防止洗钱和恐怖主义融资而采取的必要措施。 Upbit 通常会要求你提供以下信息和文件：
- 身份证明文件： 例如身份证、护照或驾驶执照的扫描件或照片。确保文件清晰可读，并且在有效期内。
- 地址证明文件： 例如银行账单、水电费账单或信用卡账单。账单上的姓名和地址必须与你注册 Upbit 账户时提供的信息一致，且通常需要是最近三个月内的账单。
- 其他补充材料： 根据 Upbit 的要求，你可能需要提供额外的补充材料，例如手持身份证明文件的照片或视频。
身份验证的等级会影响 API 的使用权限，例如交易额度、API 调用频率等。建议尽早完成高级别的身份验证，以便获得更大的灵活性。
安全措施: 务必绑定手机号码和邮箱，并启用双重验证 (2FA)。这在后续的 API Key 管理中至关重要，可以有效防止账户被盗用。强烈建议使用 Google Authenticator 或 Authy 等信誉良好的 2FA 应用程序，而不是短信验证码。

2. 生成 API Key 和 Secret Key:

完成 Upbit 账户的身份验证流程后，登录你的 Upbit 账户。访问 API 管理页面，通常位于“我的信息”、“账户设置”、“安全设置”或类似的账户管理区域。具体位置可能因 Upbit 平台更新而略有变化。
在 API 管理页面，找到并点击“申请 API Key”、“创建 API Key”或类似的按钮开始 API 密钥的生成流程。
你需要详细配置 API Key 的权限，这些权限决定了通过 API 能够执行的操作。Upbit 提供的权限选项包括但不限于：
- 交易权限（Trade）： 允许使用 API 执行买入、卖出、撤销订单等交易操作。启用此权限后，API 密钥将能够直接影响账户的资金流动。 务必谨慎授予交易权限，仅在明确了解并信任使用该 API 密钥的应用或脚本时才应开启。严格控制交易频率和订单类型，避免意外损失。
- 查询权限（Info/View）： 允许使用 API 获取账户余额、交易历史、订单状态等信息。此权限通常用于监控账户状态、分析交易数据等目的。 即使只授予查询权限，也应注意 API 密钥的安全性，防止被滥用以获取敏感信息。
- 提币权限（Withdraw）： 允许使用 API 发起提币请求，将账户中的数字资产转移到其他地址。强烈建议不要开启此权限，这是最高风险的权限。一旦泄露，可能导致账户资金被盗。如果确实需要使用 API 进行提币，务必采取极其严格的安全措施，例如 IP 地址白名单、提币地址白名单、小额提币限制等。
在选择所需的权限后，请仔细阅读并完全理解 Upbit 提供的 API 使用条款和服务协议。这些条款详细说明了 API 的使用规范、责任承担以及潜在风险。
提交 API 申请后，Upbit 会生成一对唯一的 API Key（公钥）和 Secret Key（私钥）。API Key 用于标识你的应用程序或脚本，Secret Key 用于验证 API 请求的身份。务必将 Secret Key 妥善保管，采取如同保管银行密码一样严密的措施。切勿通过任何不安全的渠道传输 Secret Key，例如电子邮件、聊天消息等。永远不要将 Secret Key 存储在代码中或公开的存储库中。Secret Key 泄露会导致账户安全风险，攻击者可以使用你的 API 密钥进行未经授权的交易或提币操作。
在某些情况下，为了提高安全性，Upbit 可能会要求进行额外的安全验证，例如双因素身份验证 (2FA)，以确认 API 密钥申请者的身份。建议始终启用双因素身份验证，以增强账户的整体安全性。启用 IP 地址白名单，限制只有特定的 IP 地址才能使用 API，也是一个有效的安全措施。定期更换 API Key 和 Secret Key 也有助于降低安全风险。

3. IP 白名单设置 (可选但强烈推荐):

为了显著增强 API Key 的安全性，强烈推荐设置 IP 白名单。IP 白名单机制允许您精准地指定一组或多组可以合法访问您的 API 密钥的 IP 地址。通过启用 IP 白名单，系统将严格限制只有来自这些预先批准的 IP 地址的 API 请求才会被接受和处理，从而有效防止未经授权的访问和潜在的恶意攻击。
在您的 API 管理控制面板或设置页面中，仔细查找与 IP 白名单配置相关的选项。该选项可能位于安全设置、访问控制或类似的分类下。请仔细阅读平台的文档，以确定准确的位置和配置方法。
仔细核实并添加您用于访问 API 的所有服务器或电脑的公网 IP 地址。请务必包含所有需要调用 API 的应用程序、服务和设备的 IP 地址。需要注意的是，如果您的服务器或电脑使用动态 IP 地址，则需要定期更新白名单，以确保 API 的持续可用性。某些平台支持使用 IP 地址段（CIDR 表示法），方便批量管理 IP 地址。

4. 测试 API Key:

获得 API Key 和 Secret Key 后，务必立即进行 API Key 的有效性验证。采用简单的 API 请求进行测试，是确保密钥配置正确的有效手段，可以尽早发现潜在的配置问题，避免后续开发过程中的不必要障碍。
建议选择一个不需要交易权限的 API 端点进行测试。例如，调用获取账户余额的 API 接口，这是一个常见的、低风险的测试方法。成功获取账户余额，则表明 API Key 的基础配置是正确的，能够与交易所的 API 服务器建立连接并进行数据交互。如果测试失败，应仔细检查 API Key、Secret Key 是否正确，以及网络连接是否畅通，并确保已按照交易所的 API 文档配置了必要的权限。

三、Upbit API 使用方法

Upbit API 采用 RESTful 架构，通过标准的 HTTP 请求进行数据交互，便于开发者快速集成和获取市场数据。Upbit 提供了一系列 API 接口，涵盖行情数据、交易操作、账户信息等多个方面。以下是一些常用的 API 接口，以及使用示例，旨在帮助开发者更好地理解和应用 Upbit API：

1. 行情数据接口：

市场代码查询： 用于获取 Upbit 支持的所有市场代码（例如：KRW-BTC，BTC-ETH）。通过该接口，开发者可以了解 Upbit 上可交易的所有币种和交易对。
实时行情查询： 提供实时成交价、成交量、最高价、最低价等信息。该接口是进行量化交易和市场分析的基础。
K线数据查询： 获取指定时间段内的 K 线数据（例如：1 分钟、5 分钟、1 小时 K 线）。K 线数据对于技术分析至关重要，可以帮助开发者识别趋势和模式。
Ticker 信息查询： 提供最近 24 小时内的交易信息，包括成交总额、涨跌幅等。

2. 交易操作接口：

下单接口： 允许用户进行买入或卖出操作。需要指定市场代码、交易类型（市价单或限价单）、数量和价格（限价单）。
取消订单接口： 用于取消未成交的订单。需要提供订单的唯一标识符（UUID）。
查询订单接口： 获取指定订单的状态和详细信息。
查询所有未成交订单接口： 获取用户所有未成交的订单列表。

3. 账户信息接口：

查询账户信息接口： 获取用户的账户余额信息，包括可用余额和已冻结余额。
查询交易历史接口： 获取用户的交易历史记录，包括成交时间、成交价格、成交数量等。

API 使用示例：

以下是一个使用 Python 语言调用 Upbit API 获取市场代码的示例：


import requests

url = "https://api.upbit.com/v1/market/all"
headers = {"Accept": "application/"}

response = requests.get(url, headers=headers)

print(response.())

安全注意事项：

在使用 Upbit API 进行交易操作时，务必妥善保管您的 API 密钥，并采取必要的安全措施，例如：

限制 API 密钥的访问权限： 只授予 API 密钥必要的权限，避免泄露敏感信息。
使用 IP 白名单： 限制 API 密钥只能从指定的 IP 地址访问。
定期更换 API 密钥： 定期更换 API 密钥，以降低安全风险。

请务必参考 Upbit 官方 API 文档获取最准确和最新的 API 信息和使用方法。

1. 获取市场行情:

API 端点: /v1/ticker
HTTP 方法: GET
请求参数:
- markets (必选): 指定要查询的市场代码列表，多个市场代码用逗号分隔。例如： KRW-BTC , USDT-ETH , BTC-LTC 。市场代码遵循交易所约定的格式，通常为 [计价货币]-[交易货币] 。
功能描述: 此 API 用于获取指定加密货币市场的最新行情信息，包括但不限于最新成交价、成交量、24小时涨跌幅等。通过指定不同的 markets 参数，可以一次性查询多个市场的行情数据。
响应数据格式: API 将返回 JSON 格式的数据，其中包含每个指定市场的详细行情信息。具体的字段包括：
- market : 市场代码 (例如: KRW-BTC )
- trade_date : 最新成交日期 (YYYYMMDD 格式)
- trade_time : 最新成交时间 (HHMMSS 格式)
- trade_date_utc : 最新成交日期 (UTC 时间, YYYYMMDD 格式)
- trade_time_utc : 最新成交时间 (UTC 时间, HHMMSS 格式)
- trade_price : 最新成交价
- trade_volume : 最新成交量
- prev_closing_price : 前日收盘价
- change : 涨跌类型 ( RISE : 上涨, FALL : 下跌, EVEN : 不变)
- change_price : 涨跌额
- change_rate : 涨跌幅 (%)
- signed_change_price : 符号位涨跌额 (正数表示上涨, 负数表示下跌)
- signed_change_rate : 符号位涨跌幅 (%)
- ask_bid : 买卖状态 ( ASK : 卖出, BID : 买入)
- volume : 24 小时累计成交量
- high_price : 24 小时最高价
- low_price : 24 小时最低价
- timestamp : 时间戳 (Unix 时间戳, 毫秒)
错误处理: 如果请求参数不正确或服务器发生错误，API 将返回相应的 HTTP 状态码和错误信息。例如：
- 400 Bad Request : 请求参数错误 (例如： markets 参数缺失或格式不正确)
- 404 Not Found : 找不到指定的市场
- 500 Internal Server Error : 服务器内部错误
使用示例: 假设要获取 KRW-BTC 和 USDT-ETH 市场的行情数据，可以使用以下 URL 发送 GET 请求： /v1/ticker?markets=KRW-BTC,USDT-ETH

示例 (使用 Python):

使用 Python 编程语言与 Upbit 交易所的 API 进行交互，首先需要安装 requests 库，该库用于发起 HTTP 请求。如果尚未安装，可以通过 pip 包管理器进行安装： pip install requests 。

引入必要的库。 requests 库用于发送 HTTP 请求，库用于处理 JSON 格式的数据。


import requests
import

定义 API 的 URL 和查询参数。 url 变量指定了 Upbit API 的 endpoint，这里是获取 ticker 信息的接口。 querystring 字典包含了查询参数， markets 参数指定了要查询的市场，这里是 KRW-BTC (韩元-比特币)。


url = "https://api.upbit.com/v1/ticker"
querystring = {"markets":"KRW-BTC"}

使用 requests.request() 函数发起 GET 请求。第一个参数是 HTTP 方法 (GET)，第二个参数是 URL， params 参数传递查询参数。 response 对象包含了服务器返回的所有信息，包括状态码、headers 和响应内容。


response =  requests.request("GET",  url, params=querystring)

处理 API 响应。 response.text 包含了 API 返回的 JSON 格式的字符串。 .loads() 函数将 JSON 字符串解析为 Python 字典或列表。 .dumps() 函数将 Python 对象转换为 JSON 字符串，并使用 indent=4 参数进行格式化，使其更易于阅读。 print() 函数将格式化后的 JSON 字符串输出到控制台。


print(.dumps(.loads(response.text), indent=4))

2. 获取交易深度:

API端点: /v1/orderbook
HTTP方法: GET
请求参数:

markets ( 必选 ): 指定需要查询的市场代码。市场代码代表交易对，格式为 [交易货币]-[定价货币] ，例如 KRW-BTC 表示韩元交易比特币的市场。您可以同时查询多个市场，通过逗号分隔市场代码，例如： KRW-BTC,USDT-ETH 。请注意，市场代码必须有效，否则API将返回错误。

响应数据: API将返回一个JSON对象，其中包含指定市场的交易深度信息。交易深度信息包括买单（Bid）和卖单（Ask）的价格和数量。
示例:

请求: GET /v1/orderbook?markets=KRW-BTC
响应: (一个JSON对象，包含KRW-BTC的买卖盘数据，示例数据略，实际响应数据包含更详细的价格和数量信息)

注意事项:

交易深度数据是实时变化的，请注意缓存策略，避免频繁请求API。
API接口存在频率限制，请参考API文档了解具体的频率限制规则。
返回的交易深度数据可能包含多个价格级别的订单，请根据实际需求进行解析和处理。
请务必处理API返回的错误信息，例如市场代码无效、请求频率过高等。

示例 (使用 Python):

在加密货币交易中，获取实时订单簿数据至关重要。以下示例展示了如何使用 Python 编程语言，通过 Upbit 交易所的 API 接口获取指定交易对的订单簿信息。

我们需要导入 `requests` 库来发送 HTTP 请求，以及 `` 库来处理 API 返回的 JSON 格式数据。

import requests import

定义 API 的 URL 地址和查询参数。`url` 变量设置为 Upbit 订单簿 API 的 endpoint。`querystring` 字典指定了要查询的交易对，这里以 KRW-BTC（韩元-比特币）为例。你可以根据需要修改 `markets` 参数的值来获取其他交易对的订单簿数据。

url = "https://api.upbit.com/v1/orderbook" querystring = {"markets":"KRW-BTC"}

使用 `requests.request()` 方法发送 GET 请求到 Upbit API。`"GET"` 参数指定请求方法。 `url` 参数是 API 的 URL。 `params` 参数传递查询字符串。`response` 对象包含了 API 返回的响应数据。

response = requests.request("GET", url, params=querystring)

API 返回的数据通常是 JSON 格式的字符串。使用 `.loads()` 函数将 JSON 字符串转换为 Python 字典或列表。`response.text` 包含了 API 返回的原始文本数据。然后，使用 `.dumps()` 函数将 Python 对象格式化为 JSON 字符串，并使用 `indent=4` 参数进行美化，使其更易于阅读。使用 `print()` 函数将格式化后的 JSON 数据输出到控制台。

print(.dumps(.loads(response.text), indent=4))

通过以上步骤，你可以成功获取并解析 Upbit 交易所的订单簿数据。这些数据可以用于分析市场深度、评估买卖压力，以及制定交易策略。

3. 获取账户余额:

API 端点: /v1/accounts
HTTP 方法: GET
身份验证需求: 进行此项操作需要进行身份验证。用户需使用其 API Key 和 Secret Key 对请求进行数字签名，以验证身份和确保请求的安全性。签名过程通常涉及将请求参数、时间戳和 Secret Key 组合在一起，使用哈希算法（例如 HMAC-SHA256）生成签名，并将签名包含在请求头中。交易所或服务提供商会使用 API Key 验证签名，并据此授权访问账户余额信息。
请求参数 (可选):
- currency : (字符串) 指定要查询的货币类型。例如，"BTC" 表示比特币，"ETH" 表示以太坊。如果未指定，则返回所有货币的余额。

响应示例 (JSON):

    
    [
      {
        "currency": "BTC",
        "available": "1.00000000",
        "locked": "0.50000000",
        "total": "1.50000000"
      },
      {
        "currency": "ETH",
        "available": "5.00000000",
        "locked": "2.00000000",
        "total": "7.00000000"
      }
    ]

currency : 货币类型。
available : 可用余额，即可用于交易或提现的余额。
locked : 锁定余额，通常用于挂单或其他未完成的交易。
total : 总余额，等于可用余额加上锁定余额。

错误处理: 如果API Key无效或签名不正确，服务器将返回相应的错误代码和消息。常见的错误包括 "Invalid API Key" (无效的API密钥) 和 "Invalid Signature" (无效的签名)。请确保API Key和Secret Key正确配置，并正确计算签名。速率限制也可能导致错误，需注意API的使用频率。

示例 (使用 Python，需要安装 PyJWT 和 Requests 库):

本示例展示如何使用 Python 语言以及 PyJWT 库来生成用于 Upbit API 身份验证的 JWT (JSON Web Token)，并使用 Requests 库发送经过身份验证的请求。在使用前，请确保已安装所需的库： pip install pyjwt requests 。

导入必要的模块：

import jwt
import uuid
import hashlib
from urllib.parse import urlencode
import requests
import

接下来，替换以下占位符为你自己的 Upbit Access Key 和 Secret Key。请务必妥善保管你的密钥，切勿泄露。

access_key = "YOUR_ACCESS_KEY"  # 替换为你的 Access Key
secret_key = "YOUR_SECRET_KEY"  # 替换为你的 Secret Key

构建 JWT 的 Payload (载荷)。Payload 包含你的 Access Key 和一个唯一的 nonce 值。Nonce 用于防止重放攻击，每次请求都应该生成一个新的 nonce。

payload = {
    'access_key': access_key,
    'nonce': str(uuid.uuid4()),
}

使用你的 Secret Key 和 HS256 算法对 Payload 进行签名，生成 JWT Token。

jwt_token = jwt.encode(payload, secret_key, algorithm="HS256")
authorize_token = 'Bearer {}'.format(jwt_token)

创建请求头，将 JWT Token 添加到 Authorization 头部。Upbit API 使用 Bearer Token 认证方式。

headers = {"Authorization": authorize_token}

指定你要访问的 Upbit API 接口 URL。这里以获取账户信息的接口为例。

url = "https://api.upbit.com/v1/accounts"

使用 Requests 库发送 GET 请求，并在请求头中包含 Authorization 信息。注意处理可能出现的网络连接错误和 API 错误码。

response = requests.get(url, headers=headers)
response.raise_for_status() #  如果响应状态码不是 200，则抛出 HTTPError 异常

print(.dumps(.loads(response.text), indent=4))

将 API 返回的 JSON 数据格式化输出，方便查看和调试。使用了 .dumps 方法进行美化输出，增加了缩进。

4. 下单:

API 端点: /v1/orders
HTTP 方法: POST
身份验证要求: 需要通过 API Key 和 Secret Key 生成签名进行身份验证。建议使用 HMAC (Hash-based Message Authentication Code) 算法进行签名，确保请求的安全性与完整性。请参考API文档中关于身份验证的详细说明。
请求参数:
- market (必选参数，市场代码，指定交易的市场。例如 KRW-BTC 表示韩元交易比特币的市场)
- side (必选参数，交易方向。 bid 代表买入，即希望以指定价格购买； ask 代表卖出，即希望以指定价格出售)
- volume (必选参数，交易数量，表示买入或卖出的数字货币数量。请注意数量的精度限制，避免因精度问题导致下单失败)
- price (必选参数，委托价格，表示期望的交易价格。对于市价单，此参数通常会被忽略，但某些交易所可能要求指定一个溢价价格作为滑点保护)
- ord_type (必选参数，订单类型，用于指定订单执行的方式。 limit 表示限价单，以指定价格或更优价格成交； price 等同于 limit，部分平台使用； market 表示市价单，以当前市场最优价格立即成交)
关于订单参数的更详细说明，请参考 API 文档中关于“创建订单”部分的描述，其中包含各种订单类型和高级参数的使用方法。

示例 (使用 Python，需要安装 PyJWT、requests 库):

此示例演示了如何使用 Python 与 Upbit 交易所的 API 进行交互，特别是如何生成和使用 JWT (JSON Web Token) 进行身份验证。您需要安装 PyJWT 和 requests 库。可以使用 pip 安装： pip install PyJWT requests 。

import jwt
import uuid
import hashlib
from urllib.parse import urlencode
import requests
import

导入必要的库： jwt 用于生成 JWT， uuid 用于生成唯一 ID（nonce）， hashlib 用于生成查询参数的哈希值， urllib.parse 用于编码 URL 参数， requests 用于发送 HTTP 请求，用于格式化输出。

access_key = "YOUR_ACCESS_KEY"  # 替换为你的 Access Key
secret_key = "YOUR_SECRET_KEY"   # 替换为你的 Secret Key

将 YOUR_ACCESS_KEY 和 YOUR_SECRET_KEY 替换为你在 Upbit 交易所获得的真实 Access Key 和 Secret Key。请妥善保管你的 Secret Key，避免泄露。

query = {
    'market': 'KRW-BTC',
    'side': 'bid',
    'volume': '0.0001',
    'price': '10000',
    'ord_type': 'limit',
}

定义一个字典 query ，包含订单的相关参数。

market : 交易市场，例如 "KRW-BTC" 表示韩元交易比特币。
side : 订单方向，"bid" 表示买入，"ask" 表示卖出。
volume : 订单数量，例如 "0.0001" 表示购买 0.0001 个比特币。
price : 订单价格，例如 "10000" 表示以 10000 韩元的价格购买。
ord_type : 订单类型，"limit" 表示限价单。

可以根据需求修改这些参数。

query_string = urlencode(query).encode()

使用 urllib.parse.urlencode() 将 query 字典转换为 URL 编码的字符串，并使用 .encode() 方法将其编码为字节串，以便进行哈希计算。

m = hashlib.sha512()
m.update(query_string)
query_hash = m.hexdigest()

创建一个 SHA512 哈希对象，并将 URL 编码后的查询字符串更新到哈希对象中。然后，使用 hexdigest() 方法获取哈希值的十六进制表示形式。Upbit API 要求对查询参数进行哈希计算，并将哈希值包含在 JWT 中。

payload = {
    'access_key': access_key,
    'nonce': str(uuid.uuid4()),
    'query_hash': query_hash,
    'query_hash_alg': 'SHA512',
}

创建一个 payload 字典，包含以下信息：

access_key : 你的 Access Key。
nonce : 一个唯一的随机字符串，使用 uuid.uuid4() 生成。每次请求都应该生成一个新的 nonce。
query_hash : 查询参数的 SHA512 哈希值。
query_hash_alg : 哈希算法，设置为 "SHA512"。

这个 payload 将被编码为 JWT。

jwt_token = jwt.encode(payload, secret_key, algorithm="HS256")
authorize_token = 'Bearer {}'.format(jwt_token)

使用 jwt.encode() 函数将 payload 字典编码为 JWT。

第一个参数是 payload。
第二个参数是你的 Secret Key。
第三个参数是加密算法，设置为 "HS256"。

然后，创建一个 Authorization token，格式为 "Bearer "。

headers = {"Authorization": authorize_token}

创建一个 headers 字典，包含 Authorization token。这个 header 将被添加到 HTTP 请求中。

url = "https://api.upbit.com/v1/orders"

定义 API 的 URL。在这个例子中，我们使用 "https://api.upbit.com/v1/orders" 来创建一个订单。

response = requests.post(url, headers=headers, =query)

使用 requests.post() 函数发送一个 POST 请求到 API。

第一个参数是 URL。
headers 参数包含 Authorization token。
参数包含订单参数。使用``参数会自动将`query`转换为格式，并设置Content-Type为application/

print(.dumps(.loads(response.text), indent=4))

打印 API 的响应。 response.text 包含 API 响应的 JSON 字符串。首先使用 .loads() 将 JSON 字符串转换为 Python 对象，然后使用 .dumps() 将 Python 对象格式化为 JSON 字符串，并使用 indent=4 参数进行缩进，以便更易于阅读。

重要提示:

API Key 安全： 务必极其妥善地保管您的 Upbit API Key 和 Secret Key，切勿以任何方式泄露给任何人。API Key 和 Secret Key 是访问您 Upbit 账户的凭证，泄露可能导致资金损失。强烈建议采用环境变量或安全的配置文件来存储 API Key 和 Secret Key，绝对避免将其硬编码在应用程序代码中。硬编码容易被恶意人员通过反编译等手段获取，造成安全风险。定期更换 API Key 可以进一步增强安全性。
请求频率限制： Upbit API 实施了严格的请求频率限制，旨在保护系统稳定性和公平性。如果您的应用程序超过了规定的请求频率，Upbit 可能会暂时禁止您的 IP 地址访问 API。因此，在开发过程中，必须合理地控制您的 API 请求频率，并实施适当的节流机制。请务必查阅 Upbit 官方 API 文档，详细了解针对不同 API 端点的具体频率限制。可以使用队列、令牌桶等算法来控制请求速率，确保程序不会超过限制。
错误处理： 在编写与 Upbit API 交互的代码时，必须进行全面的错误处理。这包括捕获各种可能出现的网络错误，例如连接超时、DNS 解析失败等，以及处理 Upbit API 返回的各种错误码。API 返回的错误码包含了关于请求失败原因的详细信息，您可以根据错误码进行相应的处理，例如重试请求、记录错误日志、或者通知用户。良好的错误处理机制能够提高应用程序的健壮性和可靠性，避免因错误而导致的程序崩溃或数据不一致。建议使用 try-except 或 try-catch 块来捕获异常，并使用日志系统记录详细的错误信息，以便于调试和排查问题。
API 文档： Upbit 官方提供了详细且全面的 API 文档，其中包含了所有可用 API 端点的说明、请求参数、响应格式、错误码以及使用示例。您可以通过查阅 Upbit 官方文档： https://docs.upbit.com/ 来获取最新的 API 信息和使用指南。在开发过程中，请务必仔细阅读 API 文档，以便正确地使用 API 并避免不必要的错误。文档中还包含了关于身份验证、签名、以及数据格式等重要信息，请务必仔细阅读。
风险提示： 使用 Upbit API 进行数字货币交易涉及固有风险，包括但不限于市场波动风险、流动性风险、交易对手风险、以及技术故障风险。请在充分了解相关风险的基础上，谨慎操作，并根据自身的风险承受能力制定合理的交易策略。切勿将全部资金投入数字货币交易，建议分散投资，并采取适当的风险管理措施，例如设置止损单和止盈单。同时，请密切关注市场动态，并及时调整您的交易策略。

四、常见问题及解决方案

API Key 权限不足： 当使用 Upbit API 时，API Key 权限不足是最常见的问题之一。请务必仔细检查您的 API Key 的权限设置，确保已授予其执行所需操作的所有必要权限。这包括但不限于交易权限（如买入和卖出订单的权限）、查询权限（如获取账户余额和市场数据的权限）以及提现权限（如果需要）。在 Upbit 平台上，您可以管理和修改 API Key 的权限。重新审视权限列表，并勾选所有必要选项。
身份验证失败： 身份验证失败通常意味着您的 API Key 或 Secret Key 不正确，或者您在请求头中提供的 Authorization 信息有误。请仔细核对您的 API Key 和 Secret Key，确保它们与 Upbit 平台上的信息完全一致。请检查您的请求头，确保 Authorization 字段已正确设置，通常包括将 API Key 和 Secret Key 进行适当的编码和签名处理。注意区分大小写，避免复制粘贴时的空格或其他不可见字符。如果您使用了任何 SDK 或库，请确保您正确地配置了身份验证参数。
请求频率超过限制： Upbit API 对请求频率有限制，以防止滥用并保证平台的稳定运行。如果您频繁收到与请求频率相关的错误，请尝试降低您的请求频率。考虑优化您的代码，减少不必要的请求，并使用缓存机制来存储先前获取的数据。另一种选择是使用 Upbit 提供的 WebSocket API，它允许您实时接收市场数据，而无需频繁地发送 HTTP 请求。通过 WebSocket，您可以更有效地获取所需的信息，并避免触发频率限制。
IP 地址不在白名单中： 为了增强安全性，Upbit 允许您将特定的 IP 地址添加到白名单中。如果您的 IP 地址不在白名单中，您将无法访问 API。请登录 Upbit 平台，找到 API 管理页面，并将您的 IP 地址添加到白名单中。请注意，您的 IP 地址可能会发生变化（例如，如果您使用的是动态 IP 地址），因此您可能需要定期更新白名单。某些情况下，如果您使用了代理服务器或 VPN，您需要将代理服务器或 VPN 的 IP 地址添加到白名单。
API 返回错误： 当 Upbit API 返回错误时，它通常会包含一个错误码和一条错误信息，用于说明错误的具体原因。请仔细查看 API 返回的错误码和错误信息，并根据这些信息进行相应的处理。Upbit 官方文档中详细列出了所有可能的错误码及其含义。通过查阅文档，您可以了解错误的根本原因，并采取适当的措施来解决问题。例如，如果错误码指示参数无效，您应该检查您的请求参数是否正确。如果错误码指示服务器内部错误，您可能需要稍后重试。

通过认真遵循以上步骤并理解常见问题及其解决方案，您就可以更顺利地申请并使用 Upbit API 接口，实现自动化交易和数据分析。请始终牢记安全第一的原则，并谨慎操作，确保您的账户和数据的安全。