Upbit历史数据：Python查询实战，避坑指南！| 掘金指南

如何查询Upbit历史数据

在加密货币交易的世界中，获取历史数据对于技术分析、回测交易策略以及进行更深入的市场研究至关重要。Upbit，作为韩国领先的加密货币交易所，提供了相对全面的历史数据。本文将详细介绍如何查询Upbit的历史数据，以便您更好地了解市场动态。

1. Upbit API 简介

Upbit 提供了一个功能全面的 API（应用程序编程接口），使开发者、算法交易者和研究人员能够以程序化的方式与 Upbit 交易所进行交互。通过 Upbit API，用户可以获取实时的市场数据，如最新的交易价格、交易量、订单簿信息等，还可以访问历史交易数据和 K 线图数据，进行深入的市场分析和策略回测。该 API 还允许用户执行交易操作，例如下单、取消订单、查询账户余额等，从而实现自动化交易策略。

尽管 Upbit 官方文档主要以韩语编写，这可能会给一些非韩语用户带来一定的挑战。然而，Upbit API 的结构设计相对清晰明了，接口定义规范，返回值格式统一。因此，即使不熟悉韩语，开发者仍然可以通过查阅示例代码、借助在线翻译工具、参考第三方开发者社区的资源等方式，有效地利用 Upbit API。在使用 Upbit API 之前，需要先在 Upbit 平台上注册账户，并申请 API 密钥（API Key）和密钥凭证（Secret Key），用于身份验证和授权。

Upbit API 提供了 RESTful API 和 WebSocket API 两种接入方式。RESTful API 适用于获取静态数据和执行少量交易操作，例如查询账户余额、下单等。WebSocket API 则适用于实时数据推送，例如实时行情更新、订单状态变化等。开发者可以根据自身的应用场景和需求，选择合适的 API 接入方式。

2. 获取API密钥 (Access Key 和 Secret Key)

在使用Upbit API进行自动化交易、数据分析或其他集成之前，必须先获取API密钥。API密钥是您访问Upbit平台的通行证，确保只有经过授权的应用程序才能访问您的账户和数据。获取密钥的第一步是注册一个Upbit账户，并完成所有必要的身份验证流程，以确保账户安全和符合监管要求。

• 登录Upbit账户。 打开Upbit官方网站，使用您的注册邮箱地址和密码登录。如果您尚未注册，请先完成注册流程，并按照平台提示完成身份验证，例如提交身份证明文件和进行人脸识别。
• 访问API密钥管理页面。 成功登录后，导航至您的账户设置或用户中心。通常可以在“我的页面”、“账户设置”或类似的选项中找到“API Keys”、“API 密钥管理”或类似的链接。具体位置可能因Upbit平台更新而略有不同，请仔细查找。
• 创建新的API密钥。 在API密钥管理页面，您会看到创建新API密钥的选项。点击该按钮后，系统会要求您为新密钥设置权限。务必仔细阅读权限设置说明，理解每种权限的含义和影响。Upbit API提供多种权限，例如读取市场数据、下单交易、查询账户余额等。为了安全起见， 强烈建议仅授予您需要的最低权限 。例如，如果您只需要查询历史交易数据，则只需授予读取市场数据的权限，而无需授予交易权限。过度授予权限会增加账户被盗用的风险。
• 保存Access Key和Secret Key。 创建API密钥后，系统会生成两个关键字符串：Access Key和Secret Key。 Access Key相当于您的用户名，用于标识您的身份；Secret Key相当于您的密码，用于验证您的身份 。这两个密钥将用于所有API请求的身份验证。 请务必妥善保管这两个密钥，不要以任何方式泄露给他人 。您可以将它们保存在安全的地方，例如加密的文本文件或密码管理器中。 强烈建议不要将密钥直接硬编码到您的应用程序中 ，而是使用环境变量或其他安全的方式进行存储和访问。如果您不小心泄露了密钥，请立即删除该密钥并创建一个新的密钥。

3. 使用API 查询历史K线数据

Upbit API 提供了查询历史 K 线数据的接口，允许开发者获取指定市场在特定时间范围内的开盘价、收盘价、最高价、最低价和交易量等信息。以下将详细介绍如何使用该接口获取 K 线数据，以及相关参数的含义和使用方法。

