Get Started
User Connections
- Profiles
- Referrals
Points Sources
- Off-Chain Points
- On-Chain Points
- Achievements
- Point Caps
- Banlist
Reward Distribution
Guides
- Track Questing Platforms
- Issue Off-Chain Points With Zapier
- Prepare Quest Leaderboard
- Discord Bot
- Setting A Custom Domain
- Custom API Profile Cards
- Setting Metadata
- Geoblocking The Portal
- Setting Privacy Policy & Terms of Service
Leaderboard API
Programatically Query Your Seasons Leaderboard
query GetLeaderBoardScores {
dagster_computed_aggregated_scores {
client_season
created_at
flags
group_id
rank
raw_total_points
referral_points
row_id
total_with_referral_points
leaderboard_identity_key
}
}
{
"data": {
"dagster_computed_aggregated_scores": [
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "095ff27a-b5e8-4939-85ae-189fdf32eb3d",
"rank": 1,
"raw_total_points": 138,
"referral_points": 151.8,
"row_id": "499c9532-98e5-4ddc-9c71-bf58abed4ab6",
"total_with_referral_points": 289.8,
"leaderboard_identity_key": "0xc0ffee254729296a45a3885639ac7e10f9d54979"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "4a5e3ed7-ad20-426b-8dd7-e7c080cf1389",
"rank": 2,
"raw_total_points": 138,
"referral_points": 0,
"row_id": "51922c0c-1e10-4c89-bf5f-e49a27485da5",
"total_with_referral_points": 138,
"leaderboard_identity_key": "0xcd2523e1ea097aec34dfff62312bf27568a17643"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "0x123",
"rank": null,
"raw_total_points": 1,
"referral_points": 0,
"row_id": "3354990d-bf06-4e36-ada7-c6e41e34d5a5",
"total_with_referral_points": 1,
"leaderboard_identity_key": "0xc684cCeD8ffcde53C73aaeB9B92F0eD8F7330b8b"
}
]
}
}
query GetLeaderBoardScores {
dagster_computed_aggregated_scores {
client_season
created_at
flags
group_id
rank
raw_total_points
referral_points
row_id
total_with_referral_points
leaderboard_identity_key
}
}
{
"data": {
"dagster_computed_aggregated_scores": [
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "095ff27a-b5e8-4939-85ae-189fdf32eb3d",
"rank": 1,
"raw_total_points": 138,
"referral_points": 151.8,
"row_id": "499c9532-98e5-4ddc-9c71-bf58abed4ab6",
"total_with_referral_points": 289.8,
"leaderboard_identity_key": "0xc0ffee254729296a45a3885639ac7e10f9d54979"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "4a5e3ed7-ad20-426b-8dd7-e7c080cf1389",
"rank": 2,
"raw_total_points": 138,
"referral_points": 0,
"row_id": "51922c0c-1e10-4c89-bf5f-e49a27485da5",
"total_with_referral_points": 138,
"leaderboard_identity_key": "0xcd2523e1ea097aec34dfff62312bf27568a17643"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "0x123",
"rank": null,
"raw_total_points": 1,
"referral_points": 0,
"row_id": "3354990d-bf06-4e36-ada7-c6e41e34d5a5",
"total_with_referral_points": 1,
"leaderboard_identity_key": "0xc684cCeD8ffcde53C73aaeB9B92F0eD8F7330b8b"
}
]
}
}
You can test-drive the API in our interactive graphql playground here.
You will need an API key to set in an authorization header. If you don’t have one yet, reach out to the Absinthe team here to get you one. Look at the points api docs to learn more.
Setting The Authorization Header
Before being able to introspect the schema through our interactive graphql playground or through a direct call, you will need to set the API key as an authorization header via this format:
{"Authorization": "Bearer <INSERT_KEY_HERE>"}
Endpoint URL
https://gql3.absinthe.network/v1/graphql
Leaderboard Details
The leaderboard refreshes every hour. Data may not appear immediately after insertion due to this refresh interval.
Your data pipeline needs to be enabled before data starts populating. Please contact the Absinthe team to ensure your data pipeline is live.
Field Explanations
A unique identifier for the specific season of the leaderboard.
The timestamp of the most recent leaderboard refresh.
A series of flags indicating if a user passes eligibility conditions. If eligibility conditions are not set or if the user passes all conditions, this field will be null.
The sum of points the user has earned, excluding referral points.
Points earned by the user through referrals or by using a referral code.
A unique identifier for each row entry in the leaderboard.
The total points used for leaderboard ranking, including both raw and referral points.
The user’s rank on the leaderboard. If eligibility conditions are defined and the user does not meet them, rank will be null and they won’t be included in the ranking.
The unique user_id of the user. For users who haven’t registered through a frontend, this will be their unaggregated identity (e.g., an EVM address).
The identity displayed in the leaderboard. If multiple identities are connected, the order of preference can be configured. Contact Absinthe when setting up your season to specify your preferred identity key order.
To configure eligibility conditions or set up your preferred leaderboard identity key order, please reach out to the Absinthe team.
query GetLeaderBoardScores {
dagster_computed_aggregated_scores {
client_season
created_at
flags
group_id
rank
raw_total_points
referral_points
row_id
total_with_referral_points
leaderboard_identity_key
}
}
{
"data": {
"dagster_computed_aggregated_scores": [
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "095ff27a-b5e8-4939-85ae-189fdf32eb3d",
"rank": 1,
"raw_total_points": 138,
"referral_points": 151.8,
"row_id": "499c9532-98e5-4ddc-9c71-bf58abed4ab6",
"total_with_referral_points": 289.8,
"leaderboard_identity_key": "0xc0ffee254729296a45a3885639ac7e10f9d54979"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "4a5e3ed7-ad20-426b-8dd7-e7c080cf1389",
"rank": 2,
"raw_total_points": 138,
"referral_points": 0,
"row_id": "51922c0c-1e10-4c89-bf5f-e49a27485da5",
"total_with_referral_points": 138,
"leaderboard_identity_key": "0xcd2523e1ea097aec34dfff62312bf27568a17643"
},
{
"client_season": "testseason",
"created_at": "2024-10-17T02:15:27.526678+00:00",
"flags": null,
"group_id": "0x123",
"rank": null,
"raw_total_points": 1,
"referral_points": 0,
"row_id": "3354990d-bf06-4e36-ada7-c6e41e34d5a5",
"total_with_referral_points": 1,
"leaderboard_identity_key": "0xc684cCeD8ffcde53C73aaeB9B92F0eD8F7330b8b"
}
]
}
}