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"
  }
}
x402 Support: Supported. See the x402 guide.

Granularity Parameter

The granularity path parameter controls the time interval for each data point:
GranularityDescriptionMax Datapoints
5m5-minute data points1,440
1hHourly data points5,000
1dDaily data points (default)5,000
1wWeekly data points5,000
Not all datasets support all granularities. See the table below for supported granularities by dataset.

Dataset Granularity Support

Dataset5m1h (Hourly)1d (Daily)1w (Weekly)
price
futures-funding-rate
futures-open-interest
futures-volume
marketcap
supply
volatility
sharpe-ratio
stablecoin-network-breakdown
stablecoin-supply
stablecoin-transfers

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:
5m,
1h,
1d,
1w

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