Skip to content

A player's public profile

GET
/api/users/{address}
curl --request GET \
--url https://foxleague.ai/api/users/example

Answers the public profile of one wallet. The team fields are null for a wallet without a team.

Who: anyone.

Refusals:

  • User not found: no account has this wallet.
address
required
string

The wallet address (erd1...).

Success or a refusal: read success (the refusals are in the description).

Media type application/json
object
code

A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.

string | null
data

The answer. Present when success is true.

object
active_title

The title shown on the profile, such as Tournament Champion; null when none.

string | null
badge

The team badge (see Team.badge); null without a team.

string | null
developer_team_name

The name of the player’s active developer team; null when none.

string | null
elo_rating
required

ELO rating, lifetime.

integer format: int32
id
required

User id.

integer format: int32
is_developer
required

true when the player has an active developer team.

boolean
league
required

Bronze, Silver, Gold, Platinum or Diamond.

string
matches_drawn
required

Matches drawn. On the leaderboard with a window, only within it.

integer format: int32
matches_lost
required

Matches lost. On the leaderboard with a window, only within it.

integer format: int32
matches_won
required

Matches won. On the leaderboard with a window, only within it.

integer format: int32
player_count
required

Player cards the wallet holds. 0 means the team cannot play.

integer format: int32
team_name

The team name; null for a wallet without a team.

string | null
tournament_wins
required

Tournaments won.

integer format: int32
username

Display name; null when none.

string | null
verified
required

true when the team carries the verified mark.

boolean
wallet_address
required

The wallet address.

string
error

Why the request was refused, in plain words. Present when success is false.

string | null
success
required

true when the request did what it asked. false is a refusal: read error.

boolean
Example
{
"data": {
"active_title": "Tournament Champion",
"badge": "ipfs://bafybeihkoviema7g3gxyt6la7vd5ho32ictqbilu3wnlo3rs7ewhnp7lly",
"developer_team_name": null,
"elo_rating": 1734,
"id": 412,
"is_developer": false,
"league": "Gold",
"matches_drawn": 12,
"matches_lost": 31,
"matches_won": 58,
"player_count": 24,
"team_name": "Fox Rovers",
"tournament_wins": 2,
"username": null,
"verified": false,
"wallet_address": "erd15feryxhrdz9m6y09mr8wrerwzgj6f8ntxvhxyrdlm5aahn0t09nl4ujy86"
},
"success": true
}