Tickers

WebSocket Endpoint

Type	Endpoint
Public	`wss://{region}-api.upbit.com/websocket/v1`

Use the endpoint for your region.

Region	Endpoint
Singapore	`wss://sg-api.upbit.com/websocket/v1`
Indonesia	`wss://id-api.upbit.com/websocket/v1`
Thailand	`wss://th-api.upbit.com/websocket/v1`

Request Message Format

To request announcement data, after establishing a WebSocket connection, create a JSON Object with the structure below and include it as a Data Type Object in the request message.

For the complete WebSocket request message specification, including the Ticket and Format Objects, refer to the WebSocket Usage and Error Guide.

Field Name	Type	Description	Required	Default
type	String	Data type to receive. Set to `ticker` to receive ticker data.	Required
codes	List:String	List of trading pairs to receive. Must be requested in uppercase.	Required
is_only_snapshot	Boolean	Provide snapshot data only	Optional	`false`
is_only_realtime	Boolean	Provide real-time data only	Optional	`false`
format	String	Data format to receive. `DEFAULT`: Default format. `SIMPLE`: Simplified format with abbreviated field names. `JSON_LIST`: List format. `SIMPLE_LIST`: List format with abbreviated field names.	Required

Subscription Data Specification

When a new announcement is published or an existing announcement is updated, real-time stream data is returned as follows.

Field Name	Abbreviation	Description	Type	Value Example
type	ty	Data Types	String	`ticker`
code	cd	Trading pair code	String	`SGD-BTC`
opening_price	op	Opening price	Double
high_price	hp	High price	Double
low_price	lp	Low price	Double
trade_price	tp	Current price	Double
prev_closing_price	pcp	Previous day closing price	Double
change	c	Price change direction compared to previous day closing	String	`RISE`: Rise `EVEN`: Even `FALL`: Fall
change_price	cp	Absolute price change compared to previous day	Double
signed_change_price	scp	Signed price change compared to previous day	Double
change_rate	cr	Absolute rate of change compared to previous day	Double
signed_change_rate	scr	Signed rate of change compared to previous day	Double
trade_volume	tv	Most recent trade volume	Double
acc_trade_volume	atv	Accumulated trade volume (from UTC 0)	Double
acc_trade_volume_24h	atv24h	Accumulated trade volume over last 24 hours	Double
acc_trade_price	atp	Accumulated trade value (from UTC 0)	Double
acc_trade_price_24h	atp24h	Accumulated trade value over last 24 hours	Double
trade_date	tdt	Latest trade date (UTC)	String	`yyyyMMdd`
trade_time	ttm	Latest trade time (UTC)	String	`HHmmss`
trade_timestamp	ttms	Trade timestamp (ms)	Long
ask_bid	ab	Buy/Sell distinction	String	`ASK`: Sell `BID`: Buy
acc_ask_volume	aav	Accumulated sell volume	Double
acc_bid_volume	abv	Accumulated buy volume	Double
highest_52_week_price	h52wp	52-week highest price	Double
highest_52_week_date	h52wdt	52-week highest price date	String	`yyyy-MM-dd`
lowest_52_week_price	l52wp	52-week lowest price	Double
lowest_52_week_date	l52wdt	52-week lowest price date	String	`yyyy-MM-dd`
market_state	ms	Trading status	String	`PREVIEW`: Deposit supported `ACTIVE`: Trading available `DELISTED`: Trading ended
is_trading_suspended	its	Trading suspension status (Deprecated - recommended to ignore)	Boolean
delisting_date	dd	Trading end date	Date
market_warning	mw	Market warning status (Deprecated - recommended to ignore)	String	`NONE`: None `CAUTION`: Investment caution
timestamp	tms	Timestamp (ms)	Long
stream_type	st	Stream type	String	`SNAPSHOT`: Snapshot `REALTIME`: Real-time

Examples

Subscription Request Example

[
  {
    "ticket": "0e66c0ac-7e13-43ef-91fb-2a87c2956c49"
  },
  {
    "type": "ticker",
    "codes": ["SGD-BTC","SGD-ETH"]
  },
  {
    "format": "DEFAULT"
  }
]

Subscription Data Example

