Skip to main content
GET
/
api
/
v1
/
points_leaderboard
Get points leaderboard
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/points_leaderboard \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "bonus_amps": 123,
      "owner": "<string>",
      "rank": 1,
      "realized_pnl": 123,
      "referral_amps": 123,
      "streak_amps": 123,
      "total_amps": 123,
      "vault_amps": 123
    }
  ],
  "total_count": 1
}

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

limit
integer<int32>
default:10

Page size

Required range: 0 <= x <= 1000
offset
integer<int32>
default:0

Page offset

Required range: 0 <= x <= 10000
sort_key
enum<string>
Available options:
total_amps,
realized_pnl
sort_dir
enum<string>
Available options:
ASC,
DESC
search_term
string

Optional search term to filter by owner address prefix

tier
enum<string>

Optional tier filter Tier filter for points leaderboard

Available options:
top20,
diamond,
doublePlatinum,
gold

Response

Paginated points leaderboard entries with rankings

items
object[]
required

The items in the current page

total_count
integer<int32> | null

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Required range: x >= 0