• API 端点： 获取 K 线数据的核心 API 端点是 /candles/{candle_type} 。 {candle_type} 是一个占位符，需要根据所需的 K 线类型进行替换。 支持的 K 线类型包括分钟 K 线、日 K 线、周 K 线和月 K 线。 具体如下：
  • minutes/{unit} ：分钟 K 线。 {unit} 表示分钟数，有效值包括 1, 3, 5, 15, 30, 60, 和 240。 例如， minutes/1 表示 1 分钟 K 线， minutes/5 表示 5 分钟 K 线，以此类推。选择合适的分钟单位对于进行短线交易分析至关重要。
  • days ：日 K 线。 日 K 线反映了每日的价格波动情况，是中长线分析的重要数据来源。 它提供了每日的开盘价、收盘价、最高价和最低价。
  • weeks ：周 K 线。 周 K 线聚合了一周的价格信息，可以用于分析中长期的市场趋势。 相比于日 K 线，周 K 线能够过滤掉一些短期波动，更清晰地展示市场的主要趋势。
  • months ：月 K 线。 月 K 线反映了整个月的价格变动，适用于长期投资和趋势分析。 它可以帮助投资者把握市场的长期走向。
• 参数：
  • market (required)： 市场代码，用于指定要查询的市场。 市场代码通常由两个部分组成，用短横线分隔。 例如， KRW-BTC 表示韩元 (KRW) 交易对的比特币 (BTC)， BTC-ETH 表示比特币 (BTC) 交易对的以太坊 (ETH)。 务必使用正确的市场代码，否则无法获取有效数据。
  • to (optional)： 返回数据的最后一个 K 线时间。 该参数允许你指定查询的时间范围。 格式为 YYYY-MM-DDTHH:mm:ssZ (UTC 时间) 或 YYYY-MM-DD HH:mm:ss (本地时间，需要与 Upbit 服务器时区一致)。 如果不指定此参数，API 将默认返回最新的 K 线数据。 例如，可以使用该参数获取某个特定时间点之前的历史数据。
  • count (optional)： 返回数据的数量。 指定要获取的 K 线数量，最大值为 200。 如果不指定此参数，API 将默认返回 200 个 K 线数据。 可以通过调整此参数来控制返回的数据量，以便进行不同时间跨度的分析。 请注意，返回的数据按照时间倒序排列，即最新的数据在前。
• 示例请求 (Python):

import requests

access key = "YOUR ACCESS KEY" # 替换为你的 Access Key secret key = "YOUR SECRET KEY" # 替换为你的 Secret Key

设置API请求头

