---
title: "Hourly & Daily Reference Rates"
method: GET
path: "/spot/reference-rates/{assetId}"
---

# Hourly & Daily Reference Rates

`GET /spot/reference-rates/{assetId}`

Retrieve the historical (time series) hourly and daily reference rates for a specific asset.

## Path parameters

- `assetId` 'btc' | 'eth', required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `timeFormat` 'milliseconds' | 'ms*' | 'iso' | 'iso8601' | 'hr' | 'human_readable'
- `timeInterval` 'hours' | 'days'
- `dailyTime` '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` 'desc' | 'asc'

## Headers

- `Accept-Encoding` string, required
- `api-version` string

## Response `200`

200

- object
  - `status` integer
  - `title` string
  - `description` string
  - `payload` object
    - `metadata` object
      - `timeInterval` string
      - `api-version` string
    - `data` object
      - `assetARCID` string
      - `assetSymbol` string
      - `assetName` string
      - `currency` string
      - `referenceRates` object[]
        - `timestamp` string
        - `unitPrice` number

---

[API](https://skmtc.dev/amberdata/apis/market-api.md) · [All operations](https://skmtc.dev/amberdata/apis/market-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amberdata/market-api/revisions/b377875489a4/schema)