> ## 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 candles (per-bucket deltas)

> Returns per-bucket deltas for a specific trader address (what happened during each bucket).



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/trader/{address}/analytics/deltas
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/deltas:
    get:
      tags:
        - Trader
      summary: Trader analytics candles (per-bucket deltas)
      description: >-
        Returns per-bucket deltas for a specific trader address (what happened
        during each bucket).
      operationId: get_trader_analytics_deltas
      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: Delta time-bucketed trader analytics
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TraderAnalyticsDeltaTimeBucketRow'
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
    TraderAnalyticsDeltaTimeBucketRow:
      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
        - buy_price_cnt_0_10
        - buy_price_cnt_10_20
        - buy_price_cnt_20_30
        - buy_price_cnt_30_40
        - buy_price_cnt_40_50
        - buy_price_cnt_50_60
        - buy_price_cnt_60_70
        - buy_price_cnt_70_80
        - buy_price_cnt_80_90
        - buy_price_cnt_90_100
        - buy_price_vol_0_10
        - buy_price_vol_10_20
        - buy_price_vol_20_30
        - buy_price_vol_30_40
        - buy_price_vol_40_50
        - buy_price_vol_50_60
        - buy_price_vol_60_70
        - buy_price_vol_70_80
        - buy_price_vol_80_90
        - buy_price_vol_90_100
        - sell_price_cnt_0_10
        - sell_price_cnt_10_20
        - sell_price_cnt_20_30
        - sell_price_cnt_30_40
        - sell_price_cnt_40_50
        - sell_price_cnt_50_60
        - sell_price_cnt_60_70
        - sell_price_cnt_70_80
        - sell_price_cnt_80_90
        - sell_price_cnt_90_100
        - sell_price_vol_0_10
        - sell_price_vol_10_20
        - sell_price_vol_20_30
        - sell_price_vol_30_40
        - sell_price_vol_40_50
        - sell_price_vol_50_60
        - sell_price_vol_60_70
        - sell_price_vol_70_80
        - sell_price_vol_80_90
        - sell_price_vol_90_100
      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.
        buy_price_cnt_0_10:
          type: integer
          format: int64
          description: Buy count in the 0-10 cent price bucket.
        buy_price_cnt_10_20:
          type: integer
          format: int64
          description: Buy count in the 10-20 cent price bucket.
        buy_price_cnt_20_30:
          type: integer
          format: int64
          description: Buy count in the 20-30 cent price bucket.
        buy_price_cnt_30_40:
          type: integer
          format: int64
          description: Buy count in the 30-40 cent price bucket.
        buy_price_cnt_40_50:
          type: integer
          format: int64
          description: Buy count in the 40-50 cent price bucket.
        buy_price_cnt_50_60:
          type: integer
          format: int64
          description: Buy count in the 50-60 cent price bucket.
        buy_price_cnt_60_70:
          type: integer
          format: int64
          description: Buy count in the 60-70 cent price bucket.
        buy_price_cnt_70_80:
          type: integer
          format: int64
          description: Buy count in the 70-80 cent price bucket.
        buy_price_cnt_80_90:
          type: integer
          format: int64
          description: Buy count in the 80-90 cent price bucket.
        buy_price_cnt_90_100:
          type: integer
          format: int64
          description: Buy count in the 90-100 cent price bucket.
        buy_price_vol_0_10:
          type: number
          format: double
          description: Buy price vol 0 10.
        buy_price_vol_10_20:
          type: number
          format: double
          description: Buy price vol 10 20.
        buy_price_vol_20_30:
          type: number
          format: double
          description: Buy price vol 20 30.
        buy_price_vol_30_40:
          type: number
          format: double
          description: Buy price vol 30 40.
        buy_price_vol_40_50:
          type: number
          format: double
          description: Buy price vol 40 50.
        buy_price_vol_50_60:
          type: number
          format: double
          description: Buy price vol 50 60.
        buy_price_vol_60_70:
          type: number
          format: double
          description: Buy price vol 60 70.
        buy_price_vol_70_80:
          type: number
          format: double
          description: Buy price vol 70 80.
        buy_price_vol_80_90:
          type: number
          format: double
          description: Buy price vol 80 90.
        buy_price_vol_90_100:
          type: number
          format: double
          description: Buy price vol 90 100.
        sell_price_cnt_0_10:
          type: integer
          format: int64
          description: Sell count in the 0-10 cent price bucket.
        sell_price_cnt_10_20:
          type: integer
          format: int64
          description: Sell count in the 10-20 cent price bucket.
        sell_price_cnt_20_30:
          type: integer
          format: int64
          description: Sell count in the 20-30 cent price bucket.
        sell_price_cnt_30_40:
          type: integer
          format: int64
          description: Sell count in the 30-40 cent price bucket.
        sell_price_cnt_40_50:
          type: integer
          format: int64
          description: Sell count in the 40-50 cent price bucket.
        sell_price_cnt_50_60:
          type: integer
          format: int64
          description: Sell count in the 50-60 cent price bucket.
        sell_price_cnt_60_70:
          type: integer
          format: int64
          description: Sell count in the 60-70 cent price bucket.
        sell_price_cnt_70_80:
          type: integer
          format: int64
          description: Sell count in the 70-80 cent price bucket.
        sell_price_cnt_80_90:
          type: integer
          format: int64
          description: Sell count in the 80-90 cent price bucket.
        sell_price_cnt_90_100:
          type: integer
          format: int64
          description: Sell count in the 90-100 cent price bucket.
        sell_price_vol_0_10:
          type: number
          format: double
          description: Sell price vol 0 10.
        sell_price_vol_10_20:
          type: number
          format: double
          description: Sell price vol 10 20.
        sell_price_vol_20_30:
          type: number
          format: double
          description: Sell price vol 20 30.
        sell_price_vol_30_40:
          type: number
          format: double
          description: Sell price vol 30 40.
        sell_price_vol_40_50:
          type: number
          format: double
          description: Sell price vol 40 50.
        sell_price_vol_50_60:
          type: number
          format: double
          description: Sell price vol 50 60.
        sell_price_vol_60_70:
          type: number
          format: double
          description: Sell price vol 60 70.
        sell_price_vol_70_80:
          type: number
          format: double
          description: Sell price vol 70 80.
        sell_price_vol_80_90:
          type: number
          format: double
          description: Sell price vol 80 90.
        sell_price_vol_90_100:
          type: number
          format: double
          description: Sell price vol 90 100.

````