The base endpoint is: wss://ws-api.binance.com:443/ws-api/v3.
If you experience issues with the standard 443 port, alternative port 9443 is also available.
The base endpoint for testnet is: wss://ws-api.testnet.binance.vision/ws-api/v3
A single connection to the API is only valid for 24 hours; expect to be disconnected after the 24-hour mark.
Responses are in JSON by default. To receive responses in SBE, refer to the SBE FAQ page.
The WebSocket server will send a ping frame every 20 seconds.
If the WebSocket server does not receive a pong frame back from the connection within a minute the connection will be disconnected.
When you receive a ping, you must send a pong with a copy of ping's payload as soon as possible.
Unsolicited pong frames are allowed, but will not prevent disconnection. It is recommended that the payload for these pong frames are empty.
Lists are returned in chronological order, unless noted otherwise.
All timestamps in the JSON responses are in milliseconds in UTC by default. To receive the information in microseconds, please add the parameter timeUnit=MICROSECOND or timeUnit=microsecond in the URL.
Timestamp parameters (e.g. startTime, endTime, timestamp) can be passed in milliseconds or microseconds.
All field names and values are case-sensitive, unless noted otherwise.
If there are enums or terms you want clarification on, please see SPOT Glossary for more information.
APIs have a timeout of 10 seconds when processing a request. If a response from the Matching Engine takes longer than this, the API responds with "Timeout waiting for response from backend server. Send status unknown; execution status unknown." (-1007 TIMEOUT)
This does not always mean that the request failed in the Matching Engine.
If the status of the request has not appeared in User Data Stream, please perform an API query for its status.