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

symbol

string

Describe a single symbol

Example: BNBUSDT

symbols

string[]

Describe multiple symbols

permissions

string[]

Filter symbols by permissions

showPermissionSets

boolean

Controls whether the content of the permissionSets field is populated or not. Defaults to true.

Example: true

Default: true

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. Valid values: TRADING, HALT, BREAK. Cannot be used in combination with symbol or symbols.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Exchange information › Responses

Successful Response

Exchange information

id

string

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

status

integer · int64

Example: 200

object

timezone

string

Example: UTC

serverTime

integer · int64

Example: 1655969291181

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="EXCHANGE_MAX_NUM_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ALGO_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ORDER_LISTS"

Properties for EXCHANGE_MAX_NUM_ORDERS:

filterType

string

Example: EXCHANGE_MAX_NUM_ORDERS

maxNumOrders

integer · int64

Example: 1000

object[]

symbol

string

Example: BNBBTC

status

string

Example: TRADING

baseAsset

string

Example: BNB

baseAssetPrecision

integer · int64

Example: 8

quoteAsset

string

Example: BTC

quotePrecision

integer · int64

Example: 8

quoteAssetPrecision

integer · int64

Example: 8

baseCommissionPrecision

integer · int64

Example: 8

quoteCommissionPrecision

integer · int64

Example: 8

orderTypes

string[]

icebergAllowed

boolean

Example: true

ocoAllowed

boolean

Example: true

otoAllowed

boolean

Example: true

opoAllowed

boolean

Example: true

quoteOrderQtyMarketAllowed

boolean

Example: true

allowTrailingStop

boolean

Example: true

cancelReplaceAllowed

boolean

Example: true

amendAllowed

boolean

Example: false

pegInstructionsAllowed

boolean

Example: true

isSpotTradingAllowed

boolean

Example: true

isMarginTradingAllowed

boolean

Example: true

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="PRICE_FILTER"
	type = object · filterType="PERCENT_PRICE"
	type = object · filterType="PERCENT_PRICE_BY_SIDE"
	type = object · filterType="LOT_SIZE"
	type = object · filterType="MIN_NOTIONAL"
	type = object · filterType="NOTIONAL"
	type = object · filterType="ICEBERG_PARTS"
	type = object · filterType="MARKET_LOT_SIZE"
	type = object · filterType="MAX_NUM_ORDERS"
	type = object · filterType="MAX_NUM_ALGO_ORDERS"
	type = object · filterType="MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="MAX_POSITION"
	type = object · filterType="TRAILING_DELTA"
	type = object · filterType="T_PLUS_SELL"
	type = object · filterType="MAX_NUM_ORDER_LISTS"
	type = object · filterType="MAX_NUM_ORDER_AMENDS"

Properties for PRICE_FILTER:

filterType

string

Example: PRICE_FILTER

priceExponent

integer

Example: 8

minPrice

string

Example: 0.00000100

maxPrice

string

Example: 100000.00000000

tickSize

string

Example: 0.00000100

permissions

string[]

permissionSets

array[]

defaultSelfTradePreventionMode

string

Example: NONE

allowedSelfTradePreventionModes

string[]

object[]

baseAsset

string

Example: BTC

symbols

string[]

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

symbol

string

Query for specified symbol.

Example: BAZUSD

symbols

string[]

Query for multiple symbols.

symbolStatus

string · enum

Query for all symbols with the specified status. Supported values: TRADING, HALT, BREAK

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Query Execution Rules › Responses

Successful Response

Query Execution Rules

id

string

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

status

integer · int64

Example: 200

object

object[]

symbol

string

Example: BAZUSD

object[]

ruleType

string

Example: PRICE_RANGE

bidLimitMultUp

string

Example: 1.0001

bidLimitMultDown

string

Example: 0.9999

askLimitMultUp

string

Example: 1.0001

askLimitMultDown

string

