> ## 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. # Per-builder breakdown for a tag > Returns the top builders that have routed activity into this tag, ranked by the chosen metric over the chosen window. ## OpenAPI ````yaml https://api.struct.to/openapi.json get /polymarket/builders/tags/{tag} 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/tags/{tag}: get: tags: - Builders summary: Per-builder breakdown for a tag description: >- Returns the top builders that have routed activity into this tag, ranked by the chosen metric over the chosen window. operationId: list_tag_builders parameters: - name: tag in: path description: Tag label (URL-encoded). required: true schema: type: string - 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-builder breakdown, each with embedded display metadata. content: application/json: schema: type: array items: $ref: '#/components/schemas/TagBuilderRowWithMetadata' 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 TagBuilderRowWithMetadata: allOf: - $ref: '#/components/schemas/TagBuilderRow' description: Metrics for this item. - type: object properties: metadata: oneOf: - type: 'null' - $ref: '#/components/schemas/BuilderMetadataInline' description: >- Builder display metadata (name, links, icon URL, description). `null` when no metadata has been registered for this builder. description: |- `TagBuilderRow` with builder display metadata (name, icon, links) merged onto each row. Returned by `/polymarket/builders/tags/{tag}`. TagBuilderRow: type: object description: One builder's stats under a single tag. required: - builder_code - block - ts - 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: builder_code: type: string description: Builder code. 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 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. BuilderMetadataInline: type: object description: >- Same fields as `BuilderMetadata` minus `builder_code`. Used when embedding metadata under a `metadata` field on a row that already carries `builder_code` at the top level (leaderboard / get / tag responses) so we don't duplicate the key. required: - name properties: name: type: string website: type: - string - 'null' twitter: type: - string - 'null' icon_url: type: - string - 'null' description: type: - string - 'null' ````