Upbit 价格查询

概述

查询韩国最大加密货币交易所 Upbit 的实时加密货币价格。提供基于韩元（KRW）的定价，包含24小时统计数据、交易量以及52周最高/最低价。

快速开始

使用 Upbit 的公共 API 获取行情数据：

bash
curl -s https://api.upbit.com/v1/ticker?markets=KRW-BTC

将 KRW-BTC 替换为所需的市场代码（例如：KRW-ETH、KRW-SUI、KRW-DOGE）。

市场代码格式

Upbit 使用 KRW-{SYMBOL} 格式：

• - 比特币：KRW-BTC
• 以太坊：KRW-ETH
• Sui：KRW-SUI
• 狗狗币：KRW-DOGE

重要提示： 始终使用大写字母表示交易对符号。

响应格式

API 返回包含以下关键字段的 JSON 数据：

json
{
market: KRW-BTC,
trade_price: 145000000.0,
opening_price: 144000000.0,
high_price: 146000000.0,
low_price: 143000000.0,
prevclosingprice: 144000000.0,
change: RISE,
change_price: 1000000.0,
change_rate: 0.00694444,
signedchangeprice: 1000000.0,
signedchangerate: 0.00694444,
acctradevolume_24h: 123.456,
acctradeprice_24h: 17890000000.0,
highest52week_price: 150000000.0,
highest52week_date: 2025-12-01,
lowest52week_price: 100000000.0,
lowest52week_date: 2025-02-01,
tradedatekst: 20260209,
tradetimekst: 074511
}

关键字段

• - tradeprice：当前价格（韩元）
• change：价格方向（RISE 上涨、FALL 下跌、EVEN 持平）
• changeprice：与前收盘价的绝对变化值（韩元）
• changerate：百分比变化（0.00694444 = 0.69%）
• signedchangeprice：带符号的价格变化（下跌时为负值）
• signedchangerate：带符号的百分比变化
• acctradevolume24h：24小时交易量（币数）
• acctradeprice24h：24小时交易额（韩元）
• highest52weekprice / lowest52weekprice：52周价格区间
• tradedatekst / tradetime_kst：最后交易时间戳（韩国时间）

格式化输出

以可读格式呈现价格，包含：

1. 1. 当前价格 及涨跌指示符（▲/▼）
2. 与前收盘价的百分比变化
3. 当日区间（最高/最低）
4. 24小时交易量（币数和韩元）
5. 52周区间 作为参考背景

输出示例：

BTC/KRW（截至 2026-02-09 07:45:11）

• - 当前价格： 145,000,000韩元
• 较前收盘价： +1,000,000韩元（+0.69%）▲
• 开盘价： 144,000,000韩元
• 最高价： 146,000,000韩元
• 最低价： 143,000,000韩元
• 24小时交易量： 123.46 BTC
• 24小时交易额： 约178亿韩元

52周记录

• - 最高：150,000,000韩元（2025-12-01）
• 最低：100,000,000韩元（2025-02-01）

多个市场

一次性查询多个市场：

bash
curl -s https://api.upbit.com/v1/ticker?markets=KRW-BTC,KRW-ETH,KRW-SUI

返回一个行情对象数组。

错误处理

如果市场代码无效或未在 Upbit 上市，API 将返回空数组 []。在这种情况下，请告知用户该币种在 Upbit 上不可用，或验证市场代码。