Update to Binance USDⓈ-M Futures WebSocket System Upgrade Notice (2026-03-06), Base URL Split & Migration

[thkdog]

As Binance USDⓈ-M Futures WebSocket System Upgrade Notice (2026-03-06) memtioned, the old stream api will be invalid at 2026-04-23, plz update ASAP, thanks!

[JJ-Cro]

Thanks for mentioning, we noticed it already and should be done this week, thanks!

[tiagosiebler]

Hi @thkdog - thanks for raising this issue. I've just released v3.5.0, which introduces support for the new Base URLs for USDM futures WebSockets. No breaking changes expected, but they may be some action required depending on how you use WebSockets with our SDK. More details, including examples, in the release notes.

• Pull request: feat(v3.5.0, #653): add support for Binance USDM Futures base URL split & migration #654
• Release notes: https://siebly.io/releases?sdk=binance

If you have any other questions or issues, let us know!

[tiagosiebler]

For anyone wondering, legacy WebSocket URLs will be permanently retired on 2026-04-23!

[tiagosiebler]

Keeping this issue open for visibility.

[LeThanh-dev]

Keeping this issue open for visibility.

Today, when I use wsOrder.subscribeUsdFuturesUserDataStream("usdm", true), I no longer receive the returned position socket. Which one should I use now, bro? Thanks

[tiagosiebler]

@LeThanh-dev this is the correct way to do it:
https://github.com/tiagosiebler/binance/blob/master/examples/WebSockets/Private(userdata)/ws-userdata-listenkey.ts#L173-L174

no need for any parameters

[LeThanh-dev]

@LeThanh-dev this is the correct way to do it: https://github.com/tiagosiebler/binance/blob/master/examples/WebSockets/Private(userdata)/ws-userdata-listenkey.ts#L173-L174

no need for any parameters

So it's the same function, just without passing parameters? Why then does it not work correctly when I pass parameters? I tried changing usdm to usdmPrivate and it worked fine.

[LeThanh-dev]

@LeThanh-dev this is the correct way to do it: https://github.com/tiagosiebler/binance/blob/master/examples/WebSockets/Private(userdata)/ws-userdata-listenkey.ts#L173-L174

no need for any parameters

hey bro? why ?

[JJ-Cro]

Hey, function is called subscribeUsdFuturesUserDataStream, which by default(as the name says) connects to using the user data stream. If you use "usdm" it will use public url which wont work. With "usdmPrivate" is same as it is without params.