v26

latestOpenAPI 3.0.2raw.githubusercontent.com2024-10-0834042975.6 KB
Market

Rolling window price change statistics

The window used to compute statistics is typically slightly wider than requested windowSize.

openTime for /api/v3/ticker always starts on a minute, while the closeTime is the current time of the request. As such, the effective window might be up to 1 minute wider than requested.

E.g. If the closeTime is 1641287867099 (January 04, 2022 09:17:47:099 UTC) , and the windowSize is 1d. the openTime will be: 1641201420000 (January 3, 2022, 09:17:00 UTC)

Weight(IP): 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.

get/api/v3/ticker

Query parameters

symbolstring
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

symbolsstring
Example:["BTCUSDT","BNBBTC"]
windowSizestring

Defaults to 1d if no parameter provided. Supported windowSize values: 1m,2m....59m for minutes 1h, 2h....23h - for hours 1d...7d - for days.

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

typestring

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

Response

Rolling price ticker

symbolstring required
priceChangestring required
priceChangePercentstring required
weightedAvgPricestring required
openPricestring required
highPricestring required
lowPricestring required
lastPricestring required
volumestring required
quoteVolumestring required
openTimeinteger required
closeTimeinteger required
firstIdinteger required
lastIdinteger required
countinteger required

Example response

{
  "symbol": "BNBBTC",
  "priceChange": "-8.00000000",
  "priceChangePercent": "-88.889",
  "weightedAvgPrice": "2.60427807",
  "openPrice": "9.00000000",
  "highPrice": "9.00000000",
  "lowPrice": "1.00000000",
  "lastPrice": "1.00000000",
  "volume": "187.00000000",
  "quoteVolume": "487.00000000",
  "openTime": 1641859200000,
  "closeTime": 1642031999999,
  "lastId": 60,
  "count": 61
}