{
  "type": "ticker",
  "code": "SGD-BTC",
  "opening_price": 37249,
  "high_price": 37645,
  "low_price": 36732,
  "trade_price": 36929,
  "prev_closing_price": 37235,
  "acc_trade_price": 5530.55648491,
  "change": "FALL",
  "change_price": 306,
  "signed_change_price": -306,
  "change_rate": 0.0082180744,
  "signed_change_rate": -0.0082180744,
  "ask_bid": "ASK",
  "trade_volume": 0.00006314,
  "acc_trade_volume": 0.149474,
  "trade_date": "20230830",
  "trade_time": "082105",
  "trade_timestamp": 1693383665811,
  "acc_ask_volume": 0.0197006,
  "acc_bid_volume": 0.1297734,
  "highest_52_week_price": 42710,
  "highest_52_week_date": "2023-07-06",
  "lowest_52_week_price": 21332,
  "lowest_52_week_date": "2022-11-21",
  "market_state": "ACTIVE",
  "is_trading_suspended": false,
  "delisting_date": null, // or "delisting_date" : {"year":2025,"month":10,"day":1}
  "market_warning": "NONE",
  "timestamp": 1693383690031,
  "acc_trade_price_24h": 8320.40577449,
  "acc_trade_volume_24h": 0.22569412,
  "stream_type": "SNAPSHOT"
}
...
{
  "type": "ticker",
  "code": "SGD-ETH",
  "opening_price": 2347,
  "high_price": 2349,
  "low_price": 2306,
  "trade_price": 2334,
  "prev_closing_price": 2347,
  "acc_trade_price": 1532.79257748,
  "change": "FALL",
  "change_price": 13,
  "signed_change_price": -13,
  "change_rate": 0.0055389859,
  "signed_change_rate": -0.0055389859,
  "ask_bid": "BID",
  "trade_volume": 0.00206817,
  "acc_trade_volume": 0.65951195,
  "trade_date": "20230830",
  "trade_time": "082206",
  "trade_timestamp": 1693383726250,
  "acc_ask_volume": 0.34334474,
  "acc_bid_volume": 0.31616721,
  "highest_52_week_price": 2856,
  "highest_52_week_date": "2023-04-16",
  "lowest_52_week_price": 1479.5,
  "lowest_52_week_date": "2022-11-22",
  "market_state": "ACTIVE",
  "is_trading_suspended": false,
  "delisting_date": null, // or "delisting_date" : {"year":2025,"month":10,"day":1}
  "market_warning": "NONE",
  "timestamp": 1693383750023,
  "acc_trade_price_24h": 4342.50350959,
  "acc_trade_volume_24h": 1.88473642,
  "stream_type": "REALTIME"
}

Error Information

If an error occurs after establishing a WebSocket connection and sending a request, the response is returned in the following JSON format.

{
  "error": {
    "name": "ERROR_CODE",
    "message": "ERROR_MESSAGE"
  }
}

The main error codes that may be returned are listed below.

`error.name`	Reason	Recommended Action
`INVALID_AUTH`	Missing authentication information or authentication token verification failure	When using a Private WebSocket endpoint, make sure you are connected to the correct endpoint and that the `Authorization` header contains a valid authentication token.
`WRONG_FORMAT`	Invalid request message format	Make sure the request message follows the WebSocket request format. Check the Object structure as well as the type and value of each field.
`NO_TICKET`	Missing `ticket` field	Make sure the request message includes a Ticket Object and the `ticket` field.
`NO_TYPE`	Missing `type` field	Make sure the Data Type Object includes the `type` field and specify the data type to subscribe to.
`NO_CODES`	Missing `codes` field	Check whether the subscribed data type requires the `codes` field and specify the trading pair codes to receive.
`INVALID_PARAM`	Missing required request field or unsupported value	Make sure all required fields are included and that each field contains a supported value.
`Too Many Requests`	Request rate limit exceeded	Wait until another request can be made, then retry. Refer to the Rate Limits section for details.
`I'm a teapot`	Requests are temporarily restricted due to repeated `Too Many Requests` errors	Check the restriction period included in the response and retry after the specified time has passed.

Rate Limits

APIs are grouped into Rate Limit groups. APIs within the same group share the same per-second request limit.

The maximum number of requests allowed per Rate Limit group may change after prior notice according to service policy, and additional restrictions may be applied depending on service conditions. For details, refer to Rate Limits.

Rate Limit Group	Policy	Applied By
`websocket-connect`	Up to 5 connections per second	IP
`websocket-message`	Up to 5 messages per second and 100 messages per minute	Connection

Managing WebSocket Rate Limits
Unlike REST API responses, WebSocket does not provide the number of remaining requests. Clients should track the number of WebSocket connection attempts and data request messages they send to ensure compliance with the applicable rate limits. If a rate limit is reached, wait for an appropriate period before sending another request..