Sign in
Market

Kline/Candlestick Data

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

  • If startTime and endTime are not sent, the most recent klines are returned.

Weight(IP): 2

get/api/v3/klines

Query parameters

symbolstring required
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

interval'1s' | '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M' required
Example:"1m"

kline intervals

startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

timeZonestring

Default: 0 (UTC)

limitinteger
Example:5

Default 500; max 1000.

Response

Kline data

Example response

[
  [
    1499040000000,
    "0.01634790",
    "0.80000000",
    "0.01575800",
    "0.01577100",
    "148976.11427815",
    1499644799999,
    "2434.19055334",
    308,
    "1756.87402397",
    "28.46694368",
    "17928899.62484339"
  ]
]

Changes

Changed in 3 of the 26 revisions of this API.44

  • 6c02ecd56d371See the full diff
    • ○

      added the new optional query request parameter timeZone

      new-optional-request-parameter

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5b6a6f4707951See the full diff
    • ○

      added the new enum value 1s to the query request parameter interval

      request-parameter-enum-value-added

  • a484ce871a7242See the full diff
    • ▲

      for the query request parameter endTime, the type/format was changed from integer/ to integer/int64

      request-parameter-type-changed

    • ▲

      for the query request parameter limit, the type/format was changed from integer/ to integer/int32

      request-parameter-type-changed

    • ▲

      for the query request parameter startTime, the type/format was changed from integer/ to integer/int64

      request-parameter-type-changed

    • ▲

      the items/ response's property type/format changed from / to array/ for status 200

      response-property-type-changed

    • ○

      the response property code became required for the status 400

      response-property-became-required

    • ○

      the response property msg became required for the status 400

      response-property-became-required