Skip to main content
POST
userFees | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "userFees" is used to fetch a user’s fee schedule and recent daily volume.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "userFees", "user": "..."}.
  • feeSchedule is the exchange-wide tier table; userCrossRate / userAddRate are 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.
Returns a user’s effective trading fees together with the exchange-wide fee schedule and the user’s recent per-day traded volume. Use it to display the taker (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-wide feeSchedule, 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.
Last reviewed: 2026-07-24