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

# Exchange Time Series Metric

> Retrieve a specific exchange's timeseries data

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


## OpenAPI

````yaml GET /metrics/v1/exchanges/{entityIdentifier}/metrics/{datasetSlug}/time-series/{granularity}
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Metrics V1
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /metrics/v1/exchanges/{entityIdentifier}/metrics/{datasetSlug}/time-series/{granularity}:
    get:
      tags:
        - metrics/exchanges
      summary: Get exchange timeseries data
      description: Retrieve a specific exchange's timeseries data
      operationId: getExchangeTimeseriesWithGranularity
      parameters:
        - description: Entity ID or slug
          in: path
          name: entityIdentifier
          required: true
          schema:
            type: string
            example: binance
            default: binance
        - description: Dataset slug
          in: path
          name: datasetSlug
          required: true
          schema:
            type: string
            enum:
              - volume
              - futures-volume
              - futures-open-interest
            example: volume
            default: volume
        - 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
                      - 42522347
                      - 9216853399.631496
                    - - 1748822400
                      - 49639718
                      - 13496478083.937649
                    - - 1748908800
                      - 49929928
                      - 14503394750.363638
                    - - 1748995200
                      - 42680039
                      - 13154648940.668606
                    - - 1749081600
                      - 62562278
                      - 21404240391.30481
                metadata:
                  pointSchemas:
                    - name: Timestamp
                      slug: time
                      description: Timestamp of the data point.
                      is_timestamp: true
                    - name: Trade Count
                      slug: trade-count
                      description: Trade count during the candle.
                      is_timestamp: false
                    - name: Volume
                      slug: volume
                      description: Volume traded during candle.
                      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).