Market

Endpoint

Compressed/Aggregate trades list

Get compressed, aggregate trades. Trades that fill at the time, from the same taker order, with the same price will have the quantity aggregated.

GET

/api/v3/aggTrades

https://api.binance.com

Compressed/Aggregate trades list › 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

Compressed/Aggregate trades list › Query Parameters

symbol

string · required

Example: BNBUSDT

fromId

integer · int64

ID to get aggregate trades from INCLUSIVE.

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

Compressed/Aggregate trades list › Responses

200

Compressed/Aggregate trades list

object

a

integer · int64

Aggregate tradeId

Example: 26129

p

string

Price

Example: 0.01633102

q

string

Quantity

Example: 4.70443515

f

integer · int64

First tradeId

Example: 27781

l

integer · int64

Last tradeId

Example: 27781

T

integer · int64

Timestamp

Example: 1498793709153

m

boolean

Was the buyer the maker?

Example: true

M

boolean

Was the trade the best price match?

Example: true

Current average price

Current average price for a symbol.

GET

/api/v3/avgPrice

https://api.binance.com

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

symbol

string · required

Example: BNBUSDT

Current average price › Responses

200

Current average price

mins

integer · int64

Average price interval (in minutes)

Example: 5

price

string

Average price

Example: 9.35751834

closeTime

integer · int64

Last trade time

Example: 1694061154503

Order book

GET

/api/v3/depth

https://api.binance.com

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

symbol

string · required

Example: BNBUSDT

limit

integer · max: 5000

If limit > 5000, only 5000 entries will be returned.

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

200

Order book

lastUpdateId

integer · int64

Example: 1027024

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

Recent trades list

Get recent trades.

GET

/api/v3/trades

https://api.binance.com

Recent trades list › 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 list › Query Parameters

symbol

string · required

Example: BNBUSDT

limit

integer · max: 1000

Example: 1

Default: 500

Recent trades list › Responses

200

Recent trades list

object

id

integer · int64

Example: 28457

price

string

Example: 4.00000100

qty

string

Example: 12.00000000

quoteQty

string

Example: 48.000012

time

integer · int64

Example: 1499865549590

isBuyerMaker

boolean

Example: true

isBestMatch

boolean

Example: true

Old trade lookup

Get older trades.

GET

/api/v3/historicalTrades

https://api.binance.com

Old trade lookup › 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

Old trade lookup › Query Parameters

symbol

string · required

Example: BNBUSDT

limit

integer · max: 1000

Example: 1

Default: 500

fromId

integer · int64

TradeId to fetch from. Default gets most recent trades.

Example: 1

Old trade lookup › Responses

200

Old trade lookup

object

id

integer · int64

Example: 28457

price

string

Example: 4.00000100

qty

string

Example: 12.00000000

quoteQty

string

Example: 48.000012

time

integer · int64

Example: 1499865549590

isBuyerMaker

boolean

Example: true

isBestMatch

boolean

Example: true

Historical Block Trades

Get block trades.

GET

/api/v3/historicalBlockTrades

https://api.binance.com

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

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Historical Block Trades › Query Parameters

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

200

Historical Block Trades

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

Kline/Candlestick data

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

GET

/api/v3/klines

https://api.binance.com

Kline/Candlestick data › 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

Kline/Candlestick data › Query Parameters

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.

Kline/Candlestick data › Responses

200

Kline/Candlestick data

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

Rolling window price change statistics

Note: This endpoint differs from GET /api/v3/ticker/24hr.

The statistical time range of this endpoint can be up to 59999ms longer than the requested windowSize.

openTime starts at the beginning of a minute, while the end time is the current time. Therefore, the actual interval can be up to 59999ms longer than the requested window.

For example, if closeTime is 1641287867099 (January 04, 2022 09:17:47:099 UTC) and windowSize is 1d, then openTime is 1641201420000 (January 3, 2022, 09:17:00 UTC).

GET

/api/v3/ticker

https://api.binance.com

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

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.

Rolling window price change statistics › Query Parameters

symbol

string

Either symbol or symbols must be provided

Example: BNBUSDT

symbols

string[]

Either symbol or symbols must be provided

Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D

The maximum number of symbols allowed in a request is 100.

Example: ["BTCUSDT","BNBUSDT"]

windowSize

string · enum

Units cannot be combined (e.g. 1d2h is not allowed).

Enum values:

Example: 1m

Default: 1d

type

string · enum

Enum values:

FULL

MINI

Example: FULL

Default: FULL

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 symbols, non-matching ones are simply excluded from the response.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Rolling window price change statistics › Responses

200

Rolling window price change statistics

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: LTCBTC

priceChange

string

Absolute price change

Example: -8

priceChangePercent

string

Relative price change in percent

Example: -88.889

weightedAvgPrice

string

QuoteVolume / Volume

Example: 2.60427807

openPrice

string

Example: 0.1

highPrice

string

Example: 2

lowPrice

string

Example: 0.1

lastPrice

string

Example: 2

volume

string

Example: 39

quoteVolume

string

Sum of (price * volume) for all trades

Example: 13.4

openTime

integer · int64

Open time for ticker window

Example: 1656986580000

closeTime

integer · int64

Close time for ticker window

Example: 1657001016795

firstId

integer · int64

Trade IDs

Example: 0

lastId

integer · int64

Example: 34

count

integer · int64

Number of trades in the interval

Example: 35

24hr ticker price change statistics

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

GET

/api/v3/ticker/24hr

https://api.binance.com

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

Parameter	Symbols Provided	Weight
symbol	1	2
symbol	symbol parameter is omitted	80
symbols	1-20	2
	21-100	40
	101 or more	80
	symbols parameter is omitted	80

