Skip to main content
GET
/
metrics
/
v2
/
assets
/
{assetID}
/
metrics
/
{datasetSlug}
/
time-series
/
{granularity}
Get asset timeseries data
curl --request GET \
  --url https://api.messari.io/metrics/v2/assets/{assetID}/metrics/{datasetSlug}/time-series/{granularity} \
  --header 'X-Messari-API-Key: <api-key>'
{
  "error": null,
  "data": {
    "points": [
      [
        1748736000,
        104729.2072916125,
        105927.26807578972,
        103720.19999058776,
        105656.22864515736
      ],
      [
        1748822400,
        105658.92299858449,
        105992.1273801626,
        103735.46779448254,
        105898.90983196444
      ],
      [
        1748908800,
        105896.38739709451,
        106790.13927085044,
        104918.11817101362,
        105402.4445014
      ],
      [
        1748995200,
        105407.80668470112,
        105996.44497344238,
        104319.0466004516,
        104737.29919383606
      ],
      [
        1749081600,
        104746.64834316898,
        105976.08059532435,
        100559.43093223224,
        101613.17147431568
      ]
    ]
  },
  "metadata": {
    "pointSchemas": [
      {
        "name": "Timestamp",
        "slug": "time",
        "description": "Timestamp of the data point.",
        "is_timestamp": true
      },
      {
        "name": "Open Price",
        "slug": "open",
        "description": "Price at the candle open.",
        "is_timestamp": false
      },
      {
        "name": "High Price",
        "slug": "high",
        "description": "High price during the candle.",
        "is_timestamp": false
      },
      {
        "name": "Low Price",
        "slug": "low",
        "description": "Low price during the candle.",
        "is_timestamp": false
      },
      {
        "name": "Close Price",
        "slug": "close",
        "description": "Price at the candle close.",
        "is_timestamp": false
      }
    ],
    "granularity": "1d"
  }
}

Granularity Parameter

The granularity path parameter controls the time interval for each data point:
GranularityDescription
1dDaily data points (default)
1hHourly data points
Not all datasets support all granularities. See the table below for supported granularities by dataset.

Dataset Granularity Support

Dataset1d (Daily)1h (Hourly)
price
futures-funding-rate
futures-open-interest
futures-volume
marketcap
supply
volatility
sharpe-ratio

Authorizations

X-Messari-API-Key
string
header
required

Path Parameters

assetID
string
default:bitcoin
required

Asset identifier - accepts slugs (e.g. 'bitcoin') or UUIDs

Example:

"bitcoin"

datasetSlug
enum<string>
default:price
required

Dataset slug identifier. Use /metrics/v2/assets/metrics to see all available datasets.

Available options:
futures-funding-rate,
futures-open-interest,
futures-volume,
marketcap,
price,
sharpe-ratio,
supply,
volatility
granularity
enum<string>
default:1d
required

Granularity - time interval for data points

Available options:
1d,
1h

Query Parameters

start
string
default:2025-06-01T00:00:00Z

Time range start

Example:

"2025-06-01T00:00:00Z"

end
string
default:2025-06-07T00:00:00Z

Time range end

Example:

"2025-06-07T00:00:00Z"

Response

Default response

data
object
required
error
string
metadata
object