Skip to main content

Check Approval REST API Endpoint

Check builder fee approval status for a user address.

Updated on
May 19, 2026
info

Exchange API calls do not consume Quicknode API credits. If you are on a free trial plan, see hyperliquidapi.com for your URL and fee schedule. To white-label with your own builder code, contact us.


Query Parameters

user
string
REQUIRED

User address (0x...) to check approval status

Returns

approved
boolean

Whether builder fee is approved

maxFeeRate
string

Current maximum fee rate approved as percentage (e.g., "0%", "1%")

maxFeeRaw
integer

Current maximum fee rate in basis points (e.g., 0 = 0%, 40 = 0.04%)

builder
string

Builder address (0x-prefixed hex string)

user
string

User address being checked (0x-prefixed hex string)

canTradePerps
boolean

Whether the user can trade perpetual markets with current approval

canTradeSpot
boolean

Whether the user can trade spot markets with current approval

feeBreakdown
object

Detailed breakdown of fee approval status

yourApproval
string

Current approved fee rate (e.g., "0%", "1%")

perpsRequirement
string

Minimum fee rate required for perps trading (e.g., "0.04%")

spotRequirement
string

Minimum fee rate required for spot trading (e.g., "0.05%")

status
string

Human-readable status message explaining approval state

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free