> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messari.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset Timeseries

> Retrieve a specific asset's timeseries data

<Note>
  **x402 Support:** Supported.
  See the [x402 guide](/api-reference/x402-payments#supported-endpoints).
</Note>

## Granularity Parameter

The `granularity` path parameter controls the time interval for each data point:

| Granularity | Description                 | Max Datapoints |
| ----------- | --------------------------- | -------------- |
| `5m`        | 5-minute data points        | 1,440          |
| `1h`        | Hourly data points          | 5,000          |
| `1d`        | Daily data points (default) | 5,000          |
| `1w`        | Weekly data points          | 5,000          |

<Note>
  Not all datasets support all granularities. See the table below for supported granularities by dataset.
</Note>

### Dataset Granularity Support

| Dataset                        | `5m` | `1h` (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`         | ❌    | ❌             | ✅            | ✅             |


## OpenAPI

````yaml GET /metrics/v2/assets/{assetID}/metrics/{datasetSlug}/time-series/{granularity}
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Metrics V2
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /metrics/v2/assets/{assetID}/metrics/{datasetSlug}/time-series/{granularity}:
    get:
      tags:
        - metrics/assets
      summary: Get asset timeseries data
      description: Retrieve a specific asset's timeseries data
      operationId: getAssetTimeseriesWithGranularityV2
      parameters:
        - description: Asset identifier - accepts slugs (e.g. 'bitcoin') or UUIDs
          in: path
          name: assetID
          required: true
          schema:
            type: string
            example: bitcoin
            default: bitcoin
        - description: >-
            Dataset slug identifier. Use /metrics/v2/assets/metrics to see all
            available datasets.
          in: path
          name: datasetSlug
          required: true
          schema:
            type: string
            enum:
              - futures-funding-rate
              - futures-open-interest
              - futures-volume
              - marketcap
              - price
              - sharpe-ratio
              - supply
              - volatility
            default: price
          example: price
        - description: Granularity - time interval for data points
          in: path
          name: granularity
          required: true
          schema:
            enum:
              - 5m
              - 1h
              - 1d
              - 1w
            type: string
            default: 1d
          example: 1d
        - description: Time range start
          in: query
          name: start
          schema:
            type: string
            example: '2025-06-01T00:00:00Z'
            default: '2025-06-01T00:00:00Z'
        - description: Time range end
          in: query
          name: end
          schema:
            type: string
            example: '2025-06-07T00:00:00Z'
            default: '2025-06-07T00:00:00Z'
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/TimeseriesData'
                  error:
                    type: string
                  metadata:
                    $ref: '#/components/schemas/metricsTimeseriesMetadata'
                required:
                  - data
                type: object
              example:
                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
          description: Default response
        '400':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    TimeseriesData:
      properties:
        points:
          items:
            items: {}
            type: array
          type: array
      required:
        - points
      type: object
    metricsTimeseriesMetadata:
      properties:
        granularity:
          enum:
            - 1m
            - 5m
            - 15m
            - 30m
            - 1h
            - 6h
            - 1d
            - 1w
            - 30d
            - 1q
            - 1y
          type: string
        pointSchemas:
          items:
            $ref: '#/components/schemas/metricsPointSchema'
          type: array
      required:
        - granularity
        - pointSchemas
      type: object
    metricsPointSchema:
      type: object
      description: Schema for metricsPointSchema
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````

Built with [Mintlify](https://mintlify.com).