Market

24hr Ticker Price Change Statistics

24 hour rolling window price change statistics. Careful when accessing this with no symbol.

  • If the symbol is not sent, tickers for all symbols will be returned in an array.

Weight(IP):

  • 2 for a single symbol;
  • 80 when the symbol parameter is omitted;
get/api/v3/ticker/24hr

Query parameters

symbolstring
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

symbolsstring
Example:["BTCUSDT","BNBBTC"]
type'FULL' | 'MINI'
Example:FULL

Supported values: FULL or MINI. If none provided, the default is FULL

Response

24hr ticker

OR

Example response

{
  "symbol": "BNBBTC",
  "priceChange": "0.17160000",
  "priceChangePercent": "1.060",
  "prevClosePrice": "16.35920000",
  "lastPrice": "27.84000000",
  "bidPrice": "16.34488284",
  "bidQty": "16.34488284",
  "askPrice": "16.35920000",
  "askQty": "25.06000000",
  "openPrice": "16.18760000",
  "highPrice": "16.55000000",
  "lowPrice": "16.16940000",
  "volume": "1678279.95000000",
  "quoteVolume": "27431289.14792300",
  "openTime": 1592808788637,
  "closeTime": 1592895188637,
  "firstId": 62683296,
  "lastId": 62739253,
  "count": 55958
}

Changes

Changed in 4 of the 26 revisions of this API.144

    • the query request parameter type was restricted to a list of enum values

      request-parameter-became-enum

    • added the new enum value FULL to the query request parameter type

      request-parameter-enum-value-added

    • added the new enum value MINI to the query request parameter type

      request-parameter-enum-value-added

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

    • added the new optional query request parameter type

      new-optional-request-parameter

    • added the new optional query request parameter symbols

      new-optional-request-parameter

    • the response property code became required for the status 400

      response-property-became-required

    • the response property msg became required for the status 400

      response-property-became-required

    • the response property oneOf[tickerList]/items/askPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/askQty became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/bidPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/bidQty became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/closeTime became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/count became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/firstId became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/highPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/lastId became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/lastPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/lowPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/openPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/openTime became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/prevClosePrice became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/priceChange became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/priceChangePercent became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/quoteVolume became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/symbol became required for the status 200

      response-property-became-required

    • the response property oneOf[tickerList]/items/volume became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/askPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/askQty became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/bidPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/bidQty became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/closeTime became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/count became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/firstId became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/highPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/lastId became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/lastPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/lowPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/openPrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/openTime became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/prevClosePrice became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/priceChange became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/priceChangePercent became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/quoteVolume became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/symbol became required for the status 200

      response-property-became-required

    • the response property oneOf[ticker]/volume became required for the status 200

      response-property-became-required