---
title: "Get the transactions that paid an owner builder fees"
method: GET
path: "/api/v1/referrals/builder-fee-history"
tags: ["Referrals"]
---

# Get the transactions that paid an owner builder fees

`GET /api/v1/referrals/builder-fee-history`

## Request

- Base URL: `https://api.mainnet.aptoslabs.com/decibel`
- URL: `https://api.mainnet.aptoslabs.com/decibel/api/v1/referrals/builder-fee-history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/decibel/apis/decibel-trading-api/docs/api/v1/referrals/builder-fee-history/get.ts> (a function with typed inputs; its response is checked against the schema)

Newest first, one row per transaction. Perps only, like the totals it drills into.

## Query parameters

- `referrer_account` string, required
- `days` integer
- `pagination` object, required
  - `limit` integer: Maximum number of items to return per page (capped at 1000)
  - `offset` integer: Number of items to skip before returning results (capped at 10000)

## Response `200`

A page of the builder's fee history

- PaginatedResponseBuilderFeeTx
  - `items` object[], required: The items in the current page
    - `fees_usd` number, double, required
    - `fills` integer, required: Fill sides settled in this transaction.
    - `market` string, required: Empty when the market no longer resolves.
    - `notional_usd` number, double, required
    - `transaction_unix_ms` integer, required
    - `transaction_version` integer, required
  - `total_count` integer, nullable: The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

## Other responses

- `400`: Invalid address
- `500`: Database error

## Changes

- **2026-11-03** `bb095628df0a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/decibel/apis/decibel-trading-api/changes/api/v1/referrals/builder-fee-history/get.md)

---

[API](https://skmtc.dev/decibel/apis/decibel-trading-api.md) - [All operations](https://skmtc.dev/decibel/apis/decibel-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decibel/apis/decibel-trading-api/revisions/ee1bcb5822bd?raw)