Market

Endpoint

Download schema

Current average price

Get current average price for a symbol.

WSS

avgPrice

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

Current average price › 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 Weight2

Current average price › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

avgPrice

Example: avgPrice

object · required

Current average price › Responses

Successful Response

Current average price

id

string

Example: ddbfb65f-9ebf-42ec-8240-8f0f91de0867

status

integer · int64

Example: 200

object

object[]

Order book

Get current order book.

Note that this request returns limited market depth.

If you need to continuously monitor order book updates, please consider using WebSocket Streams:

<symbol>@depth<levels>
<symbol>@depth

You can use depth request together with <symbol>@depth streams to maintain a local order book.

WSS

depth

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

Order book › 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

Adjusted based on the limit:

Limit	Request Weight
1-100	5
101-500	25
501-1000	50
1001-5000	250

Order book › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

depth

Example: depth

object · required

Order book › Responses

Successful Response

Order book

id

string

Example: 51e2affb-0aba-4821-ba75-f2625006eb43

status

integer · int64

Example: 200

object

object[]

WSSdepth

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "depth",
  "params": {
    "symbol": "BNBUSDT"
  }
}

json

application/json

Example Responses

{
  "id": "51e2affb-0aba-4821-ba75-f2625006eb43",
  "status": 200,
  "result": {
    "lastUpdateId": 2731179239,
    "bids": [
      [
        "0.01379900",
        "3.43200000"
      ]
    ],
    "asks": [
      [
        "0.01380000",
        "5.91700000"
      ]
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Klines

Get klines (candlestick bars).

Klines are uniquely identified by their open & close time.

If you need access to real-time kline updates, please consider using WebSocket Streams:

<symbol>@kline_<interval>

If you need historical kline data, please consider using data.binance.vision.

WSS

klines

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

Klines › 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 Weight2

Klines › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

klines

Example: klines

object · required

Data Source: Database

Supported kline intervals (case-sensitive):

Interval	`interval` value
seconds	`1s`
minutes	`1m`, `3m`, `5m`, `15m`, `30m`
hours	`1h`, `2h`, `4h`, `6h`, `8h`, `12h`
days	`1d`, `3d`
weeks	`1w`
months	`1M`

Notes:

If startTime and endTime are not sent, the most recent klines are returned.
Supported values for timeZone:
- Hours and minutes (e.g. -1:00, 05:45)
- Only hours (e.g. 0, 8, 4)
- Accepted range is strictly [-12:00 to +14:00] inclusive
If timeZone provided, kline intervals are interpreted in that timezone instead of UTC.
Note that startTime and endTime are always interpreted in UTC, regardless of timeZone.

Klines › Responses

Successful Response

Klines

id

string

Example: 1dbbeb56-8eea-466a-8f6e-86bdcfa2fc0b

status

integer · int64

Example: 200

array[]

object[]

WSSklines

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "klines",
  "params": {
    "symbol": "BNBUSDT",
    "interval": "1s"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "klines",
  "params": {
    "symbol": "BNBUSDT",
    "interval": "1s"
  }
}

json

application/json

Example Responses

{
  "id": "1dbbeb56-8eea-466a-8f6e-86bdcfa2fc0b",
  "status": 200,
  "result": [
    [
      1499040000000,
      "0.01634790",
      "0.80000000",
      "0.01575800",
      "0.01577100",
      "148976.11427815",
      1499644799999,
      "2434.19055334",
      308,
      "1756.87402397",
      "28.46694368",
      "0"
    ]
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Rolling window price change statistics

Get rolling window price change statistics with a custom window.

This request is similar to ticker.24hr but statistics are computed on demand using the arbitrary window you specify.

Note: Window size precision is limited to 1 minute. While the closeTime is the current time of the request, openTime always start on a minute boundary. As such, the effective window might be up to 59999 ms wider than the requested windowSize.

Window computation example

For example, a request for "windowSize": "7d" might result in the following window:


Code
{
    "openTime": 1659580020000,
    "closeTime": 1660184865291
}

Time of the request – closeTime – is 1660184865291 (August 11, 2022 02:27:45.291). Requested window size should put the openTime 7 days before that – August 4, 02:27:45.291 – but due to limited precision it ends up a bit earlier: 1659580020000 (August 4, 2022 02:27:00), exactly at the start of a minute.

If you need to continuously monitor trading statistics, please consider using WebSocket Streams:

<symbol>@ticker_<window_size> or !ticker_<window-size>@arr

WSS

ticker

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

Rolling window price change statistics › 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

Adjusted based on the number of requested symbols:

Symbols	Weight
1–50	4 per symbol
51–100	200

Rolling window price change statistics › 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:

ticker

Example: ticker

object

Data Source: Database

Supported window sizes:

Unit	`windowSize` value
minutes	`1m`, `2m` ... `59m`
hours	`1h`, `2h` ... `23h`
days	`1d`, `2d` ... `7d`

Notes:

Either symbol or symbols must be specified.
Maximum number of symbols in one request: 200.
Window size units cannot be combined. E.g., 1d 2h is not supported.

Rolling window price change statistics › Responses

Successful Response

Rolling window price change statistics

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: bdb7c503-542c-495c-b797-4d2ee2e91173

status

integer · int64

Example: 200

object

object[]

WSSticker

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

Example Request

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

json

application/json

Example Responses

{
  "id": "bdb7c503-542c-495c-b797-4d2ee2e91173",
  "status": 200,
  "result": {
    "symbol": "BNBBTC",
    "priceChange": 0.000615,
    "priceChangePercent": 4.735,
    "weightedAvgPrice": 0.01368242,
    "openPrice": 0.012989,
    "highPrice": 0.014188,
    "lowPrice": 0.01296,
    "lastPrice": 0.013604,
    "volume": 587179.239,
    "quoteVolume": 8034.03382165,
    "openTime": 1659580020000,
    "closeTime": 1660184865291,
    "firstId": 192977765,
    "lastId": 195365758,
    "count": 2387994
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

24hr ticker price change statistics

Get 24-hour rolling window price change statistics.

If you need to continuously monitor trading statistics, please consider using WebSocket Streams:

<symbol>@ticker or !ticker@arr
<symbol>@miniTicker or !miniTicker@arr

If you need different window sizes,

use the ticker request.

WSS

ticker.24hr

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

24hr ticker price change statistics › 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

Adjusted based on the number of requested symbols:

Parameter	Symbols Provided	Weight
symbol	1	2
	omitted	80
symbols	1-20	2
	21-100	40
	101+	80
	omitted	80

24hr ticker price change statistics › 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:

ticker.24hr

Example: ticker.24hr

object

24hr ticker price change statistics › Responses

Successful Response

24hr ticker price change statistics

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9fa2a91b-3fca-4ed7-a9ad-58e3b67483de

status

integer · int64

Example: 200

object

object[]

WSSticker.24hr

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "ticker.24hr"
}

json

application/json

Example Responses

{
  "id": "9fa2a91b-3fca-4ed7-a9ad-58e3b67483de",
  "status": 200,
  "result": {
    "symbol": "BNBBTC",
    "priceChange": 0.000139,
    "priceChangePercent": 1.02,
    "weightedAvgPrice": 0.01382453,
    "prevClosePrice": 0.013628,
    "lastPrice": 0.013767,
    "lastQty": 1.788,
    "bidPrice": 0.013767,
    "bidQty": 4.646,
    "askPrice": 0.013768,
    "askQty": 14.314,
    "openPrice": 0.013628,
    "highPrice": 0.014149,
    "lowPrice": 0.013466,
    "volume": 69412.405,
    "quoteVolume": 959.59411487,
    "openTime": 1660014164909,
    "closeTime": 1660100564909,
    "firstId": 194696115,
    "lastId": 194968287,
    "count": 272173
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Symbol order book ticker

Get the current best price and quantity on the order book.

If you need access to real-time order book ticker updates, please consider using WebSocket Streams:

<symbol>@bookTicker

WSS

ticker.book

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

Symbol order book ticker › 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

Adjusted based on the number of requested symbols:

Parameter	Symbols Provided	Weight
symbol	1	2
	omitted	4
symbols	Any	4

Symbol order book ticker › 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:

ticker.book

Example: ticker.book

object

Symbol order book ticker › Responses

Successful Response

Symbol order book ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9d32157c-a556-4d27-9866-66760a174b57

status

integer · int64

Example: 200

object

object[]

Symbol price ticker

Get the latest market price for a symbol.

If you need access to real-time price updates, please consider using WebSocket Streams:

<symbol>@aggTrade
<symbol>@trade

WSS

ticker.price

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

Symbol price ticker › 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

Adjusted based on the number of requested symbols:

Parameter	Symbols Provided	Weight
symbol	1	2
	omitted	4
symbols	Any	4

Symbol price ticker › 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:

ticker.price

Example: ticker.price

object

Symbol price ticker › Responses

Successful Response

Symbol price ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 043a7cf2-bde3-4888-9604-c8ac41fcba4d

status

integer · int64

Example: 200

object

object[]

Trading Day Ticker

Price change statistics for a trading day.

WSS

ticker.tradingDay

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

Trading Day Ticker › 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

4 for each requested symbol regardless of windowSize. The weight for this request will cap at 200 once the number of symbols in the request is more than 50.

Trading Day Ticker › 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:

ticker.tradingDay

Example: ticker.tradingDay

object

Trading Day Ticker › Responses

Successful Response

Trading Day Ticker

id

string

Example: f4b3b507-c8f2-442a-81a6-b2f12daa030f

status

integer · int64

Example: 200

object[]

WSSticker.tradingDay

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

Example Request

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

json

application/json

Example Responses

{
  "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "priceChange": -83.13,
      "priceChangePercent": -0.317,
      "weightedAvgPrice": 26234.58803036,
      "openPrice": 26304.8,
      "highPrice": 26397.46,
      "lowPrice": 26088.34,
      "lastPrice": 26221.67,
      "volume": 18495.35066,
      "quoteVolume": 485217905.0421048,
      "openTime": 1695686400000,
      "closeTime": 1695772799999,
      "firstId": 3220151555,
      "lastId": 3220849281,
      "count": 697727
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Aggregate trades

Get aggregate trades.

An aggregate trade (aggtrade) represents one or more individual trades.

Trades that fill at the same time, from the same taker order, with the same price –

those trades are collected into an aggregate trade with total quantity of the individual trades.

If you need access to real-time trading activity, please consider using WebSocket Streams:

<symbol>@aggTrade

If you need historical aggregate trade data, please consider using data.binance.vision.

WSS

trades.aggregate

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

Aggregate trades › 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 Weight4

Aggregate trades › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

trades.aggregate

Example: trades.aggregate

object · required

Aggregate trades › Responses

Successful Response

Aggregate trades

id

string

Example: 189da436-d4bd-48ca-9f95-9f613d621717

status

integer · int64

Example: 200

object[]

WSStrades.aggregate

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "trades.aggregate",
  "params": {
    "symbol": "BNBUSDT"
  }
}

json

application/json

Example Responses

{
  "id": "189da436-d4bd-48ca-9f95-9f613d621717",
  "status": 200,
  "result": [
    {
      "a": 50000000,
      "p": 0.002741,
      "q": 57.19,
      "f": 59120167,
      "l": 59120170,
      "T": 1565877971222,
      "m": true,
      "M": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Historical trades

Get historical trades.

WSS

trades.historical

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

Historical trades › 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 Weight25

Historical trades › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

trades.historical

Example: trades.historical

object · required

Historical trades › Responses

Successful Response

Historical trades

id

string

Example: cffc9c7d-4efc-4ce0-b587-6b87448f052a

status

integer · int64

Example: 200

object[]

WSStrades.historical

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "trades.historical",
  "params": {
    "symbol": "BNBUSDT"
  }
}

json

application/json

Example Responses

{
  "id": "cffc9c7d-4efc-4ce0-b587-6b87448f052a",
  "status": 200,
  "result": [
    {
      "id": 0,
      "price": 0.00005,
      "qty": 40,
      "quoteQty": 0.002,
      "time": 1500004800376,
      "isBuyerMaker": true,
      "isBestMatch": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Historical Block Trades

Get block trades.

WSS

blockTrades.historical

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

Historical Block Trades › 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 Weight25

Historical Block Trades › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

blockTrades.historical

Example: blockTrades.historical

object · required

Historical Block Trades › Responses

Successful Response

Historical Block Trades

id

string

Example: cffc9c7d-4efc-4ce0-b587-6b87448f052a

status

integer

Example: 200

object[]

WSSblockTrades.historical

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "blockTrades.historical",
  "params": {
    "symbol": "BNBBTC",
    "fromId": 582
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "blockTrades.historical",
  "params": {
    "symbol": "BNBBTC",
    "fromId": 582
  }
}

json

application/json

Example Responses

{
  "id": "cffc9c7d-4efc-4ce0-b587-6b87448f052a",
  "status": 200,
  "result": [
    {
      "id": 582,
      "price": "0.052",
      "qty": "5838",
      "quoteQty": "303.576",
      "time": 1772506983321,
      "isBuyerMaker": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 10
    }
  ]
}

json

application/json

Recent trades

Get recent trades.

If you need access to real-time trading activity, please consider using WebSocket Streams:

<symbol>@trade

WSS

trades.recent

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

Recent trades › 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 Weight25

Recent trades › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

trades.recent

Example: trades.recent

object · required

Recent trades › Responses

Successful Response

Recent trades

id

string

Example: 409a20bd-253d-41db-a6dd-687862a5882f

status

integer · int64

Example: 200

object[]

WSStrades.recent

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "trades.recent",
  "params": {
    "symbol": "BNBUSDT"
  }
}

json

application/json

Example Responses

{
  "id": "409a20bd-253d-41db-a6dd-687862a5882f",
  "status": 200,
  "result": [
    {
      "id": 194686783,
      "price": 0.01361,
      "qty": 0.014,
      "quoteQty": 0.00019054,
      "time": 1660009530807,
      "isBuyerMaker": true,
      "isBestMatch": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

UI Klines

Get klines (candlestick bars) optimized for presentation.

This request is similar to klines, having the same parameters and response. uiKlines return modified kline data, optimized for presentation of candlestick charts.

WSS

uiKlines

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

UI Klines › 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 Weight2

UI Klines › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

uiKlines

Example: uiKlines

object · required

UI Klines › Responses

Successful Response

UI Klines

id

string

Example: b137468a-fb20-4c06-bd6b-625148eec958

status

integer · int64

Example: 200

array[]

object[]

WSSuiKlines

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "uiKlines",
  "params": {
    "symbol": "BNBUSDT",
    "interval": "1s"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "uiKlines",
  "params": {
    "symbol": "BNBUSDT",
    "interval": "1s"
  }
}

json

application/json

Example Responses

{
  "id": "b137468a-fb20-4c06-bd6b-625148eec958",
  "status": 200,
  "result": [
    [
      1499040000000,
      "0.01634790",
      "0.80000000",
      "0.01575800",
      "0.01577100",
      "148976.11427815",
      1499644799999,
      "2434.19055334",
      308,
      "1756.87402397",
      "28.46694368",
      "0"
    ]
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Reference Price

WSS

referencePrice

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

Query Reference Price › 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 Weight2

Query Reference Price › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

referencePrice

Example: referencePrice

object · required

Query Reference Price › Responses

Successful Response

Query Reference Price

id

string

Example: ddbfb65f-9ebf-42ec-8240-8f0f91de0867

status

integer · int64

Example: 200

object

object[]

WSSreferencePrice

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "referencePrice",
  "params": {
    "symbol": "BAZUSD"
  }
}

json

application/json

Example Responses

{
  "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
  "status": 200,
  "result": {
    "symbol": "BAZUSD",
    "referencePrice": "0.00501900",
    "timestamp": 1770946889251,
    "code": -2043,
    "msg": "This symbol doesn't have a reference price."
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Reference Price Calculation

WSS

referencePrice.calculation

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

Query Reference Price Calculation › 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 Weight2

Query Reference Price Calculation › Request Parameters

id

string · required

Client-generated request identifier.

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

method

string · enum · required

WebSocket API method name.

Enum values:

referencePrice.calculation

Example: referencePrice.calculation

object · required

Query Reference Price Calculation › Responses

Successful Response

Query Reference Price Calculation

id

string

Example: ddbfb65f-9ebf-42ec-8240-8f0f91de0867

status

integer · int64

Example: 200

object

object[]

WSSreferencePrice.calculation

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

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "referencePrice.calculation",
  "params": {
    "symbol": "BAZUSD"
  }
}

json

application/json

Example Responses

{
  "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
  "status": 200,
  "result": {
    "symbol": "BAZUSD",
    "calculationType": "ARITHMETIC_MEAN",
    "bucketCount": 10,
    "bucketWidthMs": 1000,
    "externalCalculationId": 42
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json