> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Get builder's daily revenue settlement history

> **Limit: 10 requests per second**

`GET /v1/broker/daily_fee_revenue`

Retrieve daily revenue settlement records for the broker ID linked to the authenticated builder admin. Use this endpoint to reconcile builder revenue by settlement date. The settlement date is recorded at `00:00 UTC` on the day after the revenue date.

Each row represents a settlement day and breaks revenue into Perp Anything fee share, distributor fee share, builder fee revenue, and revenue share generated via cross-builder or tagged order flows (`order_tag`). `builder_fee_revenue` is the net fee revenue earned from the builder's trading platform: trading fees minus the builder's base fee, after affiliate commission distribution. `total_revenue` equals `permissionless_listing_fee_share` + `distributor_fee_share` + `builder_fee_revenue` + `cross_broker_fee`.

Access is limited to the current builder admin's own broker ID. If the builder admin account changed, records associated with a previous admin account are not returned. Results are sorted by `date` descending. The `start_date` and `end_date` range must be valid and cannot exceed 180 days.




## OpenAPI

````yaml orderly.openapi get /v1/broker/daily_fee_revenue
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /v1/broker/daily_fee_revenue:
    get:
      tags:
        - private
      summary: Get builder's daily revenue settlement history
      description: >
        **Limit: 10 requests per second**


        `GET /v1/broker/daily_fee_revenue`


        Retrieve daily revenue settlement records for the broker ID linked to
        the authenticated builder admin. Use this endpoint to reconcile builder
        revenue by settlement date. The settlement date is recorded at `00:00
        UTC` on the day after the revenue date.


        Each row represents a settlement day and breaks revenue into Perp
        Anything fee share, distributor fee share, builder fee revenue, and
        revenue share generated via cross-builder or tagged order flows
        (`order_tag`). `builder_fee_revenue` is the net fee revenue earned from
        the builder's trading platform: trading fees minus the builder's base
        fee, after affiliate commission distribution. `total_revenue` equals
        `permissionless_listing_fee_share` + `distributor_fee_share` +
        `builder_fee_revenue` + `cross_broker_fee`.


        Access is limited to the current builder admin's own broker ID. If the
        builder admin account changed, records associated with a previous admin
        account are not returned. Results are sorted by `date` descending. The
        `start_date` and `end_date` range must be valid and cannot exceed 180
        days.
      parameters:
        - name: start_date
          in: query
          description: >-
            Start date in `YYYY-MM-DD` format. Must be less than or equal to
            `end_date`.
          required: true
          example: '2026-04-01'
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          description: >-
            End date in `YYYY-MM-DD` format. The interval from `start_date` to
            `end_date` must not exceed 180 days.
          required: true
          example: '2026-04-30'
          schema:
            type: string
            format: date
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBuilderDailyFeeRevenueResponse'
              examples:
                success:
                  summary: Builder daily revenue settlement history
                  value:
                    success: true
                    data:
                      rows:
                        - date: '2026-08-18'
                          permissionless_listing_fee_share: 0
                          distributor_fee_share: 0
                          builder_fee_revenue: 0
                          cross_broker_fee: 0
                          total_revenue: 0
                    timestamp: 1787068800000
        '400':
          description: Invalid date range
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - code
                  - message
                properties:
                  success:
                    type: boolean
                    example: false
                  code:
                    type: integer
                    example: -1103
                  message:
                    type: string
                    example: start_date and end_date can't be blank
              examples:
                missing_dates:
                  summary: Missing date parameter
                  value:
                    success: false
                    code: -1103
                    message: start_date and end_date can't be blank
                date_interval_too_large:
                  summary: Date interval exceeds 180 days
                  value:
                    success: false
                    code: -1103
                    message: error date interval greater than 180 days
      deprecated: false
components:
  parameters:
    orderly_timestamp:
      name: orderly-timestamp
      in: header
      description: Timestamp of the signed request in milliseconds.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: '1649920583000'
    orderly_account_id:
      name: orderly-account-id
      in: header
      description: Account ID of the authenticated account.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: 6.858456565150415e+75
    orderly_key:
      name: orderly-key
      in: header
      description: Public orderly key used to sign the request.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX
    orderly_signature:
      name: orderly-signature
      in: header
      description: Signature of the request payload generated with the orderly key.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: >-
        dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ==
  schemas:
    GetBuilderDailyFeeRevenueResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - rows
              properties:
                rows:
                  description: Daily revenue records sorted by date descending.
                  type: array
                  items:
                    type: object
                    required:
                      - date
                      - permissionless_listing_fee_share
                      - distributor_fee_share
                      - builder_fee_revenue
                      - cross_broker_fee
                      - total_revenue
                    properties:
                      date:
                        type: string
                        format: date
                        description: >-
                          Settlement date, formatted as `YYYY-MM-DD`. Settlement
                          occurs at `00:00 UTC` on the day after the revenue
                          date.
                        example: '2026-08-18'
                      permissionless_listing_fee_share:
                        type: number
                        description: >-
                          Permissionless Listing / PML fee-share revenue
                          generated by Perp Anything markets. The legacy field
                          name is retained for API compatibility.
                        example: 0
                      distributor_fee_share:
                        type: number
                        description: Builder's share from distributor relationships.
                        example: 0
                      builder_fee_revenue:
                        type: number
                        description: >-
                          Net fee revenue from the builder's trading platform,
                          calculated as trading fees minus the builder's base
                          fee, after affiliate commission distribution.
                        example: 0
                      cross_broker_fee:
                        type: number
                        description: >-
                          Revenue share generated via cross-builder or tagged
                          order flows (`order_tag`).
                        example: 0
                      total_revenue:
                        type: number
                        description: >-
                          Sum of `permissionless_listing_fee_share`,
                          `distributor_fee_share`, `builder_fee_revenue`, and
                          `cross_broker_fee`.
                        example: 0
    BasicResponse:
      required:
        - success
      type: object
      properties:
        success:
          description: Indicates whether the request was successful.
          type: boolean
          example: true
        timestamp:
          description: Server timestamp in milliseconds.
          type: integer
          example: 1702989203989

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.