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

# Trader analytics timeseries (cumulative)

> Returns cumulative analytics values for a specific trader address at the end of each bucket.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/trader/{address}/analytics/timeseries
openapi: 3.1.0
info:
  title: Polymarket API
  description: >-
    RESTful API for querying Polymarket prediction markets data including
    events, markets, traders, holders, and real-time metrics
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.struct.to/v1
security: []
paths:
  /polymarket/trader/{address}/analytics/timeseries:
    get:
      tags:
        - Trader
      summary: Trader analytics timeseries (cumulative)
      description: >-
        Returns cumulative analytics values for a specific trader address at the
        end of each bucket.
      operationId: get_trader_analytics_timeseries
      parameters:
        - name: address
          in: path
          description: Trader wallet address
          required: true
          schema:
            type: string
        - name: resolution
          in: query
          description: 'Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60)'
          required: false
          schema:
            $ref: '#/components/schemas/AnalyticsResolution'
        - name: from
          in: query
          description: Start timestamp (Unix seconds)
          required: false
          schema:
            type: integer
            format: int64
        - name: to
          in: query
          description: End timestamp (Unix seconds)
          required: false
          schema:
            type: integer
            format: int64
        - name: count_back
          in: query
          description: 'Max data points (default: 500, max: 2500)'
          required: false
          schema:
            type: integer
            format: int32
        - name: pagination_key
          in: query
          description: Cursor from previous response
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Cumulative time-bucketed trader analytics
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TraderAnalyticsTimeBucketRow'
components:
  schemas:
    AnalyticsResolution:
      type: string
      description: >-
        Bucket size for `/analytics/timeseries` and `/analytics/deltas`
        responses.

        Each value picks the time interval that one row in the output covers:

        `60` = 1 hour, `240` = 4 hours, `D`/`1D` = 1 day, `W`/`1W` = 7 days,

        `M`/`1M` = calendar month.
      enum:
        - '60'
        - '240'
        - D
        - 1D
        - W
        - 1W
        - M
        - 1M
    TraderAnalyticsTimeBucketRow:
      type: object
      required:
        - t
        - v
        - bv
        - sv
        - tc
        - bc
        - sc
        - rc
        - rv
        - mc
        - mv
        - sp
        - spv
        - cc
        - ccu
        - csg
        - csl
        - mrc
        - mrv
        - rwc
        - rwv
        - ydc
        - ydv
        - f
        - sh
        - bsh
        - ssh
        - ysh
        - nsh
        - yv
        - nv
        - yc
        - nc
        - bd_u10
        - bd_100
        - bd_1k
        - bd_10k
        - bd_50k
        - bd_50p
      properties:
        t:
          type: integer
          format: int32
          description: Bucket start time as Unix seconds.
          minimum: 0
        v:
          type: number
          format: double
          description: Volume in USD.
        bv:
          type: number
          format: double
          description: Buy volume in USD.
        sv:
          type: number
          format: double
          description: Sell volume in USD.
        tc:
          type: integer
          format: int64
          description: Transaction count.
        bc:
          type: integer
          format: int64
          description: Buy count.
        sc:
          type: integer
          format: int64
          description: Sell count.
        rc:
          type: integer
          format: int64
          description: Redemption count.
        rv:
          type: number
          format: double
          description: Redemption volume in USD.
        mc:
          type: integer
          format: int64
          description: Merge count.
        mv:
          type: number
          format: double
          description: Merge volume in USD.
        sp:
          type: integer
          format: int64
          description: Split count.
        spv:
          type: number
          format: double
          description: Split volume in USD.
        cc:
          type: integer
          format: int64
          description: Converted count.
        ccu:
          type: number
          format: double
          description: Converted collateral in USD.
        csg:
          type: number
          format: double
          description: Converted shares gained.
        csl:
          type: number
          format: double
          description: Converted shares lost.
        mrc:
          type: integer
          format: int64
          description: Maker rebate count.
        mrv:
          type: number
          format: double
          description: Maker rebate volume in USD.
        rwc:
          type: integer
          format: int64
          description: Reward count.
        rwv:
          type: number
          format: double
          description: Reward volume in USD.
        ydc:
          type: integer
          format: int64
          description: Yield count.
        ydv:
          type: number
          format: double
          description: Yield volume in USD.
        f:
          type: number
          format: double
          description: Fees in USD.
        sh:
          type: number
          format: double
          description: Shares volume.
        bsh:
          type: number
          format: double
          description: Buy shares volume.
        ssh:
          type: number
          format: double
          description: Sell shares volume.
        ysh:
          type: number
          format: double
          description: Yes shares volume.
        nsh:
          type: number
          format: double
          description: No shares volume.
        yv:
          type: number
          format: double
          description: Yes volume in USD.
        nv:
          type: number
          format: double
          description: No volume in USD.
        yc:
          type: integer
          format: int64
          description: Yes count.
        nc:
          type: integer
          format: int64
          description: No count.
        bd_u10:
          type: integer
          format: int64
          description: Buy trade count in the under-10 USD bucket.
        bd_100:
          type: integer
          format: int64
          description: Buy trade count in the 10-100 USD bucket.
        bd_1k:
          type: integer
          format: int64
          description: Buy trade count in the 100-1k USD bucket.
        bd_10k:
          type: integer
          format: int64
          description: Buy trade count in the 1k-10k USD bucket.
        bd_50k:
          type: integer
          format: int64
          description: Buy trade count in the 10k-50k USD bucket.
        bd_50p:
          type: integer
          format: int64
          description: Buy trade count in the 50k-plus USD bucket.

````