> ## 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. # Builder audience overlap > The top 10 other builders this builder's active users also traded via in the period, ranked by shared users. Each row carries the overlap's share of this builder's active users and the builder fees those shared users paid to the OTHER builder in the period. feesUsd is null (unknown, never zero) when the fee probe exceeds its budget — the shared-user counts always serve; see the response's dataNotes. ## OpenAPI ````yaml /api-reference/openapi.json get /api/public/v1/builders/{builder}/overlap 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/builders/{builder}/overlap: get: tags: - Builder Analytics summary: Builder audience overlap description: >- The top 10 other builders this builder's active users also traded via in the period, ranked by shared users. Each row carries the overlap's share of this builder's active users and the builder fees those shared users paid to the OTHER builder in the period. feesUsd is null (unknown, never zero) when the fee probe exceeds its budget — the shared-user counts always serve; see the response's dataNotes. operationId: get-api-public-v1-builders-by-builder-overlap parameters: - description: Builder address (0x-hex) in: path name: builder required: true schema: description: Builder address (0x-hex) type: string - explode: false in: query name: period schema: default: week enum: - day - week - month type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/BuilderOverlapBody' 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: BuilderOverlapBody: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.coinversa.ai/schemas/BuilderOverlapBody.json format: uri readOnly: true type: string activeUsers: description: >- Distinct wallets with attributed fills via this builder in the period (share denominator) format: int32 type: integer builder: type: string builderName: description: Known display name for the builder; omitted if unknown type: string dataNotes: type: string overlaps: description: Top 10 other builders by shared users items: $ref: '#/components/schemas/BuilderOverlapRow' type: - array - 'null' period: type: string verified: $ref: '#/components/schemas/BuilderStamp' required: - builder - period - activeUsers - overlaps - 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 BuilderOverlapRow: additionalProperties: false properties: builder: description: The other builder's address type: string builderName: description: Known display name for the other builder; omitted if unknown type: string feesUsd: description: >- Builder fees those shared users paid to the OTHER builder in the period; null when the fee probe exceeded its budget (see dataNotes) — null means unknown, never zero format: double type: - number - 'null' share: description: sharedUsers / activeUsers format: double type: number sharedUsers: description: >- This builder's active users who also had attributed fills via the other builder in the period format: int32 type: integer required: - builder - sharedUsers - share - feesUsd 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 ````