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

# Global combo analytics timeseries (cumulative)

> Returns cumulative combo metrics at the end of each bucket. Use for running-total line charts of global combo volume, fees, and lifecycle activity over time.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/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/combos/analytics/timeseries:
    get:
      tags:
        - Combos
      summary: Global combo analytics timeseries (cumulative)
      description: >-
        Returns cumulative combo metrics at the end of each bucket. Use for
        running-total line charts of global combo volume, fees, and lifecycle
        activity over time.
      operationId: get_combo_analytics_timeseries
      parameters:
        - 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). Omit for all-time.
          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 for next page
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Cumulative time-bucketed combo analytics
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ComboGlobalAnalyticsBucketRow'
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
    ComboGlobalAnalyticsBucketRow:
      type: object
      description: |-
        Bucket row for `GET /polymarket/combos/analytics/timeseries`: running
        lifetime totals as of the end of each bucket.
      required:
        - t
        - v
        - bv
        - sv
        - sh
        - bsh
        - ssh
        - f
        - bf
        - buv
        - bubv
        - busv
        - bsv
        - bsbv
        - bssv
        - tc
        - bc
        - sc
        - btc
        - bbc
        - bsc
        - cre
        - exe
        - su
        - ps
        - pm
        - soc
        - moc
        - ext
        - inj
        - ctyb
        - mfyb
        - cmp
        - red
        - wr
        - uw
        - hs
        - hm
        - pc
        - mig
        - yv
        - ysh
        - ybsh
        - yssh
        - nv
        - nsh
        - l2t
        - l2v
        - l3t
        - l3v
        - l4t
        - l4v
        - l5t
        - l5v
        - epw
        - scu
        - mcu
        - rpu
        - ccu
        - ccr
        - cry
        - crn
        - nct
        - nbct
      properties:
        t:
          type: integer
          format: int32
          description: 'Full field: `bucket`. Bucket start time as Unix seconds.'
          minimum: 0
        v:
          type: number
          format: double
          description: >-
            Full field: `usd_volume`. Cumulative USD volume across combo fills
            (buys + sells).
        bv:
          type: number
          format: double
          description: 'Full field: `usd_buy_volume`. Cumulative USD buy volume.'
        sv:
          type: number
          format: double
          description: 'Full field: `usd_sell_volume`. Cumulative USD sell volume.'
        sh:
          type: number
          format: double
          description: >-
            Full field: `shares_volume`. Cumulative combo shares volume (buys +
            sells).
        bsh:
          type: number
          format: double
          description: 'Full field: `shares_buy_volume`. Cumulative combo shares buy volume.'
        ssh:
          type: number
          format: double
          description: >-
            Full field: `shares_sell_volume`. Cumulative combo shares sell
            volume.
        f:
          type: number
          format: double
          description: 'Full field: `fees`. Cumulative fees in USD.'
        bf:
          type: number
          format: double
          description: 'Full field: `builder_fees`. Cumulative builder fees in USD.'
        buv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_volume`. Cumulative USD volume on
            builder-attributed fills.
        bubv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_buy_volume`. Cumulative builder USD buy
            volume.
        busv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_sell_volume`. Cumulative builder USD sell
            volume.
        bsv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_volume`. Cumulative builder combo shares
            volume.
        bsbv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_buy_volume`. Cumulative builder combo
            shares buy volume.
        bssv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_sell_volume`. Cumulative builder combo
            shares sell volume.
        tc:
          type: integer
          format: int64
          description: 'Full field: `txns`. Cumulative combo fill transaction count.'
          minimum: 0
        bc:
          type: integer
          format: int64
          description: 'Full field: `buys`. Cumulative combo buy fill count.'
          minimum: 0
        sc:
          type: integer
          format: int64
          description: 'Full field: `sells`. Cumulative combo sell fill count.'
          minimum: 0
        btc:
          type: integer
          format: int64
          description: >-
            Full field: `builder_txns`. Cumulative builder combo fill
            transaction count.
          minimum: 0
        bbc:
          type: integer
          format: int64
          description: 'Full field: `builder_buys`. Cumulative builder combo buy fill count.'
          minimum: 0
        bsc:
          type: integer
          format: int64
          description: >-
            Full field: `builder_sells`. Cumulative builder combo sell fill
            count.
          minimum: 0
        cre:
          type: integer
          format: int64
          description: 'Full field: `creations`. Cumulative combo market creations.'
          minimum: 0
        exe:
          type: integer
          format: int64
          description: 'Full field: `executions`. Cumulative combo executions.'
          minimum: 0
        su:
          type: integer
          format: int64
          description: 'Full field: `status_updates`. Cumulative combo status updates.'
          minimum: 0
        ps:
          type: integer
          format: int64
          description: >-
            Full field: `positions_split`. Cumulative positions-split lifecycle
            operations.
          minimum: 0
        pm:
          type: integer
          format: int64
          description: >-
            Full field: `positions_merged`. Cumulative positions-merged
            lifecycle operations.
          minimum: 0
        soc:
          type: integer
          format: int64
          description: >-
            Full field: `split_on_condition`. Cumulative split-on-condition
            lifecycle operations.
          minimum: 0
        moc:
          type: integer
          format: int64
          description: >-
            Full field: `merged_on_condition`. Cumulative merge-on-condition
            lifecycle operations.
          minimum: 0
        ext:
          type: integer
          format: int64
          description: 'Full field: `extracted`. Cumulative extract lifecycle operations.'
          minimum: 0
        inj:
          type: integer
          format: int64
          description: 'Full field: `injected`. Cumulative inject lifecycle operations.'
          minimum: 0
        ctyb:
          type: integer
          format: int64
          description: >-
            Full field: `converted_to_yes_basket`. Cumulative
            convert-to-YES-basket lifecycle operations.
          minimum: 0
        mfyb:
          type: integer
          format: int64
          description: >-
            Full field: `merged_from_yes_basket`. Cumulative
            merge-from-YES-basket lifecycle operations.
          minimum: 0
        cmp:
          type: integer
          format: int64
          description: 'Full field: `compressed`. Cumulative compress lifecycle operations.'
          minimum: 0
        red:
          type: integer
          format: int64
          description: 'Full field: `redeemed`. Cumulative redemption lifecycle operations.'
          minimum: 0
        wr:
          type: integer
          format: int64
          description: 'Full field: `wrapped`. Cumulative wrap lifecycle operations.'
          minimum: 0
        uw:
          type: integer
          format: int64
          description: 'Full field: `unwrapped`. Cumulative unwrap lifecycle operations.'
          minimum: 0
        hs:
          type: integer
          format: int64
          description: >-
            Full field: `horizontal_split`. Cumulative horizontal-split
            lifecycle operations.
          minimum: 0
        hm:
          type: integer
          format: int64
          description: >-
            Full field: `horizontal_merge`. Cumulative horizontal-merge
            lifecycle operations.
          minimum: 0
        pc:
          type: integer
          format: int64
          description: >-
            Full field: `position_converted`. Cumulative position-converted
            lifecycle operations.
          minimum: 0
        mig:
          type: integer
          format: int64
          description: 'Full field: `migrated`. Cumulative migrate lifecycle operations.'
          minimum: 0
        yv:
          type: number
          format: double
          description: 'Full field: `yes_usd_volume`. Cumulative USD volume on the YES side.'
        ysh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_volume`. Cumulative YES shares volume (buys
            + sells).
        ybsh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_buy_volume`. Cumulative YES shares buy
            volume.
        yssh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_sell_volume`. Cumulative YES shares sell
            volume.
        nv:
          type: number
          format: double
          description: 'Full field: `no_usd_volume`. Cumulative USD volume on the NO side.'
        nsh:
          type: number
          format: double
          description: 'Full field: `no_shares_volume`. Cumulative NO shares volume.'
        l2t:
          type: integer
          format: int64
          description: 'Full field: `legs_2_txns`. Cumulative fill count on 2-leg combos.'
          minimum: 0
        l2v:
          type: number
          format: double
          description: >-
            Full field: `legs_2_usd_volume`. Cumulative USD volume on 2-leg
            combos.
        l3t:
          type: integer
          format: int64
          description: 'Full field: `legs_3_txns`. Cumulative fill count on 3-leg combos.'
          minimum: 0
        l3v:
          type: number
          format: double
          description: >-
            Full field: `legs_3_usd_volume`. Cumulative USD volume on 3-leg
            combos.
        l4t:
          type: integer
          format: int64
          description: 'Full field: `legs_4_txns`. Cumulative fill count on 4-leg combos.'
          minimum: 0
        l4v:
          type: number
          format: double
          description: >-
            Full field: `legs_4_usd_volume`. Cumulative USD volume on 4-leg
            combos.
        l5t:
          type: integer
          format: int64
          description: >-
            Full field: `legs_5_plus_txns`. Cumulative fill count on combos with
            5+ legs.
          minimum: 0
        l5v:
          type: number
          format: double
          description: >-
            Full field: `legs_5_plus_usd_volume`. Cumulative USD volume on
            combos with 5+ legs.
        epw:
          type: number
          format: double
          description: >-
            Full field: `entry_price_usd_weighted_sum`. Cumulative sum of entry
            price x USD size across fills (VWAP numerator).
        scu:
          type: number
          format: double
          description: >-
            Full field: `split_collateral_usd`. Cumulative collateral locked via
            splits, in USD.
        mcu:
          type: number
          format: double
          description: >-
            Full field: `merge_collateral_usd`. Cumulative collateral released
            via merges, in USD.
        rpu:
          type: number
          format: double
          description: >-
            Full field: `redemption_payout_usd`. Cumulative redemption payouts
            in USD.
        ccu:
          type: number
          format: double
          description: >-
            Full field: `compress_collateral_usd`. Cumulative collateral
            released via compress operations, in USD.
        ccr:
          type: integer
          format: int64
          description: 'Full field: `combos_created`. Cumulative combo markets created.'
          minimum: 0
        cry:
          type: integer
          format: int64
          description: 'Full field: `combos_resolved_yes`. Cumulative combos resolved YES.'
          minimum: 0
        crn:
          type: integer
          format: int64
          description: 'Full field: `combos_resolved_no`. Cumulative combos resolved NO.'
          minimum: 0
        nct:
          type: integer
          format: int64
          description: >-
            Full field: `new_combo_traders`. Cumulative first-time combo
            traders.
          minimum: 0
        nbct:
          type: integer
          format: int64
          description: >-
            Full field: `new_builder_combo_traders`. Cumulative first-time
            builder-attributed combo traders.
          minimum: 0

````