Skip to main content
GET
/
spot
/
reference-rates
/
{assetId}
Hourly & Daily Reference Rates
curl --request GET \
  --url https://api.amberdata.com/markets/spot/reference-rates/{assetId} \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "timeInterval": "hours",
      "api-version": "2023-09-30"
    },
    "data": {
      "assetARCID": "eth",
      "assetSymbol": "eth",
      "assetName": "Ether",
      "currency": "usd",
      "referenceRates": [
        {
          "timestamp": "2023-11-05 18:00:00 000",
          "unitPrice": 1896.2722539256226
        },
        {
          "timestamp": "2023-11-05 19:00:00 000",
          "unitPrice": 1892.070741279808
        },
        {
          "timestamp": "2023-11-05 20:00:00 000",
          "unitPrice": 1888.6184732343843
        },
        {
          "timestamp": "2023-11-05 21:00:00 000",
          "unitPrice": 1870.1300714429476
        },
        {
          "timestamp": "2023-11-05 22:00:00 000",
          "unitPrice": 1881.8808731384033
        }
      ]
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Headers

​
Accept-Encoding
string
default:gzip, deflate, br
required
​
api-version
string

Path Parameters

​
assetId
enum<string>
default:btc
required

The id of the asset for which reference rates are needed.

Available options:
btc,
eth

Query Parameters

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive). [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). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeFormat
enum<string>
default:hr

[Optional] Time format of the timestamps in the return payload.

Available options:
milliseconds,
ms*,
iso,
iso8601,
hr,
human_readable
​
timeInterval
enum<string>
default:hours

Specify the granularity of the desired reference rate.

Available options:
hours,
days
​
dailyTime
enum<string>

Use with timeInterval=days. Filter for the asset's daily reference rate at 16:00 hours for a specific timezone. [Examples] dailyTime=T16:00+08:00 is 16:00 Singapore & Hong Kong

Available options:
T16:00-05:00,
T16:00-04:00,
T16:00+00:00,
T16:00+01:00,
T16:00+04:00,
T16:00+08:00,
T16:00+09:00
​
direction
enum<string>

The order in which to return the results (ascending or descending). By default, records are returned in descending order, so the most recent records are returned first.

Available options:
desc,
asc

Response

200 - application/json

200

​
status
integer
default:0
Example:

200

​
title
string
Example:

"OK"

​
description
string
Example:

"Successful request"

​
payload
object