General

Endpoint

Download schema

Exchange information

Query current exchange trading rules, rate limits, and symbol information.

WSS

exchangeInfo

wss://ws-api.binance.com:443/ws-api/v3

Exchange information › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Exchange information › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

exchangeInfo

Example: exchangeInfo

object

Exchange information › Responses

Successful Response

Exchange information

id

string

Example: 5494febb-d167-46a2-996d-70533eb4d976

status

integer · int64

Example: 200

object

WSSexchangeInfo

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "exchangeInfo"
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "exchangeInfo"
}

json

application/json

Example Responses

{
  "id": "5494febb-d167-46a2-996d-70533eb4d976",
  "status": 200,
  "result": {
    "timezone": "UTC",
    "serverTime": 1655969291181,
    "rateLimits": [
      {
        "rateLimitType": "REQUEST_WEIGHT",
        "interval": "MINUTE",
        "intervalNum": 1,
        "limit": 6000,
        "count": 321
      }
    ],
    "exchangeFilters": [
      {
        "filterType": "EXCHANGE_MAX_NUM_ORDERS",
        "maxNumOrders": 1000
      }
    ],
    "symbols": [
      {
        "symbol": "BNBBTC",
        "status": "TRADING",
        "baseAsset": "BNB",
        "baseAssetPrecision": 8,
        "quoteAsset": "BTC",
        "quotePrecision": 8,
        "quoteAssetPrecision": 8,
        "baseCommissionPrecision": 8,
        "quoteCommissionPrecision": 8,
        "orderTypes": [
          "LIMIT"
        ],
        "icebergAllowed": true,
        "ocoAllowed": true,
        "otoAllowed": true,
        "opoAllowed": true,
        "quoteOrderQtyMarketAllowed": true,
        "allowTrailingStop": true,
        "cancelReplaceAllowed": true,
        "amendAllowed": false,
        "pegInstructionsAllowed": true,
        "isSpotTradingAllowed": true,
        "isMarginTradingAllowed": true,
        "filters": [
          {
            "filterType": "PRICE_FILTER",
            "priceExponent": 8,
            "minPrice": "0.00000100",
            "maxPrice": "100000.00000000",
            "tickSize": "0.00000100"
          }
        ],
        "permissions": [
          "SPOT"
        ],
        "permissionSets": [
          [
            "SPOT"
          ]
        ],
        "defaultSelfTradePreventionMode": "NONE",
        "allowedSelfTradePreventionModes": [
          "NONE"
        ]
      }
    ],
    "sors": [
      {
        "baseAsset": "BTC",
        "symbols": [
          "BTCUSDT"
        ]
      }
    ]
  }
}

json

application/json

Query Execution Rules

Query execution rules for symbols.

WSS

executionRules

wss://ws-api.binance.com:443/ws-api/v3

Query Execution Rules › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Parameter	Weight
`symbol`	2
`symbols`	2 for each `symbol`, capped at a max of 40
`symbolStatus`	40
None	40

Query Execution Rules › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

executionRules

Example: executionRules

object

Query Execution Rules › Responses

Successful Response

Query Execution Rules

id

string

Example: 5162affb-0aba-4821-b475-f2625006eb43

status

integer · int64

Example: 200

object

Test connectivity

Test connectivity to the WebSocket API.

Note: You can use regular WebSocket ping frames to test connectivity as well, WebSocket API will respond with pong frames as soon as possible. ping request along with time is a safe way to test request-response handling in your application.

WSS

ping

wss://ws-api.binance.com:443/ws-api/v3

Test connectivity › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Test connectivity › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

ping

Example: ping

params

object

Test connectivity › Responses

Successful Response

Test connectivity

id

string

Example: 922bcc6e-9de8-440d-9e84-7c80933a8d0d

status

integer · int64

Example: 200

result

object

object[]

Check server time

Test connectivity to the WebSocket API and get the current server time.

WSS

time

wss://ws-api.binance.com:443/ws-api/v3

Check server time › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Check server time › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

time

Example: time

params

object

Check server time › Responses

Successful Response

Check server time

id

string

Example: 187d3cb2-942d-484c-8271-4e2141bbadb1

status

integer · int64

Example: 200

object

object[]

Exchange information

Query current exchange trading rules, rate limits, and symbol information.

WSS

exchangeInfo

wss://ws-api.binance.com:443/ws-api/v3

Exchange information › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Exchange information › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

exchangeInfo

Example: exchangeInfo

object

Exchange information › Responses

Successful Response

Exchange information

id

string

Example: 5494febb-d167-46a2-996d-70533eb4d976

status

integer · int64

Example: 200

object

Query Execution Rules

Query execution rules for symbols.

WSS

executionRules

wss://ws-api.binance.com:443/ws-api/v3

Query Execution Rules › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Parameter	Weight
`symbol`	2
`symbols`	2 for each `symbol`, capped at a max of 40
`symbolStatus`	40
None	40

Query Execution Rules › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

executionRules

Example: executionRules

object

Query Execution Rules › Responses

Successful Response

Query Execution Rules

id

string

Example: 5162affb-0aba-4821-b475-f2625006eb43

status

integer · int64

Example: 200

object

Test connectivity

Test connectivity to the WebSocket API.

WSS

ping

wss://ws-api.binance.com:443/ws-api/v3

Test connectivity › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Test connectivity › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

ping

Example: ping

params

object

Test connectivity › Responses

Successful Response

Test connectivity

id

string

Example: 922bcc6e-9de8-440d-9e84-7c80933a8d0d

status

integer · int64

Example: 200

result

object

object[]

Check server time

Test connectivity to the WebSocket API and get the current server time.

WSS

time

wss://ws-api.binance.com:443/ws-api/v3

Check server time › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Check server time › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

time

Example: time

params

object

Check server time › Responses

Successful Response

Check server time

id

string

Example: 187d3cb2-942d-484c-8271-4e2141bbadb1

status

integer · int64

Example: 200

object

object[]