General

Endpoint

Download schema

Exchange information

Current exchange trading rules and symbol information

GET

/api/v3/exchangeInfo

https://api.binance.com

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 › Query Parameters

symbol

string

Example: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"

Example: ETHBTC

symbols

string[]

Examples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D" or curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'

Example: ["BTCUSDT","BNBBTC"]

permissions

string[]

Examples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT"

curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D" or curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'

Enum values:

SPOT

MARGIN

LEVERAGED

TRD_GRP_002

TRD_GRP_003

TRD_GRP_004

TRD_GRP_005

TRD_GRP_006

Example: ["SPOT"]

showPermissionSets

boolean

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

Example: false

Default: true

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. Cannot be used in combination with symbols or symbol.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Exchange information › Responses

200

Exchange information

timezone

string

Example: UTC

serverTime

integer · int64

Example: 1565246363776

object[]

array

object[]

Optional. Present only when SOR is available.

GET/api/v3/exchangeInfo

curl --request GET \
  --url https://api.binance.com/api/v3/exchangeInfo

Example Responses

{
  "timezone": "UTC",
  "serverTime": 1565246363776,
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "DAY",
      "intervalNum": 1,
      "limit": 160000
    },
    {
      "rateLimitType": "RAW_REQUESTS",
      "interval": "MINUTE",
      "intervalNum": 5,
      "limit": 61000
    }
  ],
  "exchangeFilters": [],
  "symbols": [
    {
      "symbol": "ETHBTC",
      "status": "TRADING",
      "baseAsset": "ETH",
      "baseAssetPrecision": 8,
      "quoteAsset": "BTC",
      "quotePrecision": 8,
      "quoteAssetPrecision": 8,
      "baseCommissionPrecision": 8,
      "quoteCommissionPrecision": 8,
      "orderTypes": [
        "LIMIT LIMIT_MAKER MARKET STOP_LOSS STOP_LOSS_LIMIT TAKE_PROFIT TAKE_PROFIT_LIMIT"
      ],
      "icebergAllowed": true,
      "ocoAllowed": true,
      "otoAllowed": true,
      "opoAllowed": true,
      "quoteOrderQtyMarketAllowed": true,
      "allowTrailingStop": false,
      "cancelReplaceAllowed": false,
      "amendAllowed": false,
      "pegInstructionsAllowed": true,
      "isSpotTradingAllowed": true,
      "isMarginTradingAllowed": true,
      "filters": [],
      "permissions": [],
      "permissionSets": [
        [
          "SPOT",
          "MARGIN"
        ]
      ],
      "defaultSelfTradePreventionMode": "NONE",
      "allowedSelfTradePreventionModes": [
        "NONE"
      ]
    }
  ]
}

json

application/json

Query Execution Rules

Query execution rules for symbols.

GET

/api/v3/executionRules

https://api.binance.com

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 › Query Parameters

symbol

string

Query for specified symbol.

Example: BAZUSD

symbols

string[]

Query for multiple symbols.

Example: ["BAZUSD","BNBUSDT"]

symbolStatus

string · enum

Query for all symbols with the specified status.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Query Execution Rules › Responses

200

Query execution rules

object[]

Test connectivity

Test connectivity to the Rest API.

GET

/api/v3/ping

https://api.binance.com

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 › Responses

200

No data returned

Check server time

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

GET

/api/v3/time

https://api.binance.com

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 › Responses

200

Check server time

serverTime

integer · int64

Example: 1499827319559

Exchange information

Current exchange trading rules and symbol information

GET

/api/v3/exchangeInfo

https://api.binance.com

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 › Query Parameters

symbol

string

Example: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"

Example: ETHBTC

symbols

string[]

Example: ["BTCUSDT","BNBBTC"]

permissions

string[]

Examples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT"

Enum values:

SPOT

MARGIN

LEVERAGED

TRD_GRP_002

TRD_GRP_003

TRD_GRP_004

TRD_GRP_005

TRD_GRP_006

Example: ["SPOT"]

showPermissionSets

boolean

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

Example: false

Default: true

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. Cannot be used in combination with symbols or symbol.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Exchange information › Responses

200

Exchange information

timezone

string

Example: UTC

serverTime

integer · int64

Example: 1565246363776

object[]

array

object[]

Optional. Present only when SOR is available.

Query Execution Rules

Query execution rules for symbols.

GET

/api/v3/executionRules

https://api.binance.com

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 › Query Parameters

symbol

string

Query for specified symbol.

Example: BAZUSD

symbols

string[]

Query for multiple symbols.

Example: ["BAZUSD","BNBUSDT"]

symbolStatus

string · enum

Query for all symbols with the specified status.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Query Execution Rules › Responses

200

Query execution rules

object[]

Test connectivity

Test connectivity to the Rest API.

GET

/api/v3/ping

https://api.binance.com

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 › Responses

200

No data returned

Check server time

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

GET

/api/v3/time

https://api.binance.com

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 › Responses

200

Check server time

serverTime

integer · int64

Example: 1499827319559