> ## Documentation Index > Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt > Use this file to discover all available pages before exploring further. # Get user fees and fee schedule > 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. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/user_fee_rates openapi: 3.1.0 info: title: Decibel Trading API description: >- RESTful API for Decibel. Provides read-only endpoints for market data, trading operations, positions, and analytics. contact: name: Decibel Team url: https://decibel.trade/ license: name: '' version: 1.0.0 servers: - url: https://api.mainnet.aptoslabs.com/decibel description: Mainnet - url: https://api.testnet.aptoslabs.com/decibel description: Testnet security: - bearerAuth: [] tags: - name: Market Data description: Market information and real-time data endpoints - name: User description: User information and account management - name: Account description: Account-specific endpoints and data - name: Trades description: Trading operations and history - name: Positions description: User position management - name: Orders description: Order management and history - name: TWAP description: Time-weighted average price orders - name: Bulk Orders description: Bulk order management - name: Vaults description: Vault operations and management - name: Analytics description: Analytics and performance metrics - name: Points description: Points-related account metrics - name: Trading Points description: Trading points endpoints - name: Trading Hz description: Trading Hz endpoints - name: Tier description: Tier information endpoints - name: Streaks description: User streak tracking endpoints - name: Predeposit Rewards description: Season 0 predeposit USDC rewards - name: Referrals description: Referral code management and tracking - name: Affiliates description: Affiliate code and earnings endpoints paths: /api/v1/user_fee_rates: get: tags: - Account summary: Get user fees and fee schedule description: >- 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. operationId: handle_user_fees parameters: - name: account in: query description: User account address (`user` query alias is also accepted) required: true schema: type: string responses: '200': description: User fee information retrieved content: application/json: schema: $ref: '#/components/schemas/UserFeesDto' '400': description: Invalid account address '500': description: Database error components: schemas: UserFeesDto: type: object description: >- Response for `GET /api/v1/user_fee_rates?account=
`. Returns the user's current fee tier, effective rates (after referral discount), the full fee schedule, and their fee-window daily volume history. required: - account - daily_user_volume - fee_schedule - user_taker_rate - user_maker_rate - fee_tier - active_referral_discount properties: account: type: string description: The queried account address active_referral_discount: type: number format: double description: >- Active referral discount fraction (0.0 if user has no referral or referrals disabled) daily_user_volume: type: array items: $ref: '#/components/schemas/DailyUserVolumeDto' description: >- Daily volume breakdown for the current on-chain fee window (ascending date order) fee_schedule: $ref: '#/components/schemas/FeeScheduleDto' description: >- Fee schedule mirroring the current on-chain default tiers (all tiers) fee_tier: type: integer format: int64 description: User's current fee tier index (0 = base tier) minimum: 0 user_maker_rate: type: number format: double description: User's effective maker rate after referral discount (decimal number) user_taker_rate: type: number format: double description: User's effective taker rate after referral discount (decimal number) DailyUserVolumeDto: type: object description: Per-day trading volume entry for the current on-chain fee window. required: - date - volume - maker_volume - taker_volume properties: date: type: string description: Date in YYYY-MM-DD format (UTC) maker_volume: type: string description: Maker-side volume (USD, whole-dollar integer string) taker_volume: type: string description: Taker-side volume (USD, whole-dollar integer string) volume: type: string description: Total volume (USD, whole-dollar integer string) FeeScheduleDto: type: object description: >- Fee schedule mirroring the current on-chain default tiers, including all thresholds. This is hardcoded server-side and is not fetched authoritatively from chain. required: - taker - maker - tiers - referral_discount properties: maker: type: number format: double description: >- Base maker fee (tier 0, no volume requirement). Decimal number, e.g. 0.000110 referral_discount: type: number format: double description: >- Referral discount fraction applied to referred users (e.g. 0.04 = 4% discount). 0.0 when referrals are disabled. taker: type: number format: double description: >- Base taker fee (tier 0, no volume requirement). Decimal number, e.g. 0.000340 tiers: $ref: '#/components/schemas/FeeTiersDto' description: All fee tiers above the base FeeTiersDto: type: object description: Grouped fee tier schedules. required: - vip - market_maker properties: market_maker: type: array items: $ref: '#/components/schemas/MarketMakerTierDto' description: Market-maker rebate tiers (empty when rebates are disabled) vip: type: array items: $ref: '#/components/schemas/VipTierDto' description: >- Volume-based VIP tiers (tiers 1–N; tier 0 rates are in the parent FeeScheduleDto) MarketMakerTierDto: type: object description: >- A single market-maker rebate tier. Users must provide at least `maker_fraction_threshold` of total global volume as maker to qualify (inclusive, matches on-chain `>=` logic). required: - maker_fraction_threshold - maker properties: maker: type: number format: double description: Maker rebate rate (negative decimal number, e.g. -0.000010) maker_fraction_threshold: type: string description: >- Fraction of global volume the user must provide as maker (decimal string, e.g. "0.005") VipTierDto: type: object description: >- A single VIP (volume-based) fee tier. Users must have at least `volume_threshold` USD in on-chain fee-window volume to qualify (inclusive, matches on-chain logic). required: - volume_threshold - taker - maker properties: maker: type: number format: double description: Maker fee rate at this tier (decimal number, e.g. 0.000090) taker: type: number format: double description: Taker fee rate at this tier (decimal number, e.g. 0.000300) volume_threshold: type: string description: >- Minimum fee-window USD volume (inclusive) to reach this tier — matches on-chain `>=` comparison securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer token from Geomi. See [Authentication](/api-reference/rest/authentication) for setup instructions. ````