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

# Stablecoin Timeseries Metric

> Retrieve a specific stablecoin's timeseries data

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


## OpenAPI

````yaml GET /metrics/v2/stablecoins/{entityIdentifier}/metrics/{datasetSlug}/time-series
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/stablecoins/{entityIdentifier}/metrics/{datasetSlug}/time-series:
    get:
      tags:
        - metrics/stablecoins
      summary: Get stablecoin timeseries data
      description: Retrieve a specific stablecoin's timeseries data
      operationId: getStablecoinTimeseriesV2
      parameters:
        - description: Entity ID or slug
          in: path
          name: entityIdentifier
          required: true
          schema:
            type: string
            example: tether
            default: tether
        - description: Dataset slug
          in: path
          name: datasetSlug
          required: true
          schema:
            type: string
            enum:
              - network-breakdown
              - supply
              - transfers
            example: supply
            default: supply
        - 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:
                    - - 1674864000
                      - 68500978293.758316
                      - null
                      - null
                    - - 1674950400
                      - 68512350446.7849
                      - null
                      - null
                    - - 1675036800
                      - 68490420842.94022
                      - null
                      - null
                    - - 1675123200
                      - 68473605079.801216
                      - null
                      - null
                    - - 1675209600
                      - 68493868332.42586
                      - null
                      - null
                metadata:
                  pointSchemas:
                    - name: Timestamp
                      slug: time
                      description: Timestamp of the data point.
                      is_timestamp: true
                    - name: Outstanding Supply USD
                      slug: outstandingSupplyUsd
                      description: >-
                        The total outstanding supply in USD for this stablecoin
                        on a given interval.
                      is_timestamp: false
                    - name: Mints 24 Hour USD
                      slug: mints24HourUsd
                      description: The total value of new stablecoins minted in USD.
                      is_timestamp: false
                    - name: Burns 24 Hour USD
                      slug: stablecoin-redemptions-usd
                      description: The total value of stablecoins redeemed in USD.
                      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).