userFees | Hyperliquid Info API
Info API
userFees | Hyperliquid Info API
Hyperliquid userFees: fetch a user’s fee schedule and recent daily trading volume.
POST
userFees | Hyperliquid Info API
Credit Cost
1 per call
Processing
Realtime
type: "userFees" is used to fetch a user’s fee schedule and recent daily volume.
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "userFees", "user": "..."}. feeScheduleis the exchange-wide tier table;userCrossRate/userAddRateare the effective rates this user pays after VIP-tier, referral, and staking discounts.- All rate and volume fields are decimal strings; a rate of
"0.00045"means 4.5 basis points.
cross) and maker (add) rates a wallet actually pays, and to reconstruct the tier table and discounts that produce them.
User-keyed.
Endpoint
Request
string
required
Always
"userFees".string
required
The wallet address (lowercase 0x-prefixed hex).
Example
Response
A single object with the user’s recent daily volume, the exchange-widefeeSchedule, the user’s effective rates, and any active discounts / trial state.
Field descriptions
All rate and volume fields (
userCross, userAdd, exchange, cross, add, userCrossRate, userAddRate, and the tier / discount values) are returned as decimal strings. Do not parse them as floats. Rates are expressed as fractions of notional - "0.00045" = 4.5 bps.array<object>
Recent per-day traded volume, one entry per day.
object
Exchange-wide fee schedule - the base rates and the tier tables that discounts are applied against.
string
Effective taker (cross) rate this user pays, after all applicable discounts.
string
Effective maker (add) rate this user pays, after all applicable discounts.
string
Referral discount currently applied to the user, as a fraction of fees.
object | null
Active fee-trial details, or
null when the user has no active trial.string
Reward accrued from the user’s fee trial.
int | null
Millisecond timestamp when the next fee trial becomes available, or
null when not applicable.