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

# All tags with builder-attributed activity

> Returns every tag that has builder-routed activity, with metrics aggregated across all builders. `distinct_builders` is exact; other `unique_*` columns sum per-builder uniques and may slightly over-count traders active under multiple builders.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/global/tags
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/builders/global/tags:
    get:
      tags:
        - Builders
      summary: All tags with builder-attributed activity
      description: >-
        Returns every tag that has builder-routed activity, with metrics
        aggregated across all builders. `distinct_builders` is exact; other
        `unique_*` columns sum per-builder uniques and may slightly over-count
        traders active under multiple builders.
      operationId: list_global_builder_tags
      parameters:
        - name: sort
          in: query
          description: 'Metric to sort by. Default: volume.'
          required: false
          schema:
            $ref: '#/components/schemas/BuilderSortBy'
        - name: sort_desc
          in: query
          description: 'Sort direction (default: true = highest first).'
          required: false
          schema:
            type: boolean
        - name: timeframe
          in: query
          description: 'Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime.'
          required: false
          schema:
            $ref: '#/components/schemas/BuilderTimeframe'
        - name: limit
          in: query
          description: Max rows to return (default 50, max 500).
          required: false
          schema:
            type: integer
            format: int64
        - name: offset
          in: query
          description: Skip count.
          required: false
          schema:
            type: integer
            format: int64
        - name: pagination_key
          in: query
          description: Opaque cursor.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Per-tag aggregated stats
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GlobalBuilderTagRow'
components:
  schemas:
    BuilderSortBy:
      type: string
      description: Sort metric for the builders list endpoint.
      enum:
        - volume
        - txns
        - traders
        - fees
        - builder_fees
        - new_users
        - avg_rev_per_user
        - avg_vol_per_user
        - builder_maker_fee_rate_bps
        - builder_taker_fee_rate_bps
    BuilderTimeframe:
      type: string
      description: Time window for cumulative builder stats.
      enum:
        - lifetime
        - 1d
        - 7d
        - 30d
    GlobalBuilderTagRow:
      type: object
      description: >-
        One tag's stats aggregated across every builder routing activity into
        it.


        `distinct_builders` is the exact count of builders active in the tag.

        `unique_traders` / `unique_makers` / `unique_takers` are summed per
        builder,

        so a trader active under multiple builders is counted in each — these
        are

        upper bounds rather than true window-distinct counts.
      required:
        - tag
        - block
        - ts
        - distinct_builders
        - volume_usd
        - buy_volume_usd
        - sell_volume_usd
        - unique_traders
        - unique_makers
        - unique_takers
        - txn_count
        - buy_count
        - sell_count
        - fees_usd
        - builder_fees
        - shares_volume
        - yes_volume_usd
        - no_volume_usd
        - yes_count
        - no_count
        - buy_dist_under_10
        - buy_dist_10_100
        - buy_dist_100_1k
        - buy_dist_1k_10k
        - buy_dist_10k_50k
        - buy_dist_50k_plus
        - new_users
        - avg_rev_per_user
        - avg_vol_per_user
      properties:
        tag:
          type: string
          description: Tag.
        block:
          type: integer
          format: int64
          description: Latest block number for the metric snapshot.
          minimum: 0
        ts:
          type: integer
          format: int32
          description: Unix timestamp in seconds.
          minimum: 0
        distinct_builders:
          type: integer
          format: int64
          description: Distinct builders.
          minimum: 0
        volume_usd:
          type: number
          format: double
          description: Volume in USD.
        buy_volume_usd:
          type: number
          format: double
          description: Buy volume in USD.
        sell_volume_usd:
          type: number
          format: double
          description: Sell volume in USD.
        unique_traders:
          type: integer
          format: int64
          description: Unique traders.
          minimum: 0
        unique_makers:
          type: integer
          format: int64
          description: Unique makers.
          minimum: 0
        unique_takers:
          type: integer
          format: int64
          description: Unique takers.
          minimum: 0
        txn_count:
          type: integer
          format: int64
          description: Transaction count.
          minimum: 0
        buy_count:
          type: integer
          format: int64
          description: Buy count.
          minimum: 0
        sell_count:
          type: integer
          format: int64
          description: Sell count.
          minimum: 0
        fees_usd:
          type: number
          format: double
          description: Fees in USD.
        builder_fees:
          type: number
          format: double
          description: Builder fees.
        shares_volume:
          type: number
          format: double
          description: Shares volume.
        yes_volume_usd:
          type: number
          format: double
          description: Yes volume in USD.
        no_volume_usd:
          type: number
          format: double
          description: No volume in USD.
        yes_count:
          type: integer
          format: int64
          description: Yes count.
          minimum: 0
        no_count:
          type: integer
          format: int64
          description: No count.
          minimum: 0
        buy_dist_under_10:
          type: integer
          format: int64
          description: Buy trade count in the under-10 USD bucket.
          minimum: 0
        buy_dist_10_100:
          type: integer
          format: int64
          description: Buy trade count in the 10-100 USD bucket.
          minimum: 0
        buy_dist_100_1k:
          type: integer
          format: int64
          description: Buy trade count in the 100-1k USD bucket.
          minimum: 0
        buy_dist_1k_10k:
          type: integer
          format: int64
          description: Buy trade count in the 1k-10k USD bucket.
          minimum: 0
        buy_dist_10k_50k:
          type: integer
          format: int64
          description: Buy trade count in the 10k-50k USD bucket.
          minimum: 0
        buy_dist_50k_plus:
          type: integer
          format: int64
          description: Buy trade count in the 50k-plus USD bucket.
          minimum: 0
        new_users:
          type: integer
          format: int64
          description: New users.
          minimum: 0
        avg_rev_per_user:
          type: number
          format: double
          description: Average rev per user.
        avg_vol_per_user:
          type: number
          format: double
          description: Average vol per user.

````