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.

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!