Response

Field Name
Simplified Format (format: SIMPLE)
Description
TypeValue
typetyTypeStringticker : Current market price
codecdMarket ID (ex. KRW-BTC)String
opening_priceopOpening priceDouble
high_pricehpHigh priceDouble
low_pricelpLow priceDouble
trade_pricetpClosing price (Current price)Double
prev_closing_pricepcpPrevious closing price(UTC+00:00)Double
changecChange price type compared to the previous day’s closing price.StringRISE

EVEN

FALL
change_pricecpUnsigned change price compared to the previous day’s closing price.Double
signed_change_pricescpSigned change price compared to the previous day’s closing price.Double
change_ratecrUnsigned change price rate compared to the previous day’s closing price.Double
signed_change_ratescrSigned change price rate compared to the previous day’s closing price.Double
trade_volumetvLast trade volumeDouble
acc_trade_volumeatvAccumulated trade price (from UTC+00:00)Double
acc_trade_volume_24hatv24h24 hrs accumulated price.Double
acc_trade_priceatpAccumulated trade volume (from UTC+00:00)Double
acc_trade_price_24hatp24h24 hrs accumulated trade volumeDouble
trade_datetdtTrade date (UTC)StringyyyyMMdd
trade_timettmTrade time (UTC)StringHHmmss
trade_timestampttmsTrade timestamp (milliseconds)Long
ask_bidabOrder typeStringASK

BID
acc_ask_volumeaavAccumulated ask volumeDouble
acc_bid_volumeabvAccumulated bid volumeDouble
highest_52_week_priceh52wp52 week high priceDouble
highest_52_week_dateh52wdtDate of 52 week high price
Format: yyyy-MM-dd
Stringyyyy-MM-dd
lowest_52_week_pricel52wp52-week low priceDouble
lowest_52_week_datel52wdtDate of 52-week low price
Format: yyyy-MM-dd
Stringyyyy-MM-dd
trade_statustsTrade status
*deprecated
String
market_statemsTrade statusStringPREVIEW : Deposit service
ACTIVE : Trading support available
DELISTED : Termination of trading support
market_state_for_iosmsfiTrade status
*deprecated
String
is_trading_suspendeditsWhether the transaction is suspendedBoolean
delisting_dateddDelisting dateDate
market_warningmwWhether the digital asset is marked as 'Investment Caution'

Returns whether or not 'Investment Warning (Yellow badge)' is designated, and 'Investment Caution (Orange badge)' designation is not supported yet. For more information about Upbit Market Alert, please refer to the relevant announcements.
StringNONE

CAUTION
timestamptmsTimestamp (millisecond)Long
stream_typestStream TypeStringSNAPSHOT

REALTIME

Example

Request

  • Current market price of KRW-BTC, KRW-ETH
[
  {
    "ticket": "test example"
  },
  {
    "type": "ticker",
    "codes": [
      "KRW-BTC",
      "KRW-ETH"
    ]
  },
  {
    "format": "DEFAULT"
  }
]

Response

{
  "type": "ticker",
  "code": "KRW-BTC",
  "opening_price": 31883000,
  "high_price": 32310000,
  "low_price": 31855000,
  "trade_price": 32287000,
  "prev_closing_price": 31883000.00000000,
  "acc_trade_price": 78039261076.51241000,
  "change": "RISE",
  "change_price": 404000.00000000,
  "signed_change_price": 404000.00000000,
  "change_rate": 0.0126713295,
  "signed_change_rate": 0.0126713295,
  "ask_bid": "ASK",
  "trade_volume": 0.03103806,
  "acc_trade_volume": 2429.58834336,
  "trade_date": "20230221",
  "trade_time": "074102",
  "trade_timestamp": 1676965262139,
  "acc_ask_volume": 1146.25573608,
  "acc_bid_volume": 1283.33260728,
  "highest_52_week_price": 57678000.00000000,
  "highest_52_week_date": "2022-03-28",
  "lowest_52_week_price": 20700000.00000000,
  "lowest_52_week_date": "2022-12-30",
  "market_state": "ACTIVE",
  "is_trading_suspended": false,
  "delisting_date": null,
  "market_warning": "NONE",
  "timestamp": 1676965262177,
  "acc_trade_price_24h": 228827082483.70729000,
  "acc_trade_volume_24h": 7158.80283560,
  "stream_type": "REALTIME"
}