Leaderboard

Fetching leaderboard data

Get all time total minted players

GET https://api-test.blocklords.io:81/nftrush/leaderboard/minted/alltime/:session_id

Returns list of wallet addresses, their rewards and positions

Path Parameters

Name	Type	Description
session_id	integer	The game event ID.

200 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 Problem with server. Database issue.

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error.

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}

Get today's total minted players

GET 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.

Path Parameters

Name	Type	Description
session_id	integer	Game event id

200 List of winners. Can be empty or nested array.

[
   [
      "0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
      9
   ],
   [
      "0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
      4
   ],
   ...
]

403 Problem with database

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}

Get day's total minted players

GET https://api-test.blocklords.io:81/nftrush/leaderboard/minted/day/:session_id/:date

Return list of winners for a specific day.

Path Parameters

Name	Type	Description
date	string	Date in format: yyyy-mm-dd
session_id	integer	Game event id

200 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 Database error

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}

Get all time total spent players

GET https://api-test.blocklords.io:81/nftrush/leaderboard/spent/alltime/:session_id

List of players who spent most CWS during the game event

Path Parameters

Name	Type	Description
session_id	integer	Game event ID

200 Either empty array, or array of arrays. Nested arrays can be up to 10

[
   [
      "0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
      9
   ],
   [
      "0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
      4
   ],
   ...
]

403 Database error

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}

Get today's total spent players

GET https://api-test.blocklords.io:81/nftrush/leaderboard/spent/today/:session_id

Path Parameters

Name	Type	Description
session_id	integer	Game event id

200 Can be empty array, or array of nested arrays, up to 10.

[
   [
      "0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
      9
   ],
   [
      "0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
      4
   ],
   ...
]

403 Database error

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}

Get day's total spent players

GET 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.

Path Parameters

Name	Type	Description
session_id	integer	Game event ID
date	string	Date in calendar in format: yyyy-mm-dd

200 Could be empty array, or array of the nested arrays. Nested up to 10 arrays.

[
   [
      "0x08302CF8648A961c607e3e7Bd7B7Ec3230c2A6c5",
      9
   ],
   [
      "0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0",
      4
   ],
   ...
]

403 Database error

{
   "error":"403 json to string convert error",
   "err_code":403
}

500 Internal error

{
   "error":"500 failed to get list of leaderboard data",
   "err_code":500
}