> ## 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.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:
POST https://docs.chainstack.com/feedback
```json
{
"path": "/reference/hyperliquid-exchange-approve-builder-fee",
"feedback": "Description of the issue"
}
```
Only submit feedback when you have something specific and actionable to report.
# approveBuilderFee | Hyperliquid exchange
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
This endpoint requires signature authentication. See our comprehensive [Authentication via Signatures guide](/docs/hyperliquid-authentication-guide) for implementation details.
Approves a builder fee for a specific builder address. This allows the builder to charge fees on orders placed through their interface.
**Get your own node endpoint today**
[Start for free](https://console.chainstack.com/) 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
### Required parameters
* `action` (object, required) — The action object containing:
* `type` (string) — Must be `"approveBuilderFee"`
* `hyperliquidChain` (string) — Chain identifier
* `maxFeeRate` (string) — Maximum fee rate the builder can charge
* `builder` (string) — Builder address to approve
* `nonce` (integer) — Unique nonce
* `nonce` (number, required) — Current timestamp in milliseconds (must be recent)
* `signature` (object, required) — EIP-712 signature of the action
### Optional parameters
* `vaultAddress` (string, optional) — Address when trading on behalf of a vault or subaccount
## Returns
Returns an object with the action status:
* `status` — `"ok"` if request processed
* `response` — Contains action result data
## Example request
```shell cURL theme={"system"}
curl -X POST https://api.hyperliquid.xyz/exchange \
-H "Content-Type: application/json" \
-d '{
"action": {"type": "approveBuilderFee"},
"nonce": 1234567890123,
"signature": {...}
}'
```
## Use case
* **Approve builder fee** — Approves a builder fee for a specific builder address. This allows the builder to charge fees on orders placed through their interface.
Always ensure your system clock is synchronized. Nonce must be within a reasonable time window of the current server time or the request will be rejected.
## OpenAPI
````yaml /openapi/hyperliquid_node_api/exchange_approve_builder_fee.json post /exchange
openapi: 3.0.0
info:
title: Hyperliquid Exchange API
version: 1.0.0
description: >-
API for trading operations on Hyperliquid exchange. **IMPORTANT**: All
exchange endpoints require EIP-712 signatures for authentication. The
examples shown will not work without proper signing. See the [Hyperliquid
Python SDK](https://github.com/hyperliquid-dex/hyperliquid-python-sdk) for
implementation examples.
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/exchange:
post:
tags:
- hyperliquid exchange
summary: Approve builder fee
operationId: approveBuilderFee
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action:
type: object
properties:
type:
type: string
default: approveBuilderFee
enum:
- approveBuilderFee
description: Action type
hyperliquidChain:
type: string
description: Chain identifier
default: Mainnet
enum:
- Mainnet
- Testnet
signatureChainId:
type: string
description: EIP-712 signature chain ID
default: '0xa4b1'
maxFeeRate:
type: string
description: Maximum fee rate as a percentage string (e.g., "0.001%")
builder:
type: string
description: Ethereum address of the builder
nonce:
type: integer
description: Current timestamp in milliseconds
required:
- type
- hyperliquidChain
- signatureChainId
- maxFeeRate
- builder
- nonce
nonce:
type: integer
description: Current timestamp in milliseconds
signature:
type: object
description: EIP-712 signature of the action with r, s, v components
properties:
r:
type: string
description: ECDSA signature r component (hex string)
example: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s:
type: string
description: ECDSA signature s component (hex string)
example: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v:
type: integer
description: ECDSA recovery id (27 or 28)
example: 27
required:
- r
- s
- v
vaultAddress:
type: string
description: >-
Address when trading on behalf of a vault or subaccount
(optional)
nullable: true
required:
- action
- nonce
- signature
example:
action:
type: approveBuilderFee
hyperliquidChain: Mainnet
signatureChainId: '0xa4b1'
maxFeeRate: 0.001%
builder: '0x1234567890abcdef1234567890abcdef12345678'
nonce: 1705234567890
nonce: 1705234567890
signature:
r: >-
0x0000000000000000000000000000000000000000000000000000000000000000
s: >-
0x0000000000000000000000000000000000000000000000000000000000000000
v: 27
vaultAddress: null
responses:
'200':
description: Action result
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Request status
response:
type: object
description: Action response data
````