POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (maxBuilderFee)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "maxBuilderFee",
  "user": "0x47fc45cebfc47cef07a09a98405b6ebaef00ef75",
  "builder": "0x1922810825c90f4270048b96da7b1803cd8609ef"
}'
1
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.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

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
MEV and builders:
  • Builders compete to include transactions in blocks for optimal ordering
  • Users can set maximum fees they’re willing to pay for builder services
  • Higher fees may result in better execution and reduced slippage
  • Fee approvals create trust relationships between users and builders
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

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

Example response

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.

Body

application/json

Response

200 - application/json

Maximum builder fee approved by the user for the specified builder

Maximum fee approved in tenths of a basis point (e.g., 1 means 0.001%)

Example:

1