Dear developers, this is Upbit Developer Center team.

Upbit is introducing the Announcement WebSocket data type, enabling you to receive Upbit(Singapore, Indonesia, Thailand) announcements in real time through WebSocket.

You can use this feature to conveniently receive information about newly published announcements and updates to existing announcements in your API-integrated environment.

1. Schedule

• Release Date: September 3, 2026 (THU)
• Supported Countries : Singapore, Indonesia, Thailand

2. New Feature

• Feature: Announcement WebSocket
• Endpoint:
  • Singapore: wss://sg-api.upbit.com/websocket/v1/private
  • Indonesia: wss://id-api.upbit.com/websocket/v1/private
  • Thailand: wss://th-api.upbit.com/websocket/v1/private
• Data Type: announcement
• Supported Events:
  • CREATED: A new announcement is published
  • UPDATED: An existing announcement is updated
• Use categories to subscribe only to announcements in selected categories.
• Set include_body=true to receive the announcement body in the body field.
• Announcement data supports real-time streams only, and stream_type is provided as REALTIME.
• Announcements are provided in the default language of each region.

3. How to Use

• Connect to the Private WebSocket endpoint for your region and complete authentication.
• Set type to announcement in the Data Type Object to subscribe to announcement data.
• Specify categories and include_body as needed.
• For detailed request and response specifications, refer to the documentation below.
  • Announcement
  • WebSocket Usage and Error Guide

4. Important Notes

• Data is transmitted only when a new announcement is published or an existing announcement is updated. It is normal to receive no data while no applicable event occurs.
• The timing at which announcements are received through WebSocket may differ from when they are displayed on other channels, such as the web or app. Delivery timing may vary depending on channel-specific delivery paths, system processing status, and measures taken to protect system stability.
• Even if data is successfully transmitted from the server, network conditions or the user's environment may prevent it from being received properly.
• Supported categories values may vary by region. If a request includes a category that is not supported in the connected region, an INVALID_PARAM error is returned.
• If an announcement is not available in the default language of the region, a predefined message is returned in the title and body fields. Empty data or content in another language is not returned.

If you have any inquiries, please contact us at [email protected].

We will respond as soon as possible.

Thank you.

Upbit Developer Center