Historical

⚠️

Important Update

The old endpoint https://api.amberdata.com/market/futures/ohlcv/{instrument}/historical has been updated to https://api.amberdata.com/markets/futures/ohlcv/:instrument. The old endpoint will be deprecated on 2024-10-31. Please update your integrations accordingly.

See changes here

• Endpoint URL Change:
  • Old: https://api.amberdata.com/market/futures/ohlcv/{instrument}/historical
  • New: https://api.amberdata.com/markets/futures/ohlcv/:instrument
• Metadata Changes:
  • New fields api-version and next are introduced in the metadata object.
  • startDate and endDate fields were removed.
• Data Structure Changes:
  • The data structure remains an array of JSON objects, but the fields within each object have changed slightly.
• Field Changes:
  • Added the instrument field to new schema
  • Renamed timestamp to exchangeTimestamp
• Other
  • The exchange parameter is now a required field
  • Include the Accept-Encoding: header in your API requests to take advantage of compressed responses.

📘

Time Range Limit

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

In order to get more than the maximum allowed, you can use the startDate & endDate parameters to move the time frame window to get the next n days/hours/minutes of data.

🚧

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 with a 1 minute frequency.