Skip to main content
GET
Get user fees and fee schedule

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

account
string
required

User account address (user query alias is also accepted)

Response

User fee information retrieved

Response for GET /api/v1/user_fee_rates?account=<address>.

Returns the user's current fee tier, effective rates (after referral discount), the full fee schedule, and their fee-window daily volume history.

Tier semantics mirror on-chain: BOTH products key off the same weighted cross-product volume perp_volume x volume_weights.perp + spot_volume x volume_weights.spot against one shared threshold ladder (unified_fees_config), and differ only in their rate ladders. Each product block carries its own fee_tier, which are equal in practice but kept separate so a future per-product ladder does not become a breaking change. The top-level fields (fee_tier, daily_user_volume, fee_schedule, user_taker_rate, user_maker_rate, active_referral_discount) remain PERP-ONLY for backward compatibility; new consumers should read perp / spot explicitly.

account
string
required

The queried account address

active_referral_discount
number<double>
required

DEPRECATED, use perp.active_referral_discount. Active PERP referral discount fraction.

daily_user_volume
object[]
required

DEPRECATED, use perp.daily_user_volume. Daily PERP volume breakdown for the current on-chain fee window (ascending date order). Serialized verbatim twice, so this is the largest single item of duplicated payload.

fee_schedule
object
required

DEPRECATED, use perp.fee_schedule. PERP fee schedule.

fee_tier
integer<int64>
required

DEPRECATED, use perp.fee_tier. PERP fee tier index (0 = base tier).

Required range: x >= 0
perp
object
required

Perp-side fee state (tier, rates, ladder, raw volume history)

spot
object
required

Spot-side fee state (tier, rates, ladder, raw volume history)

user_maker_rate
number<double>
required

DEPRECATED, use perp.user_maker_rate. User's effective PERP maker rate.

user_taker_rate
number<double>
required

DEPRECATED, use perp.user_taker_rate. User's effective PERP taker rate.

volume_weights
object
required

The multipliers used to compute weighted_volume_usd

weighted_volume_usd
string
required

Weighted cross-product volume driving BOTH perp.fee_tier and spot.fee_tier (USD, whole-dollar integer string)