---
title: "Get Recent Builder Code Fills"
method: GET
path: "/v1/builder_code/fills"
tags: ["Builder Code"]
---

# Get Recent Builder Code Fills

`GET /v1/builder_code/fills`

## Request

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

Returns the most recent fills attributed to the builder code owned by the authenticated account, newest first, across every account that traded with that code. The exchange retains at most 200 fills per builder code.

Use this endpoint to resynchronize after a `builderFills` WebSocket disconnect: reconnect, subscribe, then call this endpoint and de-duplicate by `fillId`. It is a short recovery window, not a fill history. For totals over an arbitrary period, use the builder-code statistics endpoint instead.

The retained window is rebuilt when the exchange restarts, so a response can contain fewer than 200 fills shortly afterwards.

## Response `200`

Recent fills attributed to the caller's builder code, newest first

- 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` BuilderFill[]: Up to 200 fills, newest first. An owner with no recorded fills returns an empty array.
    - `builderCodeFee` string, required: Exact, non-scientific decimal string containing the builder commission earned on this fill, in USDC. This is the charged amount, not the rate.
    - `fillId` string, required: Unique fill identifier. Use it to de-duplicate overlap between a resynchronization response and live channel messages.
    - `orderId` string, required: Identifier of the order that produced this fill. A single order can produce several fills, so use it to group fills by order. May be an empty string for fills recorded before this field was introduced.
    - `clientOrderId` string: Client-supplied identifier set on the order that produced this fill. Omitted when the order was placed without one.
    - `market` string, required: Market the fill traded in. Builder codes apply to perps only.
    - `price` string, required: Fill price as an exact decimal string.
    - `size` string, required: Fill quantity in the base asset, as an exact decimal string.
    - `side` 'buy' | 'sell', required: Side of the account that traded, not of the builder.
    - `time` string, date-time, required: Time the fill was created.

## Other responses

- `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/fills/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)