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

# Get TCG Platform Time Series

> Returns one TCG platform's history, one series per chain it runs on. Nothing is aggregated across a platform's chains: the daily-active-user and unique-buyer counts overlap between chains, so a cross-chain total would overstate them. Every series carries its platform and chain alongside the composite id, so no consumer has to split the id. Only the 1d granularity is available. A platform slug the TCG listing does not serve returns 404.



## OpenAPI

````yaml GET /metrics/v2/protocols/tcg/{platformIdentifier}/metrics/overview/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/protocols/tcg/{platformIdentifier}/metrics/overview/time-series/{granularity}:
    get:
      tags:
        - metrics/protocols/tcg
      summary: Get TCG Platform Time Series
      description: >-
        Returns one TCG platform's history, one series per chain it runs on.
        Nothing is aggregated across a platform's chains: the daily-active-user
        and unique-buyer counts overlap between chains, so a cross-chain total
        would overstate them. Every series carries its platform and chain
        alongside the composite id, so no consumer has to split the id. Only the
        1d granularity is available. A platform slug the TCG listing does not
        serve returns 404.
      operationId: getTCGPlatformTimeSeriesWithGranularityV2
      parameters:
        - description: >-
            Blockworks Research platform slug, as returned in the id field of
            the TCG platform listing.
          in: path
          name: platformIdentifier
          required: true
          schema:
            type: string
            example: courtyard
        - description: Granularity
          in: path
          name: granularity
          required: true
          schema:
            enum:
              - 1d
            type: string
            example: 1d
            default: 1d
        - description: Time range start
          in: query
          name: start
          schema:
            type: string
            example: '2026-08-01T00:00:00Z'
        - description: Time range end
          in: query
          name: end
          schema:
            type: string
            example: '2026-08-21T00:00:00Z'
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/TCGSeriesData'
                  error:
                    type: string
                  metadata:
                    $ref: '#/components/schemas/TCGSeriesMetadata'
                required:
                  - data
                type: object
              example:
                error: null
                data:
                  series:
                    - id: courtyard_polygon
                      platform: courtyard
                      chain: polygon
                      points:
                        - - 1785542400
                          - 5019686.24
                          - 1043157.63
                          - 0
                          - 3976528.61
                          - null
                          - 5206374.79
                          - 9182903.4
                          - 5020356.24
                          - 1616203.1600000001
                          - 7507
                          - 8157
                          - 15664
                          - 186688.55
                          - 186688.55
                          - 0
                          - 3248
                          - 751
                          - 6600
                          - null
                          - 145724
                          - 8423839.32
                        - - 1785628800
                          - 3996765.92
                          - 804410.55
                          - 0
                          - 3192355.37
                          - null
                          - 4160657.81
                          - 7353013.18
                          - 3996902.92
                          - 1316540.4100000001
                          - 7965
                          - 5942
                          - 13907
                          - 163891.89
                          - 163891.89
                          - 0
                          - 3226
                          - 727
                          - null
                          - null
                          - 125453.99999999999
                          - 6677128.43
                        - - 1785715200
                          - 4120334.81
                          - 917821.64
                          - 0
                          - 3202513.17
                          - null
                          - 4324841.69
                          - 7527354.86
                          - 4120384.81
                          - 1217061.35
                          - 9611
                          - 5588
                          - 15199
                          - 204506.88
                          - 204506.88
                          - 0
                          - 2695
                          - 670
                          - 11500
                          - null
                          - 122811.99999999999
                          - 7023658.27
                        - - 1785801600
                          - 3997818.01
                          - 807187.42
                          - 0
                          - 3190630.59
                          - null
                          - 4190233.36
                          - 7380863.949999999
                          - 3997853.01
                          - 1137967.6399999997
                          - 11246
                          - 5724
                          - 16970
                          - 192415.35
                          - 192415.35
                          - 0
                          - 2726
                          - 619
                          - 21500
                          - null
                          - 122454
                          - 6857703.38
                        - - 1785888000
                          - 4079926.22
                          - 930139.43
                          - 0
                          - 3149786.79
                          - null
                          - 4287724
                          - 7437510.79
                          - 4080420.22
                          - 1234427.62
                          - 5274
                          - 5329
                          - 10603
                          - 207797.78
                          - 207797.78
                          - 0
                          - 2512
                          - 653
                          - 19000
                          - null
                          - 108045.99999999999
                          - 6925918.82
                metadata:
                  pointSchemas:
                    - name: Timestamp
                      slug: time
                      description: Timestamp of the data point.
                      is_timestamp: true
                    - name: Gross Revenue USD
                      slug: grossRevenueUsd
                      description: >-
                        Gross platform revenue in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Net Revenue USD
                      slug: netRevenueUsd
                      description: >-
                        Net platform revenue in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Misc Revenue USD
                      slug: miscRevenueUsd
                      description: >-
                        Miscellaneous revenue in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Buyback Expense USD
                      slug: buybackExpenseUsd
                      description: >-
                        Card buyback expense in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Referral Expense USD
                      slug: referralExpenseUsd
                      description: >-
                        Referral expense in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: GMV USD
                      slug: gmvUsd
                      description: >-
                        Gross merchandise value in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Volume incl. Buybacks USD
                      slug: volumeInclBuybackUsd
                      description: >-
                        Volume including platform buybacks in USD. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Gacha Spend USD
                      slug: gachaSpendUsd
                      description: >-
                        Net gacha (pack-opening) spend in USD. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Credit Card Spend USD
                      slug: creditCardSpendUsd
                      description: >-
                        Credit-card spend in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: New DAU
                      slug: dauNew
                      description: >-
                        New daily active users. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Recurring DAU
                      slug: dauRecurring
                      description: >-
                        Recurring daily active users. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Total DAU
                      slug: dauTotal
                      description: >-
                        Total daily active users. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Marketplace Volume USD
                      slug: marketplaceVolumeUsd
                      description: >-
                        Secondary-marketplace volume in USD. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Organic Volume USD
                      slug: organicVolumeUsd
                      description: >-
                        Marketplace volume excluding buybacks in USD. Sourced
                        from Blockworks Research.
                      is_timestamp: false
                    - name: Buyback Volume USD
                      slug: buybackVolumeUsd
                      description: >-
                        Marketplace buyback volume in USD. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Sales Count
                      slug: salesCount
                      description: >-
                        Marketplace sales count. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Unique Buyers
                      slug: uniqueBuyers
                      description: >-
                        Unique marketplace buyers. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Top Sale USD
                      slug: topSaleUsd
                      description: >-
                        Largest single sale of the day in USD. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Marketplace Fees USD
                      slug: marketplaceFeesUsd
                      description: >-
                        Marketplace fees in USD. Sourced from Blockworks
                        Research.
                      is_timestamp: false
                    - name: Packs Opened
                      slug: packsOpened
                      description: >-
                        Gacha packs opened, summed across tiers. Sourced from
                        Blockworks Research.
                      is_timestamp: false
                    - name: Gross Gacha Spend USD
                      slug: grossGachaSpendUsd
                      description: >-
                        Gross gacha spend, summed across tiers, in USD. Sourced
                        from Blockworks Research.
                      is_timestamp: false
                  granularity: 1d
                  seriesCount: 1
          description: OK
        '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
        '404':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    TCGSeriesData:
      type: object
      properties:
        series:
          type: array
          items:
            $ref: '#/components/schemas/TCGSeriesEntry'
      required:
        - series
    TCGSeriesMetadata:
      type: object
      description: One shared pointSchemas array covers every series in the response.
      properties:
        pointSchemas:
          type: array
          items:
            $ref: '#/components/schemas/metricsPointSchema'
          description: >-
            One entry per column of a point, in point order. The first is always
            the timestamp.
        granularity:
          type: string
        seriesCount:
          format: int64
          type: integer
          description: Number of series in the response.
      required:
        - pointSchemas
        - granularity
        - seriesCount
    TCGSeriesEntry:
      type: object
      description: One platform-chain time series.
      properties:
        id:
          type: string
          description: >-
            Composite series key of platform and chain (for example
            courtyard_polygon). It matches the id of the corresponding entry in
            the platform listing's chains array.
        platform:
          type: string
          description: >-
            Blockworks Research platform slug, served alongside the composite id
            so it never has to be parsed out of it.
        chain:
          type: string
          description: >-
            Blockworks Research chain slug, served alongside the composite id so
            it never has to be parsed out of it.
        points:
          type: array
          items:
            items: {}
            type: array
          description: >-
            Rows of values, in the order metadata.pointSchemas declares. Empty
            where the platform-chain pair has no data in the window.
      required:
        - id
        - platform
        - chain
        - points
    metricsPointSchema:
      type: object
      description: Schema for metricsPointSchema
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````