Market data requests

Order book

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "depth",
    "params": {
        "symbol": "BNBUSDT"
    }
}

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.

Weight: Adjusted based on the limit:

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

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
limit	INT	NO	Default: 100; Maximum: 5000.
symbolStatus	ENUM	NO	Filters for symbols that have this tradingStatus. A status mismatch returns error -1220 SYMBOL_DOES_NOT_MATCH_STATUS.

Data Source: Memory

Response:

{
    "id": "51e2affb-0aba-4821-ba75-f2625006eb43",
    "status": 200,
    "result": {
        "lastUpdateId": 2731179239,
        // Bid orders. Each entry is [price, quantity].
        "bids": [
            [
                "0.01379900", // Price
                "3.43200000"  // Quantity
            ],
            [
                "0.01379800", // Price
                "3.24300000"  // Quantity
            ],
            [
                "0.01379700", // Price
                "10.45500000" // Quantity
            ],
            [
                "0.01379600", // Price
                "3.82100000"  // Quantity
            ],
            [
                "0.01379500", // Price
                "10.26200000" // Quantity
            ]
        ],
        // Ask orders. Each entry is [price, quantity].
        "asks": [
            [
                "0.01380000", // Price
                "5.91700000"  // Quantity
            ],
            [
                "0.01380100", // Price
                "6.01400000"  // Quantity
            ],
            [
                "0.01380200", // Price
                "0.26800000"  // Quantity
            ],
            [
                "0.01380300", // Price
                "0.33800000"  // Quantity
            ],
            [
                "0.01380400", // Price
                "0.26800000"  // Quantity
            ]
        ]
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Recent trades

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.recent",
    "params": {
        "symbol": "BNBUSDT"
    }
}

Get recent trades.

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

• <symbol>@trade

Weight: 25

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
limit	INT	NO	Default: 500; Maximum: 1000.

Data Source: Memory

Response:

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

Historical trades

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.historical",
    "params": {
        "symbol": "BNBUSDT"
    }
}

Get historical trades.

Weight: 25

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
fromId	LONG	NO	Trade ID to begin at
limit	INT	NO	Default: 500; Maximum: 1000.

Data Source: Database

Notes:

• If fromId is not specified, the most recent trades are returned.

Response:

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

Historical Block Trades

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "blockTrades.historical",
    "params": {
        "symbol": "BNBBTC",
        "fromId": 582
    }
}

Get block trades.

Weight: 25

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
fromId	LONG	YES	Block trade ID to fetch from
limit	LONG	NO	Default: 500; Maximum: 1000

Data Source: Database

Response:

{
    "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
        }
    ]
}

Aggregate trades

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "trades.aggregate",
    "params": {
        "symbol": "BNBUSDT"
    }
}

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.

Weight: 4

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
fromId	LONG	NO	Aggregate trade ID to begin at
startTime	LONG	NO	Timestamp in ms to get aggregate trades from INCLUSIVE.
endTime	LONG	NO	Timestamp in ms to get aggregate trades until INCLUSIVE.
limit	INT	NO	Default: 500; Maximum: 1000.

Data Source: Database

• If fromId is specified, return aggtrades with aggregate trade ID >= fromId. Use fromId and limit to page through all aggtrades.
• If startTime and/or endTime are specified, aggtrades are filtered by execution time (T). fromId cannot be used together with startTime and endTime.
• If no condition is specified, the most recent aggregate trades are returned.

Response:

