Returns a wallet's rank, points and per-position breakdown
curl --request GET \
--url https://api.yieldpoint.io/v1/leaderboard/{season}/{address}const options = {method: 'GET'};
fetch('https://api.yieldpoint.io/v1/leaderboard/{season}/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.yieldpoint.io/v1/leaderboard/{season}/{address}"
response = requests.get(url)
print(response.text){
"season": 123,
"asOf": "<string>",
"totalParticipants": 123,
"user": "<string>",
"rank": 123,
"totalPoints": 123,
"dailyRate": 123,
"breakdown": [
{
"position": "hold_uty",
"multiplier": 123,
"valueUsd": 123,
"dailyPoints": 123,
"totalPoints": 123
}
]
}Leaderboard
Get wallet rank
One wallet’s rank, points, and per-position breakdown for a season.
GET
/
v1
/
leaderboard
/
{season}
/
{address}
Returns a wallet's rank, points and per-position breakdown
curl --request GET \
--url https://api.yieldpoint.io/v1/leaderboard/{season}/{address}const options = {method: 'GET'};
fetch('https://api.yieldpoint.io/v1/leaderboard/{season}/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.yieldpoint.io/v1/leaderboard/{season}/{address}"
response = requests.get(url)
print(response.text){
"season": 123,
"asOf": "<string>",
"totalParticipants": 123,
"user": "<string>",
"rank": 123,
"totalPoints": 123,
"dailyRate": 123,
"breakdown": [
{
"position": "hold_uty",
"multiplier": 123,
"valueUsd": 123,
"dailyPoints": 123,
"totalPoints": 123
}
]
}Returns the wallet’s rank and points for the season, with a
breakdown row per position. rank is null when the wallet has no points in the season; totalPoints is then 0 and breakdown is empty. totalParticipants is the number of ranked wallets, so rank is always between 1 and totalParticipants when present.
Each breakdown row reports the position’s multiplier in force on asOf, its valueUsd on asOf summed across chains, the dailyPoints it earned on asOf, and the totalPoints it earned over the season. The wallet-level dailyRate and totalPoints are the sums of those columns.
The address must be a 0x-prefixed 40-character hex string and is case-insensitive. Anything else returns 400. See API overview.
curl https://api.yieldpoint.io/v1/leaderboard/s2/0x1111111111111111111111111111111111111111
Path Parameters
The wallet address
Season, as "s" followed by the season number
Example:
"s2"
Response
200 - application/json
Last closed New York day in the points tables
Number of ranked wallets
null when the wallet has no points
Show child attributes
Show child attributes