Upbit API 交易指南：从零开始
准备工作
你需要一个经过实名认证的 Upbit 账户。 确保你的账户已经完成了所有必要的身份验证流程，这通常包括上传身份证明文件（例如身份证、护照）并完成人脸识别等步骤。 只有完成实名认证，你才能获取并使用Upbit的API服务。这是因为KYC（了解你的客户）和AML（反洗钱）法规的要求。同时，为了保障资金安全，强烈建议开启双重验证（2FA）。 2FA可以有效防止账户被盗，即使你的密码泄露，攻击者也无法轻易访问你的账户。Upbit 支持多种 2FA 方式，例如 Google Authenticator 或者短信验证。
有了账户之后，登录 Upbit 网页版，找到“开放 API” 或者类似的入口，通常可以在账户设置或者安全设置中找到。 点击进入 API 管理页面。这个入口的名称可能因 Upbit 网站的更新而略有变化，但通常会在个人资料、账户安全、或者开发者选项等区域。仔细查找带有"API"、"开发者"、"Key"等关键词的链接。在API管理页面，你可以创建、管理和删除你的API密钥。
创建 API 密钥
为了安全地访问和使用我们的加密货币交易平台或数据服务，您需要创建一个 API 密钥。API 密钥允许您的应用程序或脚本在无需直接暴露您的账户凭据的情况下，与我们的服务器进行交互。
在您的账户控制面板或专门的 API 管理页面，通常会提供创建 API 密钥的选项。这个页面可能是"API 设置"、"开发者中心"或类似的名称。请仔细查找相关链接或选项。
点击“API 키 발급”（API 密钥颁发）按钮，或者相应的“创建 API 密钥”、“生成密钥”等按钮，开始创建新的 API 密钥。在点击后，系统可能会要求您确认身份或提供额外的安全验证。
接下来，您可能需要为您的 API 密钥设置权限。例如，您可以指定该密钥只能用于读取市场数据，或者可以用于执行交易。为了安全起见，请仅授予您的 API 密钥所需的最小权限集。避免授予不必要的权限，以降低潜在的安全风险。
在成功创建 API 密钥后，系统会显示您的 API 密钥和 API 密钥密钥。API 密钥（通常称为 API Key）是公开的，可以嵌入到您的应用程序或脚本中。API 密钥密钥（通常称为 API Secret Key）是私密的，必须妥善保管。切勿将 API 密钥密钥暴露给他人，也不要将其存储在不安全的地方。如果您的 API 密钥密钥泄露，请立即撤销该密钥并创建一个新的密钥。
创建 API 密钥后，请务必记录下 API 密钥和 API 密钥密钥，并将它们存储在一个安全的地方。您可以使用密码管理器或其他安全工具来保护这些信息。同时，请定期审查您的 API 密钥，并撤销不再使用的密钥，以确保您的账户安全。
重要提示： Upbit 在 API 密钥申请过程中会要求你提供 API 使用目的的详细说明。 务必以清晰、专业的语言进行描述，例如“用于程序化交易系统的开发与回测”、“自动化交易策略的实时监控与执行”、“量化投资组合的风险评估与管理”等。 明确且具体的用途说明能够显著提高你的 API 密钥审核通过率。 请避免使用含糊不清的表述，并尽可能提供技术细节，例如所使用的编程语言和框架。
接下来，你需要精确地设置 API 权限，这对于保障账户安全至关重要。 Upbit 提供了细 granular 的权限控制选项，涵盖了“行情数据查询（包括实时价格、历史数据、交易量等）”、“交易下单（包括市价单、限价单、止损单等）”、“账户资金查询（仅限于查询，不包括提取）”、“订单状态查询与管理”等。 务必遵循最小权限原则，只授予你的应用程序实际需要的权限，避免过度授权带来的安全风险。 例如，如果你的应用仅仅需要获取 Upbit 的行情数据用于分析，那么只需勾选“行情查询”权限即可，不需要勾选任何与交易相关的权限。 如果你需要通过 API 进行交易操作，则必须勾选“交易下单”权限，并根据实际需要选择相应的订单类型权限。 务必牢记：在任何情况下都不要授予“资金提取”权限，除非你对你的交易程序经过了严格的安全审计，并且完全理解并接受潜在的资金安全风险。 即使你确实需要自动提现功能，也应当通过其他更为安全的机制实现，例如设置提现白名单，或者使用多重签名技术。
完成权限设置后，仔细阅读 Upbit 提供的 API 使用条款及风险提示，确保你充分理解 API 使用的限制和责任。 勾选同意这些条款，表明你承诺遵守 Upbit 的 API 使用规范。 然后，点击“확인”（确认）按钮，提交你的 API 密钥申请。
系统成功处理申请后，会即时生成一个 API 密钥（Access Key）和一个 Secret 密钥（Secret Key）。 务必采取最严格的安全措施来妥善保管你的 Secret Key，切勿以任何形式泄露给任何第三方。 Secret Key 相当于你的账户交易密码，拥有 Secret Key 的人可以模拟你的身份进行交易操作，一旦泄露将可能直接导致严重的资金损失。 通常情况下，API Key 和 Secret Key 只会显示一次，请立即使用安全的复制粘贴方式，将其保存到经过加密保护的安全存储介质中，例如使用密码管理器、硬件钱包，或者专门的密钥管理系统。 如果你不慎遗失了 Secret Key，唯一的补救措施是立即删除当前的 API Key，然后重新创建一个新的 API Key。 此操作会使旧的 API Key 失效，防止被他人滥用。 定期轮换 API Key 也是一种良好的安全实践，可以进一步降低安全风险。
环境配置
API 密钥创建完成后，为了能够顺利地与Upbit API进行交互，你需要配置合适的开发环境。具体配置方案取决于你选择的编程语言，常见的编程语言包括Python、Java、Node.js等。每种语言都有其对应的HTTP请求库和可选的Upbit API封装库。
以Python为例，你可以选择使用通用的
requests
库来构造HTTP请求，或者使用专门为Upbit API设计的第三方库，例如
pyupbit
。
pyupbit
库简化了API调用过程，提供了更方便的函数接口来处理交易、查询市场数据等操作。
你需要通过pip安装必要的Python库。
requests
库用于发送HTTP请求，而
pyupbit
库则是对Upbit API的封装：
pip install requests pyupbit
安装完成后，在你的Python代码中，导入相应的库（主要是
pyupbit
），并使用你的Access Key和Secret Key进行初始化。请务必安全地存储和管理你的API密钥。
import pyupbit
access_key = "YOUR_ACCESS_KEY" # 替换为你的真实API Access Key
secret_key = "YOUR_SECRET_KEY" # 替换为你的真实API Secret Key
upbit = pyupbit.Upbit(access_key, secret_key)
在上述代码中，
YOUR_ACCESS_KEY
和
YOUR_SECRET_KEY
需要替换为你从Upbit交易所获得的真实API密钥。 初始化
pyupbit.Upbit
对象后，你就可以使用该对象的方法来调用Upbit API，例如获取账户余额、下单交易等。 请注意，API密钥的安全性至关重要，不要将其泄露给他人或者提交到公共代码仓库中。 推荐使用环境变量或者专门的密钥管理工具来安全地存储API密钥。 如果你使用的是其他编程语言，你需要查找对应的HTTP请求库和Upbit API封装库，并按照相应的文档进行配置。
API 调用示例
现在，让我们深入了解如何通过 Upbit API 获取实际数据。我们将演示如何获取当前市场价格以及历史K线数据，这将帮助你构建自己的交易策略和分析工具。
获取特定交易对的当前市场价格是常见的需求。以下代码展示了如何获取比特币（BTC）在韩元（KRW）市场（KRW-BTC）的最新成交价格。
ticker = "KRW-BTC" # 指定交易对：比特币（BTC）在韩元（KRW）市场
price = pyupbit.get_current_price(ticker)
print(f"当前 {ticker} 的价格为：{price}")
这段代码简洁明了。
ticker
变量定义了要查询的交易对，
pyupbit.get_current_price(ticker)
函数则负责从 Upbit API 获取该交易对的最新价格。获取的价格将以浮点数形式存储在
price
变量中，并通过
print()
函数输出。
除了获取当前价格，获取历史数据对于技术分析至关重要。下面的代码演示了如何获取指定交易对的历史K线数据，并允许你自定义时间范围和K线周期。
import datetime
ticker = "KRW-BTC"
to_date = datetime.datetime.now()
count = 200 # 获取最近 200 条数据
interval = "minute1" # 获取 1 分钟 K 线数据
在获取历史数据前，我们需要导入
datetime
模块来处理时间相关的操作。
ticker
变量同样指定了交易对。
to_date
变量表示数据的截止日期，这里设置为当前时间。
count
变量指定了要获取的数据条数，
interval
变量定义了K线周期，例如 "minute1" 表示 1 分钟K线。
df = pyupbit.get_ohlcv(ticker, to=to_date, count=count, interval=interval)
print(df)
pyupbit.get_ohlcv()
函数负责从 Upbit API 获取历史K线数据。该函数返回一个 Pandas DataFrame 对象，其中包含开盘价（Open）、最高价（High）、最低价（Low）、收盘价（Close）和成交量（Volume）等信息。通过
print(df)
可以将这些数据打印出来，方便查看和分析。
可以通过调整
interval
参数来获取不同周期的K线数据，例如 "minute5" 表示 5 分钟K线，"day" 表示日K线，"week" 表示周K线，"month" 表示月K线。请注意，Upbit API 对于请求频率有限制，需要合理设置
count
参数，避免过于频繁地请求数据。
交易下单
在获得Upbit交易权限后，您可以通过API进行下单操作。Upbit API支持丰富的订单类型，以满足不同的交易策略，其中包括：市价单（Market Order）、限价单（Limit Order）和止损单（Stop Order）。
市价单允许您以当前市场最优价格立即成交，而限价单则允许您设定一个期望的价格，只有当市场价格达到或优于该价格时，订单才会被执行。止损单则是一种风险管理工具，它会在市场价格达到预设的止损价时自动触发，帮助您限制潜在的损失。
以下代码示例展示了如何使用Upbit API提交一个市价买单，以购买一定数量的比特币。本例使用Python语言和Upbit官方提供的SDK（假设已安装并配置），您可以根据自己的编程语言和环境选择合适的SDK或直接调用API接口。
ticker = "KRW-BTC"
这段代码定义了交易对的标识符（ticker）。"KRW-BTC"表示韩元（KRW）对比特币（BTC）的交易对，您需要根据实际交易的币对修改此值。
volume = 0.001
此变量指定了您希望购买的比特币数量。在这个例子中，我们计划购买0.001个比特币。请注意，Upbit对最小交易数量有限制，您需要根据实际情况调整此值。
try:
order = upbit.buy_market_order(ticker, volume)
print(f"市价买入 {ticker}，数量：{volume}，订单信息：{order}")
except Exception as e:
print(f"下单失败：{e}")
上述代码片段尝试使用
upbit.buy_market_order()
函数提交市价买单。如果下单成功，将会打印出订单的详细信息，包括订单ID、交易价格、成交数量等。如果下单过程中出现任何错误（例如，API密钥无效、账户余额不足、交易对不存在等），将会捕获异常并打印错误信息，帮助您诊断问题。请务必仔细阅读Upbit API文档，了解各种错误代码的含义。
在实际应用中，请务必妥善保管您的API密钥，避免泄露。同时，建议您在进行真实交易前，先使用测试环境进行模拟交易，以确保您的交易策略和代码能够正常工作。加密货币市场波动剧烈，请务必进行充分的风险评估，谨慎投资。
注意： 在进行真实交易之前，务必使用模拟账户进行充分的测试，以确保你的交易程序能够正常运行。 Upbit 并没有提供官方的模拟交易环境，但是你可以使用少量的资金进行实盘测试。常见问题与注意事项
- API 密钥安全： 务必将您的 Upbit API 密钥 (API Key) 和私密密钥 (Secret Key) 安全地存储，切勿以任何形式泄露给未经授权的第三方。密钥泄露可能导致您的账户资金被盗或遭受其他恶意攻击。强烈建议启用双因素认证 (2FA) 等额外的安全措施，以增强账户的安全性。定期更换您的 API 密钥也是一项有效的安全策略。
- 权限控制： Upbit API 提供多种权限选项，在使用 API 密钥时，应仅授予应用程序或脚本执行所需的最少权限集。避免授予过多的权限，以降低潜在的安全风险。例如，如果您的应用程序只需要读取市场数据，则不要授予交易权限。精细化的权限控制是保障账户安全的关键。
- 频率限制： Upbit API 对请求频率有限制，旨在维护平台的稳定性和公平性。开发者应严格遵守频率限制，避免在短时间内发送大量请求。如果超过频率限制，您的 API 密钥可能会被暂时禁用，影响您的应用程序或脚本的正常运行。建议在程序中实施速率限制机制 (Rate Limiting)，以控制 API 请求的发送频率。Upbit官方文档详细描述了各种接口的频率限制，请务必参考。
- 错误处理： 在使用 Upbit API 进行开发时，必须实现完善的错误处理机制。API 调用可能会因为网络问题、服务器错误、参数错误等原因而失败。通过捕获和处理这些错误，您可以及时发现并解决问题，避免程序崩溃或产生意外后果。详细的错误日志记录对于问题排查至关重要。同时，要仔细阅读 Upbit API 文档，了解各种错误代码的含义和相应的处理方法。
- 资金安全： 在将 Upbit API 应用于真实交易之前，强烈建议使用 Upbit 提供的模拟交易环境（如果可用）或者使用少量资金进行充分的测试。模拟交易允许您在不承担实际财务风险的情况下验证您的交易策略和代码的正确性。通过充分的测试，您可以发现潜在的错误和漏洞，并确保您的交易系统能够安全可靠地运行。切勿未经充分测试就将 API 用于大额资金的交易。
进阶技巧
- 使用 WebSockets 实时获取数据： Upbit 提供了强大的 WebSockets API 接口，允许开发者以极低的延迟接收实时市场数据更新，如最新成交价格（Last Traded Price, LTP）、成交量、订单簿变动等。相比于传统的 REST API 轮询方式，WebSockets 采用持久连接，数据推送模式，能显著降低延迟，对于高频交易和算法交易至关重要。 使用 WebSockets 可以显著提高交易速度，确保及时响应市场变化。你需要订阅特定的频道来接收所需数据，并处理接收到的 JSON 数据。
- 开发交易策略回测系统： 利用历史数据回测交易策略，是量化交易开发过程中不可或缺的一环。这涉及收集Upbit API提供的历史K线数据、交易数据等，构建一个模拟交易环境。通过模拟不同市场条件下策略的表现，可以评估策略的潜在盈利能力、风险承受能力，并优化策略参数。回测系统应考虑到手续费、滑点等实际交易成本，以提高评估的准确性。 常用的回测工具包括 Python 编程语言及相关库 (如 Pandas, NumPy, Backtrader)，以及专业的量化交易平台提供的回测功能。
- 集成第三方交易平台： Upbit API 可以无缝集成到各种第三方交易平台或量化交易系统中，扩展交易功能和自动化程度。通过API，可以实现自动下单、止盈止损、仓位管理等功能。在集成过程中，需要关注API的认证授权机制，确保交易安全。还需要处理API的速率限制，避免因频繁请求被限制访问。 考虑使用成熟的 API 客户端库来简化集成过程。
掌握这些进阶技巧并不断学习和实践，将能够更有效地利用 Upbit API，构建更高效、更智能的交易策略，在加密货币市场中取得更好的成绩。