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
}

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