---
title: "Get user fees and fee schedule"
method: GET
path: "/api/v1/user_fee_rates"
tags: ["Account"]
---

# Get user fees and fee schedule

`GET /api/v1/user_fee_rates`

Returns the user's current maker/taker fee rates, fee tier based on the on-chain fee window,
the full fee schedule for all VIP tiers, and daily volume history for that same window.

Fee rates are decimal numbers where 0.000340 = 0.034%.
Volume values are in whole USD. Volume data has up to 5-minute delay (MV refresh interval).
The current on-chain fee window includes today plus the previous 30 UTC calendar days.

## Query parameters

- `account` string, required

## Response `200`

User fee information retrieved

- UserFeesDto — 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.
  - `account` string, required — The queried account address
  - `active_referral_discount` number, double, required — Active referral discount fraction (0.0 if user has no referral or referrals disabled)
  - `daily_user_volume` DailyUserVolumeDto[], required — Daily volume breakdown for the current on-chain fee window (ascending date order)
    - `date` string, required — Date in YYYY-MM-DD format (UTC)
    - `maker_volume` string, required — Maker-side volume (USD, whole-dollar integer string)
    - `taker_volume` string, required — Taker-side volume (USD, whole-dollar integer string)
    - `volume` string, required — Total volume (USD, whole-dollar integer string)
  - `fee_schedule` FeeScheduleDto, required — Fee schedule mirroring the current on-chain default tiers, including all thresholds. This is hardcoded server-side and is not fetched authoritatively from chain.
    - `maker` number, double, required — Base maker fee (tier 0, no volume requirement). Decimal number, e.g. 0.000110
    - `referral_discount` number, double, required — Referral discount fraction applied to referred users (e.g. 0.04 = 4% discount). 0.0 when referrals are disabled.
    - `taker` number, double, required — Base taker fee (tier 0, no volume requirement). Decimal number, e.g. 0.000340
    - `tiers` FeeTiersDto, required — Grouped fee tier schedules.
      - `market_maker` MarketMakerTierDto[], required — Market-maker rebate tiers (empty when rebates are disabled)
        - `maker` number, double, required — Maker rebate rate (negative decimal number, e.g. -0.000010)
        - `maker_fraction_threshold` string, required — Fraction of global volume the user must provide as maker (decimal string, e.g. "0.005")
      - `vip` VipTierDto[], required — Volume-based VIP tiers (tiers 1–N; tier 0 rates are in the parent FeeScheduleDto)
        - `maker` number, double, required — Maker fee rate at this tier (decimal number, e.g. 0.000090)
        - `taker` number, double, required — Taker fee rate at this tier (decimal number, e.g. 0.000300)
        - `volume_threshold` string, required — Minimum fee-window USD volume (inclusive) to reach this tier — matches on-chain `>=` comparison
  - `fee_tier` integer, required — User's current fee tier index (0 = base tier)
  - `user_maker_rate` number, double, required — User's effective maker rate after referral discount (decimal number)
  - `user_taker_rate` number, double, required — User's effective taker rate after referral discount (decimal number)

## Other responses

- `400` — Invalid account address
- `500` — Database error

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/revisions/37a02083ff59/schema)