24hr ticker price change statistics › Query Parameters

symbol

string

Either symbol or symbols must be provided

Example: BNBUSDT

symbols

string[]

Either symbol or symbols must be provided

Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D

The maximum number of symbols allowed in a request is 100.

Example: ["BTCUSDT","BNBUSDT"]

type

string · enum

Enum values:

FULL

MINI

Example: FULL

Default: FULL

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

24hr ticker price change statistics › Responses

200

24hr ticker price change statistics

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Symbol Name

Example: BNBBTC

priceChange

string

Example: -94.999998

priceChangePercent

string

Example: -95.96

weightedAvgPrice

string

Example: 0.29628482

prevClosePrice

string

Example: 0.10002

lastPrice

string

Closing price of the interval

Example: 4.000002

lastQty

string

Example: 200

bidPrice

string

Example: 4

bidQty

string

Example: 100

askPrice

string

Example: 4.000002

askQty

string

Example: 100

openPrice

string

Opening price of the Interval

Example: 99

highPrice

string

Highest price in the interval

Example: 100

lowPrice

string

Lowest price in the interval

Example: 0.1

volume

string

Total trade volume (in base asset)

Example: 8913.3

quoteVolume

string

Total trade volume (in quote asset)

Example: 15.3

openTime

integer · int64

Start of the ticker interval

Example: 1499783499040

closeTime

integer · int64

End of the ticker interval

Example: 1499869899040

firstId

integer · int64

First tradeId

Example: 28385

lastId

integer · int64

Last tradeId

Example: 28460

count

integer · int64

Trade count

Example: 76

Symbol order book ticker

Best price/qty on the order book for a symbol or symbols.

GET

/api/v3/ticker/bookTicker

https://api.binance.com

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

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

Symbol order book ticker › Query Parameters

symbol

string

Parameter symbol and symbols cannot be used in combination. If neither parameter is sent, bookTickers for all symbols will be returned in an array.

Example: BNBUSDT

symbols

string[]

Parameter symbol and symbols cannot be used in combination. If neither parameter is sent, bookTickers for all symbols will be returned in an array. Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D

Example: ["BTCUSDT","BNBUSDT"]

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.

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Symbol order book ticker › Responses

200

Symbol order book ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: LTCBTC

bidPrice

string

best bid price.

Example: 4

bidQty

string

bid/ask qty.

Example: 431

askPrice

string

best ask price.

Example: 4.000002

askQty

string

bid/ask qty.

Example: 9

Symbol price ticker

Latest price for a symbol or symbols.

GET

/api/v3/ticker/price

https://api.binance.com

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

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

Symbol price ticker › Query Parameters

symbol

string

Parameter symbol and symbols cannot be used in combination. If neither parameter is sent, prices for all symbols will be returned in an array.

Example: BNBUSDT

symbols

string[]

Parameter symbol and symbols cannot be used in combination. If neither parameter is sent, prices for all symbols will be returned in an array. Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D

Example: ["BTCUSDT","BNBUSDT"]

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Symbol price ticker › Responses

200

Symbol price ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: LTCBTC

price

string

Example: 4.000002

Trading Day Ticker

Price change statistics for a trading day.

GET

/api/v3/ticker/tradingDay

https://api.binance.com

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. The weight for this request will cap at 200 once the number of symbols in the request is more than 50.

Trading Day Ticker › Query Parameters

symbol

string

Either symbol or symbols must be provided.

Example: BNBUSDT

symbols

string[]

Either symbol or symbols must be provided. Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D. The maximum number of symbols allowed in a request is 100.

Example: ["BTCUSDT","BNBUSDT"]

timeZone

string

Default: 0 (UTC)

Example: 0

Default: 0

type

string · enum

Enum values:

FULL

MINI

Example: FULL

Default: FULL

symbolStatus

string · enum

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Trading Day Ticker › Responses

200

Trading Day Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

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

UIKlines

The request is similar to klines having the same parameters and response.

uiKlines return modified kline data, optimized for presentation of candlestick charts.

GET

/api/v3/uiKlines

https://api.binance.com

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

UIKlines › Query Parameters

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

Default: 0

limit

integer · max: 1000

Example: 1

Default: 500

UIKlines › Responses

200

UIKlines

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

Query Reference Price

Query the reference price for a symbol.

GET

/api/v3/referencePrice

https://api.binance.com

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

symbol

string · required

Example: BNBUSDT

Query Reference Price › Responses

200

Reference price

symbol

string

Example: BAZUSD

referencePrice

string

Reference price. Can be null if no reference price is set.

Example: 10.00

timestamp

integer · int64

Timestamp when reference price was valid.

Example: 1770736694138

Query Reference Price Calculation

Describes how reference price is calculated for a given symbol.

GET

/api/v3/referencePrice/calculation

https://api.binance.com

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

symbol

string · required

Example: BNBUSDT

symbolStatus

string · enum

Supported values: TRADING, HALT, BREAK

Enum values:

TRADING

HALT

BREAK

Example: TRADING

Query Reference Price Calculation › Responses

200

Reference price calculation

symbol

string

Example: BAZUSD

calculationType

string

Either ARITHMETIC_MEAN or EXTERNAL.

Example: ARITHMETIC_MEAN

bucketCount

integer · int64

Present when calculationType is ARITHMETIC_MEAN.

Example: 10

bucketWidthMs

integer · int64

Present when calculationType is ARITHMETIC_MEAN.

Example: 1000

externalCalculationId

integer · int64

Present when calculationType is EXTERNAL.

Example: 42