Sign in
Market

Exchange Information

Current exchange trading rules and symbol information

  • If any symbol provided in either symbol or symbols do not exist, the endpoint will throw an error.
  • All parameters are optional.
  • permissions can support single or multiple values (e.g. SPOT, ["MARGIN","LEVERAGED"])
  • If permissions parameter not provided, the default values will be ["SPOT","MARGIN","LEVERAGED"].
    • To display all permissions you need to specify them explicitly. (e.g. SPOT, MARGIN,...)

Examples of Symbol Permissions Interpretation from the Response:

  • [["A","B"]] means you may place an order if your account has either permission "A" or permission "B".
  • [["A"],["B"]] means you can place an order if your account has permission "A" and permission "B".
  • [["A"],["B","C"]] means you can place an order if your account has permission "A" and permission "B" or permission "C". (Inclusive or is applied here, not exclusive or, so your account may have both permission "B" and permission "C".)

Weight(IP): 10

get/api/v3/exchangeInfo

Query parameters

symbolstring
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

symbolsstring
Example:["BTCUSDT","BNBBTC"]
permissionsstring
Example:'SPOT' or ['MARGIN','LEVERAGED']

Response

Current exchange trading rules and symbol information

timezonestring required
serverTimeinteger required
exchangeFiltersobject[] required

Example response

{
  "timezone": "UTC",
  "serverTime": 1592882214236,
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 1200
    }
  ],
  "symbols": [
    {
      "symbol": "ETHBTC",
      "status": "TRADING",
      "baseAsset": "ETH",
      "baseAssetPrecision": 8,
      "quoteAsset": "BTC",
      "quoteAssetPrecision": 8,
      "baseCommissionPrecision": 8,
      "quoteCommissionPrecision": 8,
      "orderTypes": [
        "LIMIT"
      ],
      "icebergAllowed": true,
      "ocoAllowed": true,
      "quoteOrderQtyMarketAllowed": true,
      "cancelReplaceAllowed": true,
      "isSpotTradingAllowed": true,
      "isMarginTradingAllowed": true,
      "filters": [
        {
          "filterType": "PRICE_FILTER",
          "minPrice": "0.00000100",
          "maxPrice": "100000.00000000",
          "tickSize": "0.00000100"
        }
      ],
      "permissions": [
        "SPOT"
      ],
      "defaultSelfTradePreventionMode": "NONE",
      "allowedSelfTradePreventionModes": [
        "NONE"
      ]
    }
  ]
}

Changes

Changed in 5 of the 26 revisions of this API.139

  • 6c02ecd56d373See the full diff
    • ○

      added the required property symbols/items/cancelReplaceAllowed to the response with the 200 status

      response-required-property-added

    • ○

      added the required property symbols/items/otoAllowed to the response with the 200 status

      response-required-property-added

    • ○

      added the required property symbols/items/permissionSets to the response with the 200 status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 042dad2ebffe2See the full diff
    • ○

      added the required property symbols/items/allowedSelfTradePreventionModes to the response with the 200 status

      response-required-property-added

    • ○

      added the required property symbols/items/defaultSelfTradePreventionMode to the response with the 200 status

      response-required-property-added

  • 9d597b7942a91See the full diff
    • ○

      added the new optional query request parameter permissions

      new-optional-request-parameter

  • f1d8926e955a12See the full diff
    • ●

      deleted the query request parameter arraySymbols

      request-parameter-removed

    • ○

      added the new optional query request parameter symbols

      new-optional-request-parameter

    • ○

      added the required property symbols/items/allowTrailingStop to the response with the 200 status

      response-required-property-added

  • a484ce871a7231See the full diff
    • ○

      the response property code became required for the status 400

      response-property-became-required

    • ○

      the response property exchangeFilters became required for the status 200

      response-property-became-required

    • ○

      the response property msg became required for the status 400

      response-property-became-required

    • ○

      the response property rateLimits became required for the status 200

      response-property-became-required

    • ○

      the response property rateLimits/items/interval became required for the status 200

      response-property-became-required

    • ○

      the response property rateLimits/items/intervalNum became required for the status 200

      response-property-became-required

    • ○

      the response property rateLimits/items/limit became required for the status 200

      response-property-became-required

    • ○

      the response property rateLimits/items/rateLimitType became required for the status 200

      response-property-became-required

    • ○

      the response property serverTime became required for the status 200

      response-property-became-required

    • ○

      the response property symbols became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/baseAsset became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/baseAssetPrecision became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/baseCommissionPrecision became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/filters became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/filters/items/filterType became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/filters/items/maxPrice became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/filters/items/minPrice became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/filters/items/tickSize became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/icebergAllowed became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/isMarginTradingAllowed became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/isSpotTradingAllowed became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/ocoAllowed became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/orderTypes became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/permissions became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/quoteAsset became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/quoteAssetPrecision became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/quoteCommissionPrecision became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/quoteOrderQtyMarketAllowed became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/status became required for the status 200

      response-property-became-required

    • ○

      the response property symbols/items/symbol became required for the status 200

      response-property-became-required

    • ○

      the response property timezone became required for the status 200

      response-property-became-required