> ## Documentation Index > Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt > Use this file to discover all available pages before exploring further. # Sub-builder earnings > HL sub-builders (live 2026-10-28): an order's builder code can share its builder fee with up to 5 sub-builders. Each fill carries its own split (its sub-builders and their shares), so earnings are computed per fill: builder fee × share (complete since the first sub-builder fills, 2026-10-31). Per sub-builder and fee token over a window of fill time: the builders that pay it, orders, fills, notional and what it earned (builder fee × its share). Optional builder / sub_builder filters. A fill shared by several sub-builders counts in each of their rows: don't add fills or notional across sub-builders. Highest earnings first; at most 1,000 rows per query (your plan's wallet-list cap; meta.truncated reports a cut). Pricing: base + per row. Scope: `analytics:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/builders/sub-builders openapi: 3.1.0 info: title: Hyperdash Data API version: v1 description: >- Hyperliquid data from Hyperdash's own nodes. Every response reports the credits it cost. servers: - url: https://data.hyperdash.com security: [] tags: - name: Accounts - name: Async jobs - name: Builders - name: Cohorts - name: HIP-3 DEXs - name: Leaderboards - name: Lending - name: Liquidations - name: Markets - name: Network - name: Outcomes - name: Positions - name: Snapshots - name: Spot - name: Staking - name: Traders paths: /v1/builders/sub-builders: get: tags: - Builders summary: Sub-builder earnings description: >- HL sub-builders (live 2026-10-28): an order's builder code can share its builder fee with up to 5 sub-builders. Each fill carries its own split (its sub-builders and their shares), so earnings are computed per fill: builder fee × share (complete since the first sub-builder fills, 2026-10-31). Per sub-builder and fee token over a window of fill time: the builders that pay it, orders, fills, notional and what it earned (builder fee × its share). Optional builder / sub_builder filters. A fill shared by several sub-builders counts in each of their rows: don't add fills or notional across sub-builders. Highest earnings first; at most 1,000 rows per query (your plan's wallet-list cap; meta.truncated reports a cut). Pricing: base + per row. Scope: `analytics:read`. operationId: listSubBuilderEarnings parameters: - name: start_time in: query required: false description: >- Start of the fill-time window, epoch ms. Default: end − 7 days (≤ 30 days). schema: type: integer - name: end_time in: query required: false description: 'End, epoch ms (exclusive). Default: now.' schema: type: integer - name: builder in: query required: false description: Only shares paid by this builder (0x + 40 hex). schema: type: string pattern: ^0x[0-9a-fA-F]{40}$ - name: sub_builder in: query required: false description: Only this sub-builder (0x + 40 hex). schema: type: string pattern: ^0x[0-9a-fA-F]{40}$ - name: limit in: query required: false description: Rows (≤ 500). schema: type: integer minimum: 1 maximum: 500 default: 100 - name: cursor in: query required: false description: Opaque cursor from next_cursor. schema: type: string - name: X-Max-Credits in: header required: false description: Refuse (free) if the request could cost more. schema: type: integer - name: X-Credit-Price-Version in: header required: false description: Expected price version; 409 price_changed if it differs. schema: type: integer responses: '200': description: OK headers: X-Credits-Charged: schema: type: integer X-Credit-Price-Version: schema: type: integer X-Request-Id: schema: type: string content: application/json: schema: type: object required: - data - has_more - next_cursor - meta properties: data: type: array items: type: object properties: sub_builder: type: string description: Sub-builder fee_token: type: string description: Token the builder fee is paid in (USDC, …) builders: type: integer description: Builders sharing with it orders: type: integer description: Orders filled in the window fills: type: integer description: Fills notional: type: string description: >- Filled notional (px × size, in each market's quote) (decimal string; may carry extra trailing zeros) earned: type: string description: >- Earned: builder fee × share, in fee_token (decimal string; may carry extra trailing zeros) fee_unreported_fills: type: integer description: >- Fills whose builder fee the node did not report (not counted in earned) first_fill: type: integer description: First fill, epoch ms last_fill: type: integer description: Last fill, epoch ms has_more: type: boolean next_cursor: type: - string - 'null' meta: type: object '400': description: Invalid parameter content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: Invalid, expired or revoked key content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: Scope, plan, history or credit limit content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '409': description: Price version changed content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: Rate limited (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '503': description: Backend at capacity (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - bearer: [] x-codeSamples: - lang: curl source: >- curl -H 'Authorization: Bearer $HD_KEY' 'https://data.hyperdash.com/v1/builders/sub-builders' components: schemas: Problem: type: object required: - type - title - status - code - request_id properties: type: type: string title: type: string status: type: integer code: type: string detail: type: string hint: type: string request_id: type: string securitySchemes: bearer: type: http scheme: bearer description: hdk_sk_live_v1_… or hdk_sk_test_v1_… ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.