headers = { "Accept": "application/", "Authorization": f"Bearer {accesskey}.{secretkey}" # Note: Authorization is not usually required for public API endpoints. # However, Upbit may require it for specific API usage or account limits. }

构建请求URL

构建请求URL是与Upbit API交互的第一步。以下是一个示例，展示如何获取5分钟K线数据：

url = "https://api.upbit.com/v1/candles/minutes/5"

此URL指定了要访问的Upbit API端点。其中：

• https://api.upbit.com 是Upbit API的基础URL。
• /v1/candles/minutes/5 指示我们请求的是分钟K线数据，时间周期为5分钟。

为了更精确地获取所需的数据，可以使用查询参数。例如：

params = { "market": "KRW-BTC", "count": 200 }

这些参数通过附加到URL来过滤结果：

• market : 指定交易市场。在此例中， KRW-BTC 代表韩元（KRW）与比特币（BTC）的交易对。
• count : 指定要返回的数据点的数量。此处设置为 200 ，意味着我们将获取最新的200个5分钟K线数据。 Upbit API对 count 参数通常有最大值限制，具体数值需要参考官方API文档。超过最大值，API可能会返回错误或只返回最大允许数量的数据。

完整的请求URL将由基础URL和查询参数组成。在实际代码中，你需要将这些参数添加到URL中，例如使用Python的 requests 库或其他HTTP客户端。

发送GET请求

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

检查响应状态码

if response.status_code == 200:

当HTTP响应状态码为200时，表示请求已成功完成。这通常意味着服务器已接收、理解并处理了客户端的请求，并已返回所需的数据。因此，程序可以继续解析服务器返回的JSON格式数据。

data = .loads(response.text)

.loads() 函数是Python标准库 模块中的一个关键函数，它负责将JSON格式的字符串转换为Python对象（通常是字典或列表）。 response.text 包含了从服务器接收到的原始JSON字符串。如果JSON格式不正确，将会引发 .JSONDecodeError 异常，需要进行适当的错误处理。 通过将JSON字符串解析为Python对象，我们可以方便地访问和操作其中的数据。

# 打印数据
for candle in data:
    print(f"时间: {candle['candle_date_time_kst']}, 开盘价: {candle['opening_price']}, 最高价: {candle['high_price']}, 最低价: {candle['low_price']}, 收盘价: {candle['trade_price']}, 成交量: {candle['candle_acc_trade_volume']}")

这段代码遍历解析后的JSON数据，通常是一个包含多个K线数据的列表。对于每一条K线数据（ candle ），它提取出以下关键信息：

• candle_date_time_kst ：K线的时间戳，通常是KST（韩国标准时间）。
• opening_price ：该K线的开盘价。
• high_price ：该K线的最高价。
• low_price ：该K线的最低价。
• trade_price ：该K线的收盘价。
• candle_acc_trade_volume ：该K线的成交量。

f-string （格式化字符串字面量）用于将这些数据格式化成易于阅读的字符串并打印到控制台。 通过分析这些数据，可以进行各种技术分析和交易决策。

else:

如果HTTP响应状态码不是200，则表示请求失败。 常见的错误状态码包括：

• 400：客户端错误，表示请求格式不正确或缺少必要的参数。
• 401：未授权，表示需要提供有效的身份验证信息。
• 403：禁止访问，表示服务器拒绝提供服务。
• 404：未找到，表示请求的资源不存在。
• 500：服务器内部错误，表示服务器在处理请求时发生错误。

print(f"请求失败: {response.status_code}, {response.text}")

打印出HTTP响应状态码和响应文本，有助于诊断请求失败的原因。 response.text 可能包含服务器返回的错误消息，提供有关错误的更多详细信息。 在实际应用中，应该根据不同的错误状态码采取不同的处理措施，例如重试请求、检查请求参数或联系API提供商。

• 请求解读： 上述代码使用Python的 requests 库向Upbit API发送GET请求。 access_key 和 secret_key 需要替换成您自己的API密钥。 url 定义了API端点，这里是请求5分钟K线的数据。 params 定义了请求参数， market 指定了交易对为 KRW-BTC （韩元-比特币）， count 指定了返回200条数据。 如果请求成功，会将返回的JSON数据解析并打印出每一条K线的开盘价、最高价、最低价、收盘价和成交量等信息。

4. 使用其他编程语言查询

除了Python，您还可以选择使用多种其他编程语言来查询Upbit的历史交易数据，例如JavaScript、Java、Go、C#等。核心在于选择一种您熟悉的编程语言，并掌握其对应的HTTP客户端库。这些库能够帮助您发送HTTP请求并接收Upbit API返回的JSON数据。在选择编程语言时，应考虑项目的具体需求、性能要求以及团队的技术栈。

选择合适的HTTP客户端库至关重要，它简化了与Upbit API的交互过程，让您能够专注于构建查询逻辑和数据处理流程。您需要仔细阅读Upbit API文档，了解API的请求格式、参数要求、速率限制以及返回数据的结构。不同编程语言提供了不同的HTTP客户端库，例如：

• JavaScript: 可以使用 axios 或原生 fetch API。 axios 是一个流行的、基于Promise的HTTP客户端，提供了简洁的API和强大的功能，例如自动转换JSON数据、拦截请求和响应等。 fetch 是现代浏览器提供的原生API，无需安装额外的依赖，但需要手动处理JSON数据的解析。
• Java: 可以使用 HttpClient （Apache HttpClient）或 OkHttp 。 HttpClient 是一个成熟的HTTP客户端库，提供了丰富的功能和灵活的配置选项。 OkHttp 是由Square公司开发的HTTP客户端，性能优异，易于使用，并且对HTTP/2和WebSocket提供了良好的支持。
• Go: 可以使用 net/http 包（Go标准库）或 resty 。 net/http 是Go语言的标准库，提供了基本的HTTP客户端功能。 resty 是一个简洁而强大的HTTP客户端，提供了链式调用、自动重试、JSON序列化/反序列化等功能。
• C#: 可以使用 HttpClient (.NET framework)

构建请求时，务必遵循Upbit API文档的要求，正确设置请求头、查询参数以及身份验证信息（例如API密钥）。同时，需要处理API返回的错误码和异常情况，确保程序的健壮性和可靠性。对返回的JSON数据进行解析和处理，提取所需的历史交易数据，并进行存储或进一步分析。

5. 处理 API 限制

Upbit API为了保障服务器的稳定性和公平性，通常会设置请求频率限制，也称为速率限制 (Rate Limiting)。这意味着在一定时间内，允许您的应用程序发送的请求数量是有限制的。如果您在短时间内发送过多的API请求，超过了Upbit设定的阈值，您的请求可能会被拒绝，并且您可能会收到错误代码，从而被暂时或永久地限制访问API。 为了避免这种情况发生，您需要合理地控制请求频率，优化您的代码逻辑，并实现健壮的错误处理机制。 良好的错误处理可以帮助您优雅地应对API限制，并避免应用程序崩溃。

当您收到错误代码 429 Too Many Requests 时，这明确表明您已超过了Upbit API的请求频率限制。解决此问题的关键是暂停发送请求一段时间，让您的请求频率降至允许的范围内，然后再尝试重新发送请求。 可以在代码中加入延时函数，以便在达到请求限制时暂停执行。 例如，在Python编程语言中，您可以使用 time.sleep() 函数来暂停程序的执行。您可以根据Upbit API的文档，或者通过实验来确定合适的暂停时间。 例如，您可以先暂停几秒钟，如果仍然收到 429 错误，则可以逐渐增加暂停时间。 除了使用 time.sleep() 函数之外，您还可以考虑使用更复杂的策略，例如指数退避算法，该算法会根据重试次数动态调整暂停时间。通过合理地处理API限制，您可以确保您的应用程序能够平稳地与Upbit API进行交互，并避免不必要的错误。

6. 数据格式说明

Upbit API 返回的 K 线数据采用 JSON (JavaScript Object Notation) 格式，这是一种轻量级的数据交换格式，易于解析和生成。每个 K 线数据对象包含以下关键字段，为交易者和分析师提供详细的市场信息：

• market : 市场代码，用于标识具体的交易对。例如，"KRW-BTC" 表示韩元 (KRW) 计价的比特币 (BTC) 市场。
• candle_date_time_utc : K 线日期时间 (UTC)，采用协调世界时标准，确保全球数据一致性。时间格式通常为 ISO 8601，如 "YYYY-MM-DDTHH:MM:SSZ"。
• candle_date_time_kst : K 线日期时间 (KST)，采用韩国标准时间，比 UTC 快 9 个小时。这对于关注韩国市场的用户尤为重要。
• opening_price : 开盘价，表示该时间段内第一笔交易的价格。
• high_price : 最高价，表示该时间段内达到的最高价格。
• low_price : 最低价，表示该时间段内达到的最低价格。
• trade_price : 收盘价，表示该时间段内最后一笔交易的价格。收盘价通常被视为该时间段内市场表现的重要指标。
• timestamp : 时间戳 (毫秒)，表示该 K 线数据生成的时间。时间戳是从 Unix 纪元 (1970 年 1 月 1 日 00:00:00 UTC) 开始的毫秒数。
• candle_acc_trade_price : 累积交易价格，表示该时间段内所有交易的总价值。这是衡量市场活跃度的重要指标，也称为成交额。
• candle_acc_trade_volume : 累积交易量，表示该时间段内交易的资产总量。与累积交易价格一样，是衡量市场活跃度的重要指标。
• unit (仅分钟 K 线): 分钟单位，表示该 K 线的时长。例如，"1" 表示 1 分钟 K 线，"5" 表示 5 分钟 K 线。此字段仅在请求分钟 K 线数据时才会返回。

7. 常见问题

• API密钥无效： 请仔细检查您的Access Key和Secret Key是否正确无误。密钥区分大小写，并且请确保没有包含任何空格或其他不可见字符。建议您从交易所或平台的用户界面复制粘贴密钥，以避免手动输入错误。如果您仍然遇到问题，尝试重新生成新的API密钥对，并替换旧的密钥。请确保您的API密钥处于激活状态，部分交易所可能需要手动激活密钥。
• 请求被拒绝： API密钥可能不具备执行该操作所需的权限。例如，尝试下单交易可能需要启用交易权限。请登录您的交易所账户，检查API密钥的权限设置，确保已授予所需的权限，例如读取市场数据、交易、提现等。如果您不确定哪些权限是必需的，请查阅交易所的API文档或联系其技术支持。同时，某些交易所可能对IP地址进行限制，请检查您的IP地址是否在允许的IP地址列表中。
• 返回数据为空： 检查您请求的 market 代码（交易对）是否正确有效。不同的交易所或平台可能使用不同的 market 代码命名规范。请仔细核对交易所的API文档，确认您使用的代码与交易所的定义相符。同时，检查 to 参数（时间戳或日期）是否在有效范围内。如果 to 参数设置不合理，例如设置在未来时间或超出数据历史范围，可能导致返回空数据。另外，如果该交易对在指定时间段内没有交易活动，也可能导致返回空数据。
• 频率限制： API接口通常有频率限制，以防止滥用和保障系统稳定。当您超过允许的请求频率时，API可能会返回错误代码（例如429 Too Many Requests）。减少请求频率是解决此问题的有效方法。例如，您可以增加请求之间的时间间隔，或者批量请求数据，减少总的请求次数。另一种方法是使用更长的时间间隔进行数据抓取。如果需要高频率的数据，您可以考虑使用交易所提供的WebSocket接口，该接口通常具有更高的频率限制。某些交易所还提供付费API服务，具有更高的频率限制和更好的性能。

8. 第三方工具

除了直接使用Upbit API之外，多种第三方工具和程序库也能辅助您更便捷地获取历史数据。这些工具通常构建在Upbit API之上，并提供更易于使用的接口和附加功能，简化了数据获取的流程。

例如，一些专业的数据分析平台专门为加密货币市场设计，内置了Upbit API的集成，并提供了可视化的数据分析工具和用户友好的界面。这些平台通常提供高级筛选、图表绘制和数据导出功能，方便您进行深入的数据挖掘和分析。量化交易平台也可能集成了Upbit API，让您可以直接在平台上获取历史数据，并用于回测您的交易策略。

在使用任何第三方工具之前，务必进行充分的调研，评估其安全性和可靠性。确认工具提供商的信誉良好，并仔细阅读其服务条款和隐私政策。审查工具的数据处理方式，确保您的API密钥和交易数据得到妥善保护。建议选择具有良好声誉、积极维护和安全保障的工具，避免使用来源不明或安全性未经验证的工具，防止API密钥泄露或数据安全风险。同时，关注Upbit官方对于第三方工具使用的相关规定和建议，确保您的使用行为符合Upbit的规范。

9. 注意事项

• 仔细阅读Upbit API文档： 务必透彻理解Upbit官方提供的API文档，重点关注每个接口的功能、输入参数、输出格式，以及错误代码的含义。 理解不同的端点（如市场数据、交易、账户信息等）及其 specific 的速率限制。 同时注意 API 文档的版本，确保使用最新的文档以避免出现兼容性问题。
• API 密钥安全： API 密钥如同您的账户密码，一旦泄露，可能导致资金损失或账户被盗用。 不要将 API 密钥存储在代码中，更不要上传到公共代码仓库（如 GitHub）。 推荐使用环境变量或专门的密钥管理工具进行存储。 定期轮换您的 API 密钥，降低泄露风险。 启用 API 密钥权限限制，只赋予必要的权限，例如只读权限用于获取历史数据。
• 频率限制管理： Upbit API 存在频率限制，过度频繁的请求会被限制访问。 合理设计您的程序，避免短时间内发送大量请求。 使用缓存机制，缓存已经获取的数据，减少重复请求。 实施重试机制，当请求被限制时，自动进行指数退避重试，避免程序崩溃。 监控您的 API 请求频率，及时调整程序，避免触发频率限制。
• 数据处理校验： API 返回的数据可能包含错误或异常情况，您的代码需要能够正确处理这些情况。 检查 API 返回的状态码，判断请求是否成功。 对返回的数据进行有效性验证，例如数据类型、数值范围等。 使用 try-except 语句捕获可能出现的异常，保证程序的健壮性。
• 关注官方公告： Upbit 会定期更新 API，包括增加新功能、修复 Bug、调整参数等。 及时关注 Upbit 官方公告，了解 API 的最新动态。 根据公告调整您的代码，确保其与 API 的兼容性。 参与 Upbit 开发者社区，与其他开发者交流经验，获取 API 使用技巧。
• 数据持久化策略： 考虑到数据量可能较大，需要选择合适的存储方式。 关系型数据库（如 MySQL、PostgreSQL）适合存储结构化数据，方便进行查询和分析。 NoSQL 数据库（如 MongoDB）适合存储非结构化数据，具有更高的灵活性。 文件存储（如 CSV、JSON）适合存储简单的数据，方便进行共享和导出。根据您的需求选择最合适的存储方式。
• 错误日志记录： 完善的错误日志记录对于问题排查至关重要。 记录 API 请求的 URL、参数、响应内容和状态码。 记录程序运行时的错误信息和异常堆栈。 使用日志分析工具，快速定位和解决问题。 定期分析错误日志，发现潜在的 Bug 和性能瓶颈。

获取Upbit的历史数据依赖于编程能力以及对Upbit API的深入理解。 通过细致的学习和实践，可以利用Upbit API有效地查询历史数据，支持量化交易策略和市场分析研究。