Leaderboard

Fetching leaderboard data

get
Get all time total minted players

https://api-test.blocklords.io:81/nftrush/leaderboard/minted/alltime/:session_id
Returns list of wallet addresses, their rewards and positions
Request
Response
Request
Path Parameters
session_id
required
integer
The game event ID.
Response
200: OK
List of winners successfully retrieved. It can be empty or can have up-to 10 players. The properties of list items: First parameter is player's wallet address. Second parameter is it's minted nft's amount
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Problem with server. Database issue.
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error.
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}

get
Get today's total minted players

https://api-test.blocklords.io:81/nftrush/leaderboard/minted/today/:session_id
Returns list of wallet address, their rewards and options for today. Today by UTC timezone (GMT+0), London time.
Request
Response
Request
Path Parameters
session_id
required
integer
Game event id
Response
200: OK
List of winners. Can be empty or nested array.
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Problem with database
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}

get
Get day's total minted players

https://api-test.blocklords.io:81/nftrush/leaderboard/minted/day/:session_id/:date
Return list of winners for a specific day.
Request
Response
Request
Path Parameters
date
required
string
Date in format: yyyy-mm-dd
session_id
required
integer
Game event id
Response
200: OK
List of winners successfully retrieved. It can be empty or can have up-to 10 players. The properties of list items: First parameter is player's wallet address. Second parameter is it's minted nft's amount
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Database error
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}

get
Get all time total spent players

https://api-test.blocklords.io:81/nftrush/leaderboard/spent/alltime/:session_id
List of players who spent most CWS during the game event
Request
Response
Request
Path Parameters
session_id
required
integer
Game event ID
Response
200: OK
Either empty array, or array of arrays. Nested arrays can be up to 10
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Database error
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}

get
Get today's total spent players

https://api-test.blocklords.io:81/nftrush/leaderboard/spent/today/:session_id
Request
Response
Request
Path Parameters
session_id
required
integer
Game event id
Response
200: OK
Can be empty array, or array of nested arrays, up to 10.
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Database error
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}

get
Get day's total spent players

https://api-test.blocklords.io:81/nftrush/leaderboard/spent/day/s:ession_id/:date
Return list of players by spent CWS amount for specific date.
Request
Response
Request
Path Parameters
session_id
required
integer
Game event ID
date
required
string
Date in calendar in format: yyyy-mm-dd
Response
200: OK
Could be empty array, or array of the nested arrays. Nested up to 10 arrays.
[
[
"0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
9
],
[
"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
4
],
...
]
403: Forbidden
Database error
{
"error":"403 json to string convert error",
"err_code":403
}
500: Internal Server Error
Internal error
{
"error":"500 failed to get list of leaderboard data",
"err_code":500
}