{
    "id": "189da436-d4bd-48ca-9f95-9f613d621717",
    "status": 200,
    "result": [
        {
            "a": 50000000,      // Aggregate tradeId
            "p": "0.00274100",  // Price
            "q": "57.19000000", // Quantity
            "f": 59120167,      // First tradeId
            "l": 59120170,      // Last tradeId
            "T": 1565877971222, // Timestamp
            "m": true,          // Was the buyer the maker?
            "M": true           // Was the trade the best price match?
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

Klines

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "klines",
    "params": {
        "symbol": "BNBUSDT",
        "interval": "1s"
    }
}

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.

Weight: 2

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
interval	ENUM	YES
startTime	LONG	NO
endTime	LONG	NO
timeZone	STRING	NO	Default: 0 (UTC)
limit	INT	NO	Default: 500; Maximum: 1000.

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.

Response:

{
    "id": "1dbbeb56-8eea-466a-8f6e-86bdcfa2fc0b",
    "status": 200,
    "result": [
        [
            1499040000000,     // Open time
            "0.01634790",      // Open
            "0.80000000",      // High
            "0.01575800",      // Low
            "0.01577100",      // Close
            "148976.11427815", // Volume
            1499644799999,     // Close time
            "2434.19055334",   // Quote asset volume
            308,               // Number of trades
            "1756.87402397",   // Taker buy base asset volume
            "28.46694368",     // Taker buy quote asset volume
            "0"                // Ignore
        ]
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

UI Klines

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "uiKlines",
    "params": {
        "symbol": "BNBUSDT",
        "interval": "1s"
    }
}

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.

Weight: 2

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
interval	ENUM	YES
startTime	LONG	NO
endTime	LONG	NO
timeZone	STRING	NO	Default: 0 (UTC)
limit	INT	NO	Default: 500; Maximum: 1000.

Data Source: Database

• 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.

Response:

{
    "id": "b137468a-fb20-4c06-bd6b-625148eec958",
    "status": 200,
    "result": [
        [
            1499040000000,     // Open time
            "0.01634790",      // Open
            "0.80000000",      // High
            "0.01575800",      // Low
            "0.01577100",      // Close
            "148976.11427815", // Volume
            1499644799999,     // Close time
            "2434.19055334",   // Quote asset volume
            308,               // Number of trades
            "1756.87402397",   // Taker buy base asset volume
            "28.46694368",     // Taker buy quote asset volume
            "0"                // Ignore
        ]
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Current average price

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "avgPrice",
    "params": {
        "symbol": "BNBUSDT"
    }
}

Get current average price for a symbol.

Weight: 2

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES

Data Source: Memory

Response:

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "mins": 5,                 // Average price interval (in minutes)
        "price": "0.01378135",     // Average price
        "closeTime": 1694061154503 // Last trade time
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

24hr ticker price change statistics

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.24hr"
}

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.

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

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO
symbols	ARRAY OF STRING	NO
type	ENUM	NO	Ticker type. Supported values: FULL (default) or MINI
symbolStatus	ENUM	NO	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

Data Source: Memory

Notes:

• symbol and symbols cannot be used together.

• If no symbol is specified, returns information about all symbols currently trading on the exchange.

Response:

FULL type, for a single symbol:

{
    "id": "9fa2a91b-3fca-4ed7-a9ad-58e3b67483de",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",            // Symbol Name
        "priceChange": "0.00013900",
        "priceChangePercent": "1.020",
        "weightedAvgPrice": "0.01382453",
        "prevClosePrice": "0.01362800",
        "lastPrice": "0.01376700",     // Closing price of the interval
        "lastQty": "1.78800000",
        "bidPrice": "0.01376700",
        "bidQty": "4.64600000",
        "askPrice": "0.01376800",
        "askQty": "14.31400000",
        "openPrice": "0.01362800",     // Opening price of the Interval
        "highPrice": "0.01414900",     // Highest price in the interval
        "lowPrice": "0.01346600",      // Lowest  price in the interval
        "volume": "69412.40500000",    // Total trade volume (in base asset)
        "quoteVolume": "959.59411487", // Total trade volume (in quote asset)
        "openTime": 1660014164909,     // Start of the ticker interval
        "closeTime": 1660100564909,    // End of the ticker interval
        "firstId": 194696115,          // First tradeId
        "lastId": 194968287,           // Last tradeId
        "count": 272173                // Trade count
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

MINI type, for a single symbol:

{
    "id": "9fa2a91b-3fca-4ed7-a9ad-58e3b67483de",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",            // Symbol Name
        "openPrice": "0.01362800",     // Opening price of the Interval
        "highPrice": "0.01414900",     // Highest price in the interval
        "lowPrice": "0.01346600",      // Lowest  price in the interval
        "lastPrice": "0.01376700",     // Closing price of the interval
        "volume": "69412.40500000",    // Total trade volume (in base asset)
        "quoteVolume": "959.59411487", // Total trade volume (in quote asset)
        "openTime": 1660014164909,     // Start of the ticker interval
        "closeTime": 1660100564909,    // End of the ticker interval
        "firstId": 194696115,          // First trade ID
        "lastId": 194968287,           // Last trade ID
        "count": 272173                // Number of trades
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2 // Number of trades
        }
    ]
}

If more than one symbol is requested, response returns an array:

{
    "id": "901be0d9-fd3b-45e4-acd6-10c580d03430",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",            // Symbol Name
            "priceChange": "0.00016500",
            "priceChangePercent": "1.213",
            "weightedAvgPrice": "0.01382508",
            "prevClosePrice": "0.01360800",
            "lastPrice": "0.01377200",     // Closing price of the interval
            "lastQty": "1.01400000",
            "bidPrice": "0.01377100",
            "bidQty": "7.55700000",
            "askPrice": "0.01377200",
            "askQty": "4.37900000",
            "openPrice": "0.01360700",     // Opening price of the Interval
            "highPrice": "0.01414900",     // Highest price in the interval
            "lowPrice": "0.01346600",      // Lowest  price in the interval
            "volume": "69376.27900000",    // Total trade volume (in base asset)
            "quoteVolume": "959.13277091", // Total trade volume (in quote asset)
            "openTime": 1660014615517,     // Start of the ticker interval
            "closeTime": 1660101015517,    // End of the ticker interval
            "firstId": 194697254,          // First tradeId
            "lastId": 194969483,           // Last tradeId
            "count": 272230                // Trade count
        },
        {
            "symbol": "BTCUSDT",
            "priceChange": "-938.06000000",
            "priceChangePercent": "-3.938",
            "weightedAvgPrice": "23265.34432003",
            "prevClosePrice": "23819.17000000",
            "lastPrice": "22880.91000000",
            "lastQty": "0.00536000",
            "bidPrice": "22880.40000000",
            "bidQty": "0.00424000",
            "askPrice": "22880.91000000",
            "askQty": "0.04276000",
            "openPrice": "23818.97000000",
            "highPrice": "23933.25000000",
            "lowPrice": "22664.69000000",
            "volume": "153508.37606000",
            "quoteVolume": "3571425225.04441220",
            "openTime": 1660014615977,
            "closeTime": 1660101015977,
            "firstId": 1592019902,
            "lastId": 1597301762,
            "count": 5281861
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Trading Day Ticker

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.tradingDay",
    "params": {
        "symbols": [
            "BNBBTC",
            "BTCUSDT"
        ],
        "timeZone": "00:00"
    }
}

Price change statistics for a trading day.

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.

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO
symbols	ARRAY OF STRING	NO
timeZone	STRING	NO	Default: 0 (UTC)
type	ENUM	NO	Ticker type. Supported values: FULL (default) or MINI
symbolStatus	ENUM	NO	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

Data Source: Database

Notes:

• Supported values for timeZone:
  • Hours and minutes (e.g. -1:00, 05:45)
  • Only hours (e.g. 0, 8, 4)

Response:

FULL type, with symbol:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        "priceChange": "-83.13000000",        // Absolute price change
        "priceChangePercent": "-0.317",       // Relative price change in percent
        "weightedAvgPrice": "26234.58803036", // quoteVolume / volume
        "openPrice": "26304.80000000",
        "highPrice": "26397.46000000",
        "lowPrice": "26088.34000000",
        "lastPrice": "26221.67000000",
        "volume": "18495.35066000",           // Volume in base asset
        "quoteVolume": "485217905.04210480",
        "openTime": 1695686400000,
        "closeTime": 1695772799999,
        "firstId": 3220151555,
        "lastId": 3220849281,
        "count": 697727
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

FULL type, with symbols:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "priceChange": "-83.13000000",        // Absolute price change
            "priceChangePercent": "-0.317",       // Relative price change in percent
            "weightedAvgPrice": "26234.58803036", // quoteVolume / volume
            "openPrice": "26304.80000000",
            "highPrice": "26397.46000000",
            "lowPrice": "26088.34000000",
            "lastPrice": "26221.67000000",
            "volume": "18495.35066000",           // Volume in base asset
            "quoteVolume": "485217905.04210480",  // Volume in quote asset
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 3220151555,                // Trade ID of the first trade in the interval
            "lastId": 3220849281,                 // Trade ID of the last trade in the interval
            "count": 697727                       // Number of trades in the interval
        },
        {
            "symbol": "BNBUSDT",
            "priceChange": "2.60000000",
            "priceChangePercent": "1.238",
            "weightedAvgPrice": "211.92276958",
            "openPrice": "210.00000000",
            "highPrice": "213.70000000",
            "lowPrice": "209.70000000",
            "lastPrice": "212.60000000",
            "volume": "280709.58900000",
            "quoteVolume": "59488753.54750000",
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 672397461,
            "lastId": 672496158,
            "count": 98698
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

MINI type, with symbol:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        "openPrice": "26304.80000000",
        "highPrice": "26397.46000000",
        "lowPrice": "26088.34000000",
        "lastPrice": "26221.67000000",
        "volume": "18495.35066000",          // Volume in base asset
        "quoteVolume": "485217905.04210480", // Volume in quote asset
        "openTime": 1695686400000,
        "closeTime": 1695772799999,
        "firstId": 3220151555,               // Trade ID of the first trade in the interval
        "lastId": 3220849281,                // Trade ID of the last trade in the interval
        "count": 697727                      // Number of trades in the interval
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

MINI type, with symbols:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "openPrice": "26304.80000000",
            "highPrice": "26397.46000000",
            "lowPrice": "26088.34000000",
            "lastPrice": "26221.67000000",
            "volume": "18495.35066000",          // Volume in base asset
            "quoteVolume": "485217905.04210480", // Volume in quote asset
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 3220151555,               // Trade ID of the first trade in the interval
            "lastId": 3220849281,                // Trade ID of the last trade in the interval
            "count": 697727                      // Number of trades in the interval
        },
        {
            "symbol": "BNBUSDT",
            "openPrice": "210.00000000",
            "highPrice": "213.70000000",
            "lowPrice": "209.70000000",
            "lastPrice": "212.60000000",
            "volume": "280709.58900000",
            "quoteVolume": "59488753.54750000",
            "openTime": 1695686400000,
            "closeTime": 1695772799999,
            "firstId": 672397461,
            "lastId": 672496158,
            "count": 98698
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

Rolling window price change statistics

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker",
    "params": {
        "symbols": [
            "BNBBTC",
            "BTCUSDT"
        ],
        "windowSize": "7d"
    }
}

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:

{
    "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

Weight: Adjusted based on the number of requested symbols:

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

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Query ticker of a single symbol
symbols	ARRAY OF STRING	NO	Query ticker for multiple symbols
type	ENUM	NO	Ticker type. Supported values: FULL (default) or MINI
windowSize	ENUM	NO	Defaults to 1d if no parameter provided.
symbolStatus	ENUM	NO	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

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.

Response:

FULL type, for a single symbol:

{
    "id": "bdb7c503-542c-495c-b797-4d2ee2e91173",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "priceChange": "0.00061500",      // Absolute price change
        "priceChangePercent": "4.735",    // Relative price change in percent
        "weightedAvgPrice": "0.01368242", // QuoteVolume / Volume
        "openPrice": "0.01298900",
        "highPrice": "0.01418800",
        "lowPrice": "0.01296000",
        "lastPrice": "0.01360400",
        "volume": "587179.23900000",
        "quoteVolume": "8034.03382165",   // Sum of (price * volume) for all trades
        "openTime": 1659580020000,        // Open time for ticker window
        "closeTime": 1660184865291,       // Close time for ticker window
        "firstId": 192977765,             // Trade IDs
        "lastId": 195365758,
        "count": 2387994                  // Number of trades in the interval
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

MINI type, for a single symbol:

{
    "id": "bdb7c503-542c-495c-b797-4d2ee2e91173",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "openPrice": "0.01298900",
        "highPrice": "0.01418800",
        "lowPrice": "0.01296000",
        "lastPrice": "0.01360400",
        "volume": "587179.23900000",
        "quoteVolume": "8034.03382165", // Sum of (price * volume) for all trades
        "openTime": 1659580020000,      // Open time for ticker window
        "closeTime": 1660184865291,     // Close time for ticker window
        "firstId": 192977765,           // First trade ID
        "lastId": 195365758,            // Last trade ID
        "count": 2387994                // Number of trades
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4 // Number of trades
        }
    ]
}

If more than one symbol is requested, response returns an array:

{
    "id": "f4b3b507-c8f2-442a-81a6-b2f12daa030f",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "priceChange": "0.00061500",      // Absolute price change
            "priceChangePercent": "4.735",    // Relative price change in percent
            "weightedAvgPrice": "0.01368242", // QuoteVolume / Volume
            "openPrice": "0.01298900",
            "highPrice": "0.01418800",
            "lowPrice": "0.01296000",
            "lastPrice": "0.01360400",
            "volume": "587169.48600000",
            "quoteVolume": "8033.90114517",   // Sum of (price * volume) for all trades
            "openTime": 1659580020000,        // Open time for ticker window
            "closeTime": 1660184820927,       // Close time for ticker window
            "firstId": 192977765,             // Trade IDs
            "lastId": 195365700,
            "count": 2387936                  // Number of trades in the interval
        },
        {
            "symbol": "BTCUSDT",
            "priceChange": "1182.92000000",
            "priceChangePercent": "5.113",
            "weightedAvgPrice": "23349.27074846",
            "openPrice": "23135.33000000",
            "highPrice": "24491.22000000",
            "lowPrice": "22400.00000000",
            "lastPrice": "24318.25000000",
            "volume": "1039498.10978000",
            "quoteVolume": "24271522807.76838630",
            "openTime": 1659580020000,
            "closeTime": 1660184820927,
            "firstId": 1568787779,
            "lastId": 1604337406,
            "count": 35549628
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 8
        }
    ]
}

