---
title: "Get Builder Code Statistics"
method: GET
path: "/v1/builder_code/stats"
tags: ["Builder Code"]
---

# Get Builder Code Statistics

`GET /v1/builder_code/stats`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/builder_code/stats`
- Auth: one of:
  - HTTP bearer
  - API key in header `ONDO-KEY-ID`

Returns trading volume and builder fees attributed to the builder code owned by the authenticated account. Time bounds are inclusive. Omit endTime for live statistics; live results use a five-minute start-time bucket and are cached for one hour. Historical requests include endTime and are cached for 24 hours. An explicit endTime must be at least one minute in the past.

## Query parameters

- `startTime` integer, required
- `endTime` integer

## Response `200`

Builder-code volume and fee statistics for the effective inclusive time window

- object
  - `success` boolean, required: Whether the request was successful
  - `error` string: Error message, present only on failure
  - `error_code` string: Semantic error code. See each endpoint's error responses for the specific codes it can return.
  - `deprecated` string: Deprecation notice, if applicable
  - `result` BuilderCodeStatsResult
    - `startTime` integer, required: Effective inclusive start time in Unix milliseconds. Live requests return the requested start rounded down to a five-minute boundary.
    - `endTime` integer, required: Effective inclusive end time in Unix milliseconds. For live requests, this is the cached query snapshot time and can be earlier than the current request time.
    - `totalVolume` string, required: Exact, non-scientific decimal string containing the sum of totalVolume across all returned accounts.
    - `totalBuilderFee` string, required: Exact, non-scientific decimal string containing the sum of builderFee across all returned accounts.
    - `accounts` BuilderCodeStatsAccount[], required: Statistics grouped by raw fill account ID. Subaccounts are separate entries, ordering is not guaranteed, and the array is not paginated. An empty window returns an empty array.
      - `accountId` string, required: Raw account ID associated with the qualifying fills. Main accounts and subaccounts are returned as separate entries.
      - `walletAddress` string, required: Primary wallet address of the account's main account. A main account and its subaccounts therefore share this value.
      - `totalVolume` string, required: Exact, non-scientific decimal string containing the account's qualifying USD fill volume.
      - `builderFee` string, required: Exact, non-scientific decimal string containing the builder fees attributed to this account's fills.

## Other responses

- `400`: Bad request. The query parameters were malformed or failed validation.
- `401`: Authentication required. Provide a valid JWT or API key.
- `403`: Access denied. The authenticated account does not have permission.
- `404`: The authenticated account does not own a builder code.
- `429`: Rate limit exceeded. Slow down request frequency.
- `500`: Internal server error.

## Changes

- **2026-11-03** `1601c3adedda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/changes/v1/builder_code/stats/get.md)

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)