> ## 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. # Get a single builder's cumulative stats > Returns cumulative stats for one builder over the chosen window. ## OpenAPI ````yaml https://api.struct.to/openapi.json get /polymarket/builders/{builder_code} 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/{builder_code}: get: tags: - Builders summary: Get a single builder's cumulative stats description: Returns cumulative stats for one builder over the chosen window. operationId: get_builder parameters: - name: builder_code in: path description: Builder code. required: true schema: type: string - name: timeframe in: query description: 'Window to report stats over. Default: lifetime.' required: false schema: $ref: '#/components/schemas/BuilderTimeframe' responses: '200': description: Builder snapshot with embedded display metadata. content: application/json: schema: $ref: '#/components/schemas/BuilderLatestRowWithMetadata' components: schemas: BuilderTimeframe: type: string description: Time window for cumulative builder stats. enum: - lifetime - 1d - 7d - 30d BuilderLatestRowWithMetadata: allOf: - $ref: '#/components/schemas/BuilderLatestRow' 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: |- Latest builder stats with builder display metadata (name, icon, links) merged onto each row. Returned by endpoints that embed display metadata, such as `/`, `/{builder_code}`, and `/tags/{tag}`. BuilderLatestRow: type: object description: Cumulative stats for a single builder. 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 - builder_maker_fee_rate_bps - builder_taker_fee_rate_bps 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 revenue per user — `builder_fees / unique_traders`. avg_vol_per_user: type: number format: double description: Average volume per user — `volume_usd / unique_traders`. builder_maker_fee_rate_bps: type: integer format: int32 description: >- Builder's maker fee rate in basis points. Same value across all timeframes — this is a property of the builder, not a windowed metric. minimum: 0 builder_taker_fee_rate_bps: type: integer format: int32 description: |- Builder's taker fee rate in basis points. Same scoping as `builder_maker_fee_rate_bps`. minimum: 0 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' ````