Symbol price ticker

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.price"
}

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

Weight: Adjusted based on the number of requested symbols:

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

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Query price for a single symbol
symbols	ARRAY OF STRING	NO	Query price for multiple symbols
symbolStatus	ENUM	NO	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

Data Source: Memory

Notes:

• symbol and symbols cannot be used together.

• If no symbol is specified, returns information about all symbols currently trading on the exchange.

Response - when a single symbol is requested:

{
    "id": "043a7cf2-bde3-4888-9604-c8ac41fcba4d",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "price": "0.01361900"
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Response - when multiple symbols are requested:

{
    "id": "e739e673-24c8-4adf-9cfa-b81f30330b09",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "price": "0.01363700"
        },
        {
            "symbol": "BTCUSDT",
            "price": "24267.15000000"
        },
        {
            "symbol": "BNBBUSD",
            "price": "331.10000000"
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

Symbol order book ticker

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "ticker.book"
}

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

Weight: Adjusted based on the number of requested symbols:

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

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Query ticker for a single symbol
symbols	ARRAY OF STRING	NO	Query ticker for multiple symbols
symbolStatus	ENUM	NO	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

Data Source: Memory

Notes:

• symbol and symbols cannot be used together.

• If no symbol is specified, returns information about all symbols currently trading on the exchange.

Response - when a single symbol is requested:

{
    "id": "9d32157c-a556-4d27-9866-66760a174b57",
    "status": 200,
    "result": {
        "symbol": "BNBBTC",
        "bidPrice": "0.01358000", // best bid price.
        "bidQty": "12.53400000",  // bid/ask qty.
        "askPrice": "0.01358100", // best ask price.
        "askQty": "17.83700000"   // bid/ask qty.
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Response - when multiple symbols are requested:

{
    "id": "057deb3a-2990-41d1-b58b-98ea0f09e1b4",
    "status": 200,
    "result": [
        {
            "symbol": "BNBBTC",
            "bidPrice": "0.01358000", // best bid price.
            "bidQty": "12.53400000",  // bid/ask qty.
            "askPrice": "0.01358100", // best ask price.
            "askQty": "17.83700000"   // bid/ask qty.
        },
        {
            "symbol": "BTCUSDT",
            "bidPrice": "23980.49000000",
            "bidQty": "0.01000000",
            "askPrice": "23981.31000000",
            "askQty": "0.01512000"
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

Query Reference Price

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "referencePrice",
    "params": {
        "symbol": "BAZUSD"
    }
}

Weight: 2

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES

Data Source: Memory

If the symbol has never had a reference price set, the request is rejected with:

{
    "code": -2043,
    "msg": "This symbol doesn't have a reference price."
}

Response:

If a reference price is set:

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "referencePrice": "0.00501900",
        "timestamp": 1770946889251 // Timestamp when the reference price was valid
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

If no reference price is set:

{
    "id": "5132affb-0aba-4821-b475-f262504556b43",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "referencePrice": null,
        "timestamp": 1770946889251 // Timestamp when the reference price was valid
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

If no reference price has ever been set:

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 200,
    "result": {
        "code": -2043,
        "msg": "This symbol doesn't have a reference price."
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

Query Reference Price Calculation

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "referencePrice.calculation",
    "params": {
        "symbol": "BAZUSD"
    }
}

Weight: 2

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES
symbolStatus	ENUM	NO

Data Source: Memory

Response:

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

{
    "id": "ddbfb65f-9ebf-42ec-8240-8f0f91de0867",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "calculationType": "ARITHMETIC_MEAN",
        "bucketCount": 10,          // If the reference price is being calculated by the matching engine as an arithmetic mean
        "bucketWidthMs": 1000,      // If the reference price is being calculated by the matching engine as an arithmetic mean
        "externalCalculationId": 42 // If the reference price is being calculated outside the matching engine
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

If the reference price is being calculated outside the matching engine:

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 200,
    "result": {
        "symbol": "BAZUSD",
        "calculationType": "EXTERNAL",
        "externalCalculationId": 42 // If the reference price is being calculated outside the matching engine
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}

If reference price is not being calculated:

{
    "id": "5132affa-0aba-4831-b475-f262504556b41",
    "status": 400,
    "error": {
        "code": -2043,
        "msg": "This symbol doesn't have a reference price."
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 2
        }
    ]
}