HTTP API reference › GalaSwap DEX › leaderboard

GalaSwap DEX — leaderboard

4 operations in this group.

• GET /leaderboard — Get leaderboard for a season
• GET /leaderboard/seasons — Get all leaderboard seasons
• GET /leaderboard/{wallet}/position/{seasonId} — Get user position in leaderboard
• GET /leaderboard/{wallet}/breakdown/{seasonId} — Get user breakdown in leaderboard

GET /leaderboard

LeaderboardController_getLeaderboard

Get leaderboard for a season

Get the leaderboard for a specific season.

Parameters

Name	In	Required	Type	Description
seasonId	query	required	number	The unique identifier for the leaderboard season

Responses

200 —

Content type: application/json

Schema: LeaderboardResponseDto

Field	Type	Required	Description
leaderboard	array<LeaderboardEntryResponseDto>	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /leaderboard/seasons

LeaderboardController_getLeaderboardSeasons

Get all leaderboard seasons

Get a list of all available leaderboard seasons.

Responses

200 —

Content type: application/json

Schema: array<LeaderboardSeasonResponseDto>

Field	Type	Required	Description
items.id	number	yes
items.name	string	yes
items.start	string (date-time)	yes
items.end	string (date-time)	yes
items.rules_id	number	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /leaderboard/{wallet}/position/{seasonId}

LeaderboardController_getUserPosition

Get user position in leaderboard

Get the rank and position of a user in a specific season.

Parameters

Name	In	Required	Type	Description
wallet	path	required	string
seasonId	path	required	number

Responses

200 —

Content type: application/json

Schema: LeaderboardUserPositionResponseDto

Field	Type	Required	Description
position	number nullable	yes
details	nullable LeaderboardUserPositionDetailsResponseDto oneOf: LeaderboardUserPositionDetailsResponseDto | object nullable enum:	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

GET /leaderboard/{wallet}/breakdown/{seasonId}

LeaderboardController_getUserBreakdown

Get user breakdown in leaderboard

Get a detailed breakdown of a user's score in a specific season.

Parameters

Name	In	Required	Type	Description
wallet	path	required	string
seasonId	path	required	number
page	query	optional	number
limit	query	optional	number

Responses

200 —

Content type: application/json

Schema: LeaderboardUserBreakdownResponseDto

Field	Type	Required	Description
details	nullable LeaderboardWalletDetailResponseDto oneOf: LeaderboardWalletDetailResponseDto | object nullable enum:	yes
rewards	LeaderboardRewardPageResponseDto	yes

default — An error response using the shared backend error envelope.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
status	integer	yes
error	boolean	yes
message	string	yes
errorKey	string	no

Example response

[]

---

Previous group: coin-gecko · Next group: pairs