Skip to main content
GET
/
api
/
v1
/
user_fee_rates
Get user fees and fee schedule
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/user_fee_rates \
  --header 'Authorization: Bearer <token>'
{
  "account": "<string>",
  "active_referral_discount": 123,
  "daily_user_volume": [
    {
      "date": "<string>",
      "maker_volume": "<string>",
      "taker_volume": "<string>",
      "volume": "<string>"
    }
  ],
  "fee_schedule": {
    "maker": 123,
    "referral_discount": 123,
    "taker": 123,
    "tiers": {
      "market_maker": [
        {
          "maker": 123,
          "maker_fraction_threshold": "<string>"
        }
      ],
      "vip": [
        {
          "maker": 123,
          "taker": 123,
          "volume_threshold": "<string>"
        }
      ]
    }
  },
  "fee_tier": 1,
  "user_maker_rate": 123,
  "user_taker_rate": 123
}

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.

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.

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
object[]
required

Daily volume breakdown for the current on-chain fee window (ascending date order)

fee_schedule
object
required

Fee schedule mirroring the current on-chain default tiers (all tiers)

fee_tier
integer<int64>
required

User's current fee tier index (0 = base tier)

Required range: x >= 0
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)