Skip to main content
GET
/
spot
/
prices
/
pairs
/
{pair}
/
historical
Pairs Historical
curl --request GET \
  --url https://api.amberdata.com/markets/spot/prices/pairs/{pair}/historical/ \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": [
    {
      "timestamp": "2020-09-11T20:41:00.000Z",
      "pair": "btc_usd",
      "price": 10311.5,
      "volume": 0.1212
    }
  ]
}

Authorizations

​
x-api-key
string
header
default:API_KEY
required

Path Parameters

​
pair
string
default:btc_usd
required

The pair for which to retrieve the requested data.

Query Parameters

​
exchange
string

[Optional] The exchange for which to retrieve the requested data.

​
includeCrossRates
boolean

[Optional] If true, cross rate pairs are included in the price calculations - this option only supports pairs quoted in usd (ie *_usd pairs).
[Defaults] false* | true

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive).
The interval can not exceed 12 months (d), 30 days (h) or 24 hours (m).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>

[Optional] Payload only includes data before this date (exclusive).
The interval can not exceed 12 months (d), 30 days (h) or 24 hours (m).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeInterval
string

[Optional] The time interval of the timeseries in the return payload.
[Defaults] m* | minute | h | hour | d | day

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload.
[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200

​
status
integer
Example:

200

​
title
string
Example:

"OK"

​
description
string
Example:

"Successful request"

​
payload
object[]