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

symbol

string · required

Example: BNBUSDT

Current average price › Responses

Successful Response

Current average price

id

string

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

status

integer · int64

Example: 200

object

mins

integer · int64

Average price interval (in minutes)

Example: 5

price

string

Average price

Example: 0.01378135

closeTime

integer · int64

Last trade time

Example: 1694061154503

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

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

symbol

string · required

Example: BNBUSDT

limit

integer · max: 5000

Example: 1

Default: 100

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. A status mismatch returns error -1220 SYMBOL_DOES_NOT_MATCH_STATUS.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Order book › Responses

Successful Response

Order book

id

string

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

status

integer · int64

Example: 200

object

lastUpdateId

integer · int64

Example: 2731179239

array[]

Bid orders. Each entry is [price, quantity].

Example: [["0.01379900","3.43200000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 0.01379900

[1]

string · required

Quantity

Example: 3.43200000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["0.01380000","5.91700000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 0.01380000

[1]

string · required

Quantity

Example: 5.91700000

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

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

symbol

string · required

Example: BNBUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1s

startTime

integer · int64

Example: 1735693200000

endTime

integer · int64

Example: 1735693200000

timeZone

string

Default: 0 (UTC)

Example: 0

limit

integer · max: 1000

Example: 1

Default: 500

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

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1499040000000

[1]

string · required

Open

Example: 0.01634790

[2]

string · required

High

Example: 0.80000000

[3]

string · required

Low

Example: 0.01575800

[4]

string · required

Example: 0.01577100

[5]

string · required

Volume

Example: 148976.11427815

[6]

integer · int64 · required

Close time

Example: 1499644799999

[7]

string · required

Quote asset volume

Example: 2434.19055334

[8]

integer · required

Number of trades

Example: 308

[9]

string · required

Taker buy base asset volume

Example: 1756.87402397

[10]

string · required

Taker buy quote asset volume

Example: 28.46694368

[11]

string · required

Ignore

Example: 0

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

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

symbol

string

Query ticker of a single symbol

Example: BNBUSDT

symbols

string[]

Query ticker for multiple symbols

type

string · enum

Ticker type. Supported values: FULL (default) or MINI

Enum values:

FULL

MINI

Example: FULL

windowSize

string · enum

Defaults to 1d if no parameter provided.

Enum values:

Example: 1d

symbolStatus

string · enum

Filters for symbols that have this tradingStatus. For a single symbol, a status mismatch returns error -1220 SYMBOL_DOES_NOT_MATCH_STATUS. For multiple or all symbols, non-matching ones are simply excluded from the response. Valid values: TRADING, HALT, BREAK

Enum values:

TRADING

HALT

BREAK

Example: TRADING

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

symbol

string

Example: BNBUSDT

symbols

string[]

type

string · enum

Ticker type. Supported values: FULL (default) or MINI

Enum values:

FULL

MINI

Example: FULL

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

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

string

Query ticker for a single symbol

Example: BNBUSDT

symbols

string[]

Query ticker for multiple symbols

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

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

string

Query price for a single symbol

Example: BNBUSDT

symbols

string[]

Query price for multiple symbols

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

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

symbol

string

Example: BNBUSDT

symbols

string[]

timeZone

string

Default: 0 (UTC)

Example: 0

type

string · enum

Ticker type. Supported values: FULL (default) or MINI

Enum values:

FULL

MINI

Example: FULL

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Trading Day Ticker › Responses

Successful Response

Trading Day Ticker

id

string

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

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

priceChange

string

Absolute price change

Example: -83.13

priceChangePercent

string

Relative price change in percent

Example: -0.317

weightedAvgPrice

string

quoteVolume / volume

Example: 26234.58803036

openPrice

string

Example: 26304.8

highPrice

string

Example: 26397.46

lowPrice

string

Example: 26088.34

lastPrice

string

Example: 26221.67

volume

string

Volume in base asset

Example: 18495.35066

quoteVolume

string

Volume in quote asset

Example: 485217905.0421048

openTime

integer · int64

Example: 1695686400000

closeTime

integer · int64

Example: 1695772799999

firstId

integer · int64

Trade ID of the first trade in the interval

Example: 3220151555

lastId

integer · int64

Trade ID of the last trade in the interval

Example: 3220849281

count

integer · int64

Number of trades in the interval

Example: 697727

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

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

symbol

string · required

Example: BNBUSDT

fromId

integer · int64

Aggregate trade ID to begin at

Example: 1

startTime

integer · int64

Timestamp in ms to get aggregate trades from INCLUSIVE.

Example: 1735693200000

endTime

integer · int64

Timestamp in ms to get aggregate trades until INCLUSIVE.

Example: 1735693200000

limit

integer · max: 1000

Example: 1

Default: 500

Aggregate trades › Responses

Successful Response

Aggregate trades

id

string

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

status

integer · int64

Example: 200

object[]

a

integer · int64

Aggregate tradeId

Example: 50000000

p

string

Price

Example: 0.002741

q

string

Quantity

Example: 57.19

f

integer · int64

First tradeId

Example: 59120167

l

integer · int64

Last tradeId

Example: 59120170

T

integer · int64

Timestamp

Example: 1565877971222

m

boolean

Was the buyer the maker?

Example: true

M

boolean

Was the trade the best price match?

Example: true

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

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

symbol

string · required

Example: BNBUSDT

fromId

integer · int64

Trade ID to begin at

Example: 1

limit

integer · max: 1000

Example: 1

Default: 500

Historical trades › Responses

Successful Response

Historical trades

id

string

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

status

integer · int64

Example: 200

object[]

id

integer · int64

Example: 0

price

string

Example: 0.00005

qty

string

Example: 40

quoteQty

string

Example: 0.002

time

integer · int64

Example: 1500004800376

isBuyerMaker

boolean

Example: true

isBestMatch

boolean

Example: true

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

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

symbol

string · required

Example: BNBBTC

fromId

integer · int64 · required

Block trade ID to fetch from

Example: 582

limit

integer · int64 · max: 1000

Default: 500; Maximum: 1000

Example: 500

Default: 500

Historical Block Trades › Responses

Successful Response

Historical Block Trades

id

string

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

status

integer

Example: 200

object[]

id

integer · int64

Example: 582

price

string

Example: 0.052

qty

string

Example: 5838

quoteQty

string

Example: 303.576

time

integer · int64

Example: 1772506983321

isBuyerMaker

boolean

Example: true

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer

Example: 1

limit

integer

Example: 6000

count

integer

Example: 10

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

symbol

string · required

Example: BNBUSDT

limit

integer · max: 1000

Example: 1

Default: 500

Recent trades › Responses

Successful Response

Recent trades

id

string

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

status

integer · int64

Example: 200

object[]

id

integer · int64

Example: 194686783

price

string

Example: 0.01361

qty

string

Example: 0.014

quoteQty

string

Example: 0.00019054

time

integer · int64

Example: 1660009530807

isBuyerMaker

boolean

Example: true

isBestMatch

boolean

Example: true

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

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

symbol

string · required

Example: BNBUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1s

startTime

integer · int64

Example: 1735693200000

endTime

integer · int64

Example: 1735693200000

timeZone

string

Default: 0 (UTC)

Example: 0

limit

integer · max: 1000

Example: 1

Default: 500

UI Klines › Responses

Successful Response

UI Klines

id

string

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

status

integer · int64

Example: 200

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1499040000000

[1]

string · required

Open

Example: 0.01634790

[2]

string · required

High

Example: 0.80000000

[3]

string · required

Low

Example: 0.01575800

[4]

string · required

Example: 0.01577100

[5]

string · required

Volume

Example: 148976.11427815

[6]

integer · int64 · required

Close time

Example: 1499644799999

[7]

string · required

Quote asset volume

Example: 2434.19055334

[8]

integer · required

Number of trades

Example: 308

[9]

string · required

Taker buy base asset volume

Example: 1756.87402397

[10]

string · required

Taker buy quote asset volume

Example: 28.46694368

[11]

string · required

Ignore

Example: 0

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

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

symbol

string · required

Example: BAZUSD

Query Reference Price › Responses

Successful Response

Query Reference Price

id

string

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

status

integer · int64

Example: 200

object

symbol

string

Example: BAZUSD

referencePrice

string

Example: 0.00501900

timestamp

integer · int64

Timestamp when the reference price was valid

Example: 1770946889251

code

integer · int64

Example: -2043

msg

string

Example: This symbol doesn't have a reference price.

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

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

symbol

string · required

Example: BAZUSD

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: BAZUSD

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

symbol

string

Example: BAZUSD

calculationType

string

Example: ARITHMETIC_MEAN

bucketCount

integer · int64

If the reference price is being calculated by the matching engine as an arithmetic mean

Example: 10

bucketWidthMs

integer · int64

If the reference price is being calculated by the matching engine as an arithmetic mean

Example: 1000

externalCalculationId

integer · int64

If the reference price is being calculated outside the matching engine

Example: 42

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

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