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

# maxBuilderFee | Hyperliquid info

> The info endpoint with type: "maxBuilderFee" retrieves the maximum builder fee that a user has approved for a specific builder on the Hyperliquid network.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "maxBuilderFee"` retrieves the maximum builder fee that a user has approved for a specific builder on the Hyperliquid network. This endpoint is essential for understanding fee arrangements between users and builders in the MEV (Maximum Extractable Value) ecosystem.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"maxBuilderFee"` to retrieve the maximum builder fee.
* `user` (string, required) — User address in 42-character hexadecimal format (e.g., `0x47fc45cebfc47cef07a09a98405b6ebaef00ef75`).
* `builder` (string, required) — Builder address in 42-character hexadecimal format (e.g., `0x1922810825c90f4270048b96da7b1803cd8609ef`).

## Response

The response is a single integer representing the maximum builder fee:

* **Fee value** (integer) — Maximum fee approved in tenths of a basis point
  * Example: `1` means 0.001% (1/10 of a basis point)
  * Example: `10` means 0.01% (1 basis point)
  * Example: `100` means 0.1% (10 basis points)

### Understanding builder fees

**Builder fee structure:**

* Fees are expressed in tenths of a basis point for precise control
* One basis point = 0.01%, so one tenth of a basis point = 0.001%
* This granular fee structure allows for competitive builder markets

**Fee approval process:**

* Users pre-approve maximum fees for specific builders
* Actual fees charged may be less than the approved maximum
* Approvals can be updated or revoked as needed
* Zero values indicate no fee approval for that builder

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "maxBuilderFee", "user": "0x47fc45cebfc47cef07a09a98405b6ebaef00ef75", "builder": "0x1922810825c90f4270048b96da7b1803cd8609ef"}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={"system"}
  from hyperliquid.info import Info

  # The hyperliquid-python-sdk has no dedicated maxBuilderFee helper,
  # so call the info endpoint directly with the generic post method.
  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  response = info.post(
      "/info",
      {
          "type": "maxBuilderFee",
          "user": "0x47fc45cebfc47cef07a09a98405b6ebaef00ef75",
          "builder": "0x1922810825c90f4270048b96da7b1803cd8609ef",
      },
  )

  print(response)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  const maxBuilderFee = await info.maxBuilderFee({
    user: "0x47fc45cebfc47cef07a09a98405b6ebaef00ef75",
    builder: "0x1922810825c90f4270048b96da7b1803cd8609ef",
  });

  console.log(maxBuilderFee);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

```json theme={"system"}
1
```

This response indicates that the user has approved a maximum builder fee of 1 tenth of a basis point (0.001%) for the specified builder.

## Use case

The `info` endpoint with `type: "maxBuilderFee"` is essential for applications that need to:

* **Trading interfaces**: Display current builder fee approvals before order submission
* **Fee management**: Allow users to review and adjust their builder fee settings
* **Builder selection**: Help users choose builders based on approved fee levels
* **Cost analysis**: Calculate potential trading costs including builder fees
* **Compliance monitoring**: Track fee arrangements for regulatory reporting
* **MEV optimization**: Optimize builder relationships for better execution
* **Risk management**: Monitor fee exposure across different builders
* **Automated trading**: Verify fee approvals before executing algorithmic strategies
* **Portfolio analytics**: Include builder fees in total cost calculations
* **Builder comparison**: Compare fee structures across different builders
* **Execution quality**: Correlate fees with execution performance metrics
* **Fee auditing**: Track historical fee approvals and changes
* **Smart routing**: Route orders based on fee-adjusted execution quality
* **User education**: Show users how builder fees impact their trading costs

This endpoint is particularly valuable for sophisticated traders who actively manage their builder relationships, institutional users with complex execution requirements, and applications that provide comprehensive trading cost analysis and optimization on the Hyperliquid network.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_max_builder_fee.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (maxBuilderFee)
      operationId: infoMaxBuilderFee
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  default: maxBuilderFee
                  enum:
                    - maxBuilderFee
                  description: >-
                    Request type to retrieve maximum builder fee approved by
                    user
                user:
                  type: string
                  default: '0x47fc45cebfc47cef07a09a98405b6ebaef00ef75'
                  description: User address in 42-character hexadecimal format
                builder:
                  type: string
                  default: '0x1922810825c90f4270048b96da7b1803cd8609ef'
                  description: Builder address in 42-character hexadecimal format
              required:
                - type
                - user
                - builder
      responses:
        '200':
          description: Maximum builder fee approved by the user for the specified builder
          content:
            application/json:
              schema:
                type: integer
                description: >-
                  Maximum fee approved in tenths of a basis point (e.g., 1 means
                  0.001%)
                example: 1

````