Example: 0.9999

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[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

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

serverTime

integer · int64

Example: 1656400526260

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

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

symbol

string

Describe a single symbol

Example: BNBUSDT

symbols

string[]

Describe multiple symbols

permissions

string[]

Filter symbols by permissions

showPermissionSets

boolean

Controls whether the content of the permissionSets field is populated or not. Defaults to true.

Example: true

Default: true

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. Valid values: TRADING, HALT, BREAK. Cannot be used in combination with symbol or symbols.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Exchange information › Responses

Successful Response

Exchange information

id

string

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

status

integer · int64

Example: 200

object

timezone

string

Example: UTC

serverTime

integer · int64

Example: 1655969291181

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="EXCHANGE_MAX_NUM_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ALGO_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ORDER_LISTS"

Properties for EXCHANGE_MAX_NUM_ORDERS:

filterType

string

Example: EXCHANGE_MAX_NUM_ORDERS

maxNumOrders

integer · int64

Example: 1000

object[]

symbol

string

Example: BNBBTC

status

string

Example: TRADING

baseAsset

string

Example: BNB

baseAssetPrecision

integer · int64

Example: 8

quoteAsset

string

Example: BTC

quotePrecision

integer · int64

Example: 8

quoteAssetPrecision

integer · int64

Example: 8

baseCommissionPrecision

integer · int64

Example: 8

quoteCommissionPrecision

integer · int64

Example: 8

orderTypes

string[]

icebergAllowed

boolean

Example: true

ocoAllowed

boolean

Example: true

otoAllowed

boolean

Example: true

opoAllowed

boolean

Example: true

quoteOrderQtyMarketAllowed

boolean

Example: true

allowTrailingStop

boolean

Example: true

cancelReplaceAllowed

boolean

Example: true

amendAllowed

boolean

Example: false

pegInstructionsAllowed

boolean

Example: true

isSpotTradingAllowed

boolean

Example: true

isMarginTradingAllowed

boolean

Example: true

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="PRICE_FILTER"
	type = object · filterType="PERCENT_PRICE"
	type = object · filterType="PERCENT_PRICE_BY_SIDE"
	type = object · filterType="LOT_SIZE"
	type = object · filterType="MIN_NOTIONAL"
	type = object · filterType="NOTIONAL"
	type = object · filterType="ICEBERG_PARTS"
	type = object · filterType="MARKET_LOT_SIZE"
	type = object · filterType="MAX_NUM_ORDERS"
	type = object · filterType="MAX_NUM_ALGO_ORDERS"
	type = object · filterType="MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="MAX_POSITION"
	type = object · filterType="TRAILING_DELTA"
	type = object · filterType="T_PLUS_SELL"
	type = object · filterType="MAX_NUM_ORDER_LISTS"
	type = object · filterType="MAX_NUM_ORDER_AMENDS"

Properties for PRICE_FILTER:

filterType

string

Example: PRICE_FILTER

priceExponent

integer

Example: 8

minPrice

string

Example: 0.00000100

maxPrice

string

Example: 100000.00000000

tickSize

string

Example: 0.00000100

permissions

string[]

permissionSets

array[]

defaultSelfTradePreventionMode

string

Example: NONE

allowedSelfTradePreventionModes

string[]

object[]

baseAsset

string

Example: BTC

symbols

string[]

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

symbol

string

Query for specified symbol.

Example: BAZUSD

symbols

string[]

Query for multiple symbols.

symbolStatus

string · enum

Query for all symbols with the specified status. Supported values: TRADING, HALT, BREAK

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Query Execution Rules › Responses

Successful Response

Query Execution Rules

id

string

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

status

integer · int64

Example: 200

object

object[]

symbol

string

Example: BAZUSD

object[]

ruleType

string

Example: PRICE_RANGE

bidLimitMultUp

string

Example: 1.0001

bidLimitMultDown

string

Example: 0.9999

askLimitMultUp

string

Example: 1.0001

askLimitMultDown

string

Example: 0.9999

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[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

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

serverTime

integer · int64

Example: 1656400526260

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321