Skip to main content

Binance.US will retire the listenKey mechanism for User Data Stream subscriptions

This article will be updated when the final sunset date is confirmed.

As part of our ongoing efforts to improve the Binance.US API, the listenKey mechanism for subscribing to the User Data Stream is being deprecated and is targeted for retirement in Q4 2026.

The final sunset date will be confirmed and announced in advance. Until then, listenKey continues to work as it does today.

Important: We recommend bookmarking this article, which will be updated when the final sunset date for listenKey is announced.

What’s changing

The following will be retired on the sunset date (final date to be determined):

  • POST, PUT and DELETE /api/v3/userDataStream

  • WebSocket API requests userDataStream.start, userDataStream.ping and userDataStream.stop

  • listenKey connections to wss://stream.binance.us:9443

How to prepare for the changes

To prepare for the sunset, please subscribe to the User Data Stream directly on your WebSocket API connection using the userDataStream.subscribe.signature request.

  • You can authenticate with your existing API key, and account events arrive on the same connection you use for trading. There is no token to obtain or manage.

  • Please note that events received through the WebSocket API subscription are wrapped in an object containing subscriptionId and event, where event is the payload you receive today. To prepare for the API changes, you will need to update your event parsing accordingly.

For more information, visit the Binance.US API Documentation Portal under WebSocket API > User Data Stream requests.

If you have any questions about the transition, please reach out to Binance.US Support.

Did this answer your question?