Copy page

Listen Token User Data Stream

This is the recommended successor to the deprecated listen-key-based User Data Stream on wss://stream.binance.com:9443. It uses a short-lived listen token and a WebSocket API subscription method, and offers lower latency. See the Change Log for the deprecation announcement.

Connect

• The base REST endpoint is: https://api.binance.com
• POST /sapi/v1/userListenToken creates a new user data stream and returns a listenToken.
  • Request weight (UID): 1
  • expirationTime = current time + validity. Default and maximum validity are both 24 hours.
  • isIsolated (BOOLEAN): true means isolated margin (then symbol is required); default is cross margin.
  • To extend a subscription, call POST /sapi/v1/userListenToken again before the current subscription expires, obtain a new listenToken, then call userDataStream.subscribe.listenToken again with the new token. The subscription extends seamlessly to the new expirationTime.
• The base WebSocket API endpoint is: wss://ws-api.binance.com:443/ws-api/v3
  • testnet: wss://ws-api.testnet.binance.vision/ws-api/v3
• Subscribe via the WebSocket API method userDataStream.subscribe.listenToken with the param listenToken (string, required).
  • Request weight: 2
  • Non-authenticated sessions are allowed to use this feature.
  • An invalid listenToken returns error -1209.
• If a subscription is not extended before its token expires, it expires and an eventStreamTerminated event is sent. No further events will be pushed after that until a new token is created and a new subscription is opened.

---

HTTP Request — POST /sapi/v1/userListenToken

Request

Name	Type	Required	Description
symbol	STRING	CONDITIONAL	Trading pair symbol; required when isIsolated is true, e.g. BNBUSDT.
isIsolated	BOOLEAN	NO	Whether it is isolated margin; true means isolated; default is cross margin.
validity	LONG	NO	Validity in milliseconds; default 24 hours, maximum 24 hours.

Response Example

Code
{
  "token": "6xXxePXwZRjVSHKhzUCCGnmN3fkvMTXru+pYJS8RwijXk9Vcyr3rkwfVOTcP2OkONqciYA",
  "expirationTime": 1758792204196
}

---

WebSocket API Method — userDataStream.subscribe.listenToken

Subscribe to the user data stream using the listenToken obtained from POST /sapi/v1/userListenToken.

Request Example

Code
{
  "id": "f3a8f7a29f2e54df796db582f3d",
  "method": "userDataStream.subscribe.listenToken",
  "params": {
    "listenToken": "5DbylArkmImhyHkpG6s9tbiFy5uAMTFwzx9vwsFjDv9dC3GkKxSuoTCj0HvcJC0WYi8fA"
  }
}

Response Example

Code
{
  "id": "f3a8f7a29f2e54df796db582f3d",
  "status": 200,
  "result": {
    "subscriptionId": 0,
    "expirationTime": 1749094553955907
  }
}

---

Event: Event Stream Terminated

Description

This event is sent when the subscription expires because it was not extended before the listenToken's expirationTime. No more events will be sent after this until a new listenToken is created and a new subscription is opened.

Event Name

eventStreamTerminated

Payload

Code
{
  "subscriptionId": 0,
  "event": {
    "e": "eventStreamTerminated",
    "E": 1759089357377
  }
}