Market

Old Trade Lookup

Get older market trades.

Weight(IP): 10

get/api/v3/historicalTrades

Query parameters

symbolstring required
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

limitinteger
Example:5

Default 500; max 1000.

fromIdinteger

Trade id to fetch from. Default gets most recent trades.

Response

Trade list

idinteger required

trade id

pricestring required

price

qtystring required

amount of base asset

quoteQtystring required

amount of quote asset

timeinteger required

Trade executed timestamp, as same as T in the stream

isBuyerMakerboolean required
isBestMatchboolean required

Example response

[
  {
    "id": 345196462,
    "price": "9638.99000000",
    "qty": "0.02077200",
    "quoteQty": "0.02077200",
    "time": 1592887772684
  }
]

Changes

Changed in 2 of the 26 revisions of this API.214

    • the endpoint scheme security ApiKeyAuth was removed from the API

      api-security-removed

    • removed the non-success response with the status 400

      response-non-success-status-removed

    • removed the non-success response with the status 401

      response-non-success-status-removed

  • a484ce871a72211See the full diff
    • for the query request parameter fromId, 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

    • the response property code became required for the status 400

      response-property-became-required

    • the response property code became required for the status 401

      response-property-became-required

    • the response property items/id became required for the status 200

      response-property-became-required

    • the response property items/isBestMatch became required for the status 200

      response-property-became-required

    • the response property items/isBuyerMaker became required for the status 200

      response-property-became-required

    • the response property items/price became required for the status 200

      response-property-became-required

    • the response property items/qty became required for the status 200

      response-property-became-required

    • the response property items/quoteQty became required for the status 200

      response-property-became-required

    • the response property items/time became required for the status 200

      response-property-became-required

    • the response property msg became required for the status 400

      response-property-became-required

    • the response property msg became required for the status 401

      response-property-became-required