> ## Documentation Index > Fetch the complete documentation index at: https://docs.coinversa.ai/llms.txt > Use this file to discover all available pages before exploring further. # Builders a wallet trades through > Every builder the wallet had attributed fills via within the lookback window (clamped to 90d), ordered by builder fees paid. Each row carries the wallet's fills, fees, and volume via that builder plus first/last attributed-fill timestamps within the window. ## OpenAPI ````yaml /api-reference/openapi.json get /api/public/v1/trader/{address}/builders openapi: 3.1.0 info: title: coinversa-api version: 0.1.0 servers: - url: https://api.coinversa.ai description: Production security: [] paths: /api/public/v1/trader/{address}/builders: get: tags: - Builder Analytics summary: Builders a wallet trades through description: >- Every builder the wallet had attributed fills via within the lookback window (clamped to 90d), ordered by builder fees paid. Each row carries the wallet's fills, fees, and volume via that builder plus first/last attributed-fill timestamps within the window. operationId: get-api-public-v1-trader-by-address-builders parameters: - description: Wallet address (0x-hex) in: path name: address required: true schema: description: Wallet address (0x-hex) type: string - description: Lookback window like 30m, 6h, 30d (clamped to 90d) explode: false in: query name: since schema: default: 30d description: Lookback window like 30m, 6h, 30d (clamped to 90d) type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TraderBuildersBody' description: OK '400': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Bad Request '401': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Unauthorized '422': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Unprocessable Entity '429': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Too Many Requests '500': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Internal Server Error '504': content: application/problem+json: schema: $ref: '#/components/schemas/APIError' description: Gateway Timeout security: - apiKey: [] components: schemas: TraderBuildersBody: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.coinversa.ai/schemas/TraderBuildersBody.json format: uri readOnly: true type: string address: type: string builders: description: Ordered by fees paid, descending items: $ref: '#/components/schemas/TraderBuilderRow' type: - array - 'null' dataNotes: type: string verified: $ref: '#/components/schemas/BuilderStamp' window: description: >- Echo of the requested since parameter; lookbacks beyond 90d still echo as requested while the data is clamped to 90d type: string required: - address - window - builders - dataNotes type: object APIError: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.coinversa.ai/schemas/APIError.json format: uri readOnly: true type: string code: description: Machine-readable error code type: string current_tier: description: Caller's effective tier type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string required_tier: description: Minimum tier for this operation type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upgrade_url: description: Where to upgrade type: string type: object TraderBuilderRow: additionalProperties: false properties: builder: type: string builderFeesUsd: description: Builder fees the wallet paid via this builder in the window format: double type: number builderName: description: Known display name for the builder; omitted if unknown type: string fills: format: int64 type: integer firstSeen: description: First attributed fill via this builder within the window (RFC3339) type: string lastSeen: description: Latest attributed fill via this builder within the window (RFC3339) type: string volumeUsd: format: double type: number required: - builder - fills - builderFeesUsd - volumeUsd - firstSeen - lastSeen type: object BuilderStamp: additionalProperties: false properties: coverage: $ref: '#/components/schemas/BuilderCoverage' description: >- Attribution coverage vs the ledger; null until the coverage pipeline is provisioned ledger_block: description: >- Latest block in HL's builder-fee ledger this data was verified against format: int64 type: integer ledger_chain_time: description: Chain timestamp of that ledger entry (RFC3339) type: string required: - ledger_block - ledger_chain_time - coverage type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object BuilderCoverage: additionalProperties: false properties: attributed_fees_usd: description: Join-attributed fees in the rollup window format: double type: number computed_at: description: When the rollup was computed (RFC3339) type: string ledger_fees_usd: description: Exact ledger revenue in the rollup window format: double type: number ratio: description: >- attributed_fees / ledger_fees — the share of revenue the fill-level metrics account for format: double type: number window_end: description: End of that window (RFC3339) type: string window_start: description: Start of the window the coverage rollup was computed over (RFC3339) type: string required: - window_start - window_end - ledger_fees_usd - attributed_fees_usd - ratio - computed_at type: object securitySchemes: apiKey: description: Get one at https://coinversa.ai/developers in: header name: X-API-Key type: apiKey ````