Skip to content
Alchemy Logo

User fees

This API is in private preview. Target October 2026; timing is subject to change.

Returns an account's fee schedule, current rates, and daily volume history.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects userFees.
userstringYesMaster or sub-account address.
{
  "type": "userFees",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
dailyUserVlm[]arrayDaily user and exchange volume buckets.
dailyUserVlm[].datestringUTC calendar date for this volume bucket.
dailyUserVlm[].userCrossstringUser taker notional volume for the UTC day.
dailyUserVlm[].userAddstringUser maker notional volume for the UTC day.
dailyUserVlm[].exchangestringExchange-wide notional volume for the same UTC day.
feeScheduleobjectBase rates and volume-tier adjustments that determine user fees.
feeSchedule.crossstringBase perpetual taker fee rate as a decimal fraction.
feeSchedule.addstringBase perpetual maker fee rate as a decimal fraction.
feeSchedule.spotCrossstringBase spot taker fee rate as a decimal fraction.
feeSchedule.spotAddstringBase spot maker fee rate as a decimal fraction.
feeSchedule.tiersobjectVIP and market-maker tiers that adjust the base fee rates.
feeSchedule.referralDiscountstringReferral discount fraction available to eligible users.
feeSchedule.stakingDiscountTiers[]arrayStaking thresholds and associated fee-discount fractions.
userCrossRatestringCurrent perpetual taker fee rate after applicable discounts.
userAddRatestringCurrent perpetual maker fee rate after applicable discounts.
userSpotCrossRatestringCurrent spot taker fee rate after applicable discounts.
userSpotAddRatestringCurrent spot maker fee rate after applicable discounts.
activeReferralDiscountstringReferral discount fraction currently applied to user fees.
trialobject | nullFee-trial details, or null when no trial applies.
feeTrialRewardstringFee-trial reward amount, as a decimal string.
nextTrialAvailableTimestampinteger | nullTime in milliseconds when another trial may be available, or null.
stakingLinkobjectLink between this account and its staking account.
activeStakingDiscountobjectStaking-based discount currently applied to user fees.

{
  "dailyUserVlm": [
    {
      "date": "2025-05-23",
      "userCross": "0.0",
      "userAdd": "0.0",
      "exchange": "2852367.0770729999"
    }
  ],
  "feeSchedule": {
    "cross": "0.00045",
    "add": "0.00015",
    "spotCross": "0.0007",
    "spotAdd": "0.0004",
    "tiers": { "vip": [] },
    "referralDiscount": "0.04",
    "stakingDiscountTiers": []
  },
  "userCrossRate": "0.000315",
  "userAddRate": "0.000105",
  "userSpotCrossRate": "0.00049",
  "userSpotAddRate": "0.00028",
  "activeReferralDiscount": "0.0",
  "trial": null,
  "feeTrialReward": "0.0",
  "nextTrialAvailableTimestamp": null,
  "stakingLink": {
    "type": "tradingUser",
    "stakingUser": "0x54c049d9c7d3c92c2462bf3d28e083f3d6805061"
  },
  "activeStakingDiscount": {
    "bpsOfMaxSupply": "4.7577998927",
    "discount": "0.3"
  }
}
Was this page helpful?