> ## 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.

# Assets Time Series with Granularity

> Retrieve assets timeseries data

<Note>
  **x402 Support:** Supported (conditions apply).
  **Conditions:** x402 is available only when `granularity` is one of `1h`, `1d`.
  See the [x402 guide](/api-reference/x402-payments#supported-endpoints).
</Note>


## OpenAPI

````yaml GET /signal/v1/assets/time-series/{granularity}
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Signal V1
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /signal/v1/assets/time-series/{granularity}:
    get:
      tags:
        - Assets
      summary: Get Assets timeseries data
      description: Retrieve assets timeseries data
      operationId: getAssetsTimeSeriesWithGranularityV1
      parameters:
        - in: path
          name: granularity
          required: true
          description: >-
            Time interval for data aggregation. Valid values: 1h (hourly), 6h
            (6-hour), 1d (daily)
          schema:
            type: string
            enum:
              - 1h
              - 6h
              - 1d
            example: 1d
            default: 1d
        - description: Time range start. Encoded as RFC3339 or unix timestamp.
          in: query
          name: start
          schema:
            type: string
            example: '2025-06-01T00:00:00Z'
            default: '2025-06-01T00:00:00Z'
        - description: Time range end. Encoded as RFC3339 or unix timestamp.
          in: query
          name: end
          schema:
            type: string
            example: '2025-06-07T00:00:00Z'
            default: '2025-06-07T00:00:00Z'
        - description: Asset slug or ID
          in: query
          name: assetIDs
          required: true
          schema:
            type: string
            example: bitcoin,ethereum
            default: bitcoin,ethereum
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/AssetsTimeseries'
                    type: array
                  error:
                    type: string
                required:
                  - data
                type: object
              example:
                error: null
                data:
                  - id: 1e31218a-e44e-4285-820c-8282ee222035
                    name: Bitcoin
                    symbol: BTC
                    slug: bitcoin
                    points:
                      - time: 1748736000
                        mindshare:
                          rank: 1
                          percentage: 19.1125
                        sentiment:
                          score: 0.3207830721713327
                        postMetrics:
                          totalPosts: 974
                          uniqueAuthorsMentioning: 685
                        marketdata:
                          open: 104729.2072916125
                          high: 105927.26807578972
                          low: 103720.19999058776
                          close: 105656.22864515736
                          volume: 13350705564.05455
                      - time: 1748822400
                        mindshare:
                          rank: 1
                          percentage: 18.3274
                        sentiment:
                          score: 0.37748573901554394
                        postMetrics:
                          totalPosts: 1643
                          uniqueAuthorsMentioning: 1114
                        marketdata:
                          open: 105658.92299858449
                          high: 105992.1273801626
                          low: 103735.46779448254
                          close: 105898.90983196444
                          volume: 20101327463.116177
                      - time: 1748908800
                        mindshare:
                          rank: 1
                          percentage: 13.4945
                        sentiment:
                          score: 0.4366622629949052
                        postMetrics:
                          totalPosts: 1600
                          uniqueAuthorsMentioning: 1127
                        marketdata:
                          open: 105896.38739709451
                          high: 106790.13927085044
                          low: 104918.11817101362
                          close: 105402.4445014
                          volume: 20023603325.901714
                      - time: 1748995200
                        mindshare:
                          rank: 1
                          percentage: 15.5965
                        sentiment:
                          score: 0.48475310148799805
                        postMetrics:
                          totalPosts: 1568
                          uniqueAuthorsMentioning: 1071
                        marketdata:
                          open: 105407.80668470112
                          high: 105996.44497344238
                          low: 104319.0466004516
                          close: 104737.29919383606
                          volume: 20006693677.200764
                      - time: 1749081600
                        mindshare:
                          rank: 1
                          percentage: 14.6271
                        sentiment:
                          score: 0.5182863834715838
                        postMetrics:
                          totalPosts: 1666
                          uniqueAuthorsMentioning: 1228
                        marketdata:
                          open: 104746.64834316898
                          high: 105976.08059532435
                          low: 100559.43093223224
                          close: 101613.17147431568
                          volume: 29218094244.512634
                  - id: b3d5d66c-26a2-404c-9325-91dc714a722b
                    name: Solana
                    symbol: SOL
                    slug: solana
                    points:
                      - time: 1748736000
                        mindshare:
                          rank: 2
                          percentage: 10.0092
                        sentiment:
                          score: -0.03461334291217839
                        postMetrics:
                          totalPosts: 410
                          uniqueAuthorsMentioning: 565
                        marketdata:
                          open: 156.65720556471376
                          high: 157.95169730236628
                          low: 150.76260443759077
                          close: 157.77181618322436
                          volume: 2144608892.8862765
                      - time: 1748822400
                        mindshare:
                          rank: 2
                          percentage: 6.7913
                        sentiment:
                          score: 0.03131817141509089
                        postMetrics:
                          totalPosts: 596
                          uniqueAuthorsMentioning: 768
                        marketdata:
                          open: 157.7479133259331
                          high: 158.9518257897343
                          low: 151.95602996691338
                          close: 156.89883311408937
                          volume: 2609227017.7750635
                      - time: 1748908800
                        mindshare:
                          rank: 2
                          percentage: 10.6574
                        sentiment:
                          score: 0.13493558470300374
                        postMetrics:
                          totalPosts: 833
                          uniqueAuthorsMentioning: 1022
                        marketdata:
                          open: 156.79268148052748
                          high: 163.44556535824057
                          low: 154.67317463900963
                          close: 155.24692361322457
                          volume: 3244294455.2046504
                      - time: 1748995200
                        mindshare:
                          rank: 2
                          percentage: 7.1962
                        sentiment:
                          score: 0.18762102716070037
                        postMetrics:
                          totalPosts: 754
                          uniqueAuthorsMentioning: 888
                        marketdata:
                          open: 155.28649899351672
                          high: 158.0966026628009
                          low: 153.06057238465831
                          close: 153.22127665387393
                          volume: 2304615162.98485
                      - time: 1749081600
                        mindshare:
                          rank: 3
                          percentage: 6.1777
                        sentiment:
                          score: 0.16780418663290209
                        postMetrics:
                          totalPosts: 592
                          uniqueAuthorsMentioning: 778
                        marketdata:
                          open: 153.28480876772798
                          high: 154.56285343674813
                          low: 141.91427452832266
                          close: 144.41339579782078
                          volume: 4031866965.645295
          description: Default response
        '400':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Forbidden
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    AssetsTimeseries:
      properties:
        id:
          type: string
        name:
          type: string
        points:
          items:
            $ref: '#/components/schemas/AssetPointResponse'
          type: array
        slug:
          type: string
        symbol:
          type: string
      required:
        - id
        - name
        - points
        - slug
        - symbol
      type: object
    AssetPointResponse:
      type: object
      description: Schema for AssetPointResponse
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````

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