Historical

Provides historical trade data for Spot market trading pairs, detailing individual trade prices, volumes, buy/sell indicators, and timestamps to track transaction activity over time on supported exchanges.

📘

Time Range Limit

The maximum time range (difference between startDate and endDate) is 731 days (2 years).

🚧

Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.

❗️

exchange=bitmex

Bitmex is currently not supported. It will be added soon.

RESPONSE DATA

Fields and paths are relative to the top-level payload field i.e. metadata.next is equivalent to payload.metadata.next.

JSON Field/PathValue TypeDescription
payload.metadata.nextstringThe URL for the next page of results, if there are more results to fetch. It is a paginated cursor that allows the client to retrieve subsequent data.
payload.metadata.api-versionstringThe version of the API being used, indicated as a date string in the format YYYY-MM-DD.
payload.data[{index}].instrumentstringThe trading pair or instrument identifier, such as "eth_usd".
payload.data[{index}].exchangestringThe name of the exchange where the data originates, such as "gdax".
payload.data[{index}].exchangeTimestampnumberThe timestamp from the exchange in milliseconds for when the trade occurred.
payload.data[{index}].exchangeTimestampNanosecondsnumberThe timestamp from the exchange in nanoseconds, offering a more precise time for when the trade occurred.
payload.data[{index}].isBuySidebooleanIndicates whether the trade was initiated by the buyer (true) or the seller (false).
payload.data[{index}].pricenumberThe price at which the trade occurred.
payload.data[{index}].volumenumberThe volume of the asset traded in the base currency.
payload.data[{index}].tradeIdstringThe unique identifier for the trade provided by the exchange.
payload.data[{index}].sequencestringThe sequence number for the trade data provided by the exchange.
payload.data[{index}].quoteVolumenumberThe volume of the asset traded in the quote currency. Can be null if not provided.
Language
Credentials
Header
Click Try It! to start a request and see the response here!