Skip to main content
GET
/
api
/
v1
/
points
/
tier
Get tier info for a user based on percentile-based thresholds
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/points/tier \
  --header 'Authorization: Bearer <token>'
{
  "owner": "<string>",
  "tiers": [
    {
      "hz_threshold": 123,
      "name": "<string>",
      "progress": 1
    }
  ],
  "total_amps": 123,
  "current_tier": "<string>",
  "rank": 1
}

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

owner
string
required

Owner wallet address

Response

Tier info with progress

Tier info response for a user

owner
string
required

Owner address

tiers
object[]
required

All tier thresholds with progress

total_amps
number<double>
required

User's total amps

current_tier
string | null

User's current tier (null if below gold)

rank
integer<int32> | null

User's rank (null if not on leaderboard)

Required range: x >= 0