Profile and Settings

Manage your user profile, preferences, and public visibility through the profile API.

Viewing Your Profile

GET /api/v1/users/me

Returns your full profile including name, nickname, email, language, theme, avatar URL, referral code, and wallet balances. Requires authentication.

Updating Your Profile

PUT /api/v1/users/me

Send only the fields you want to change:

{
  "name": "Jane Doe",
  "nickname": "janedoe",
  "language": "en",
  "theme": "dark",
  "profile_hidden": false
}

Field	Type	Description
name	string	Your display name.
nickname	string	A unique handle used in your public profile URL.
language	string	Interface language: en (English) or ru (Russian).
theme	string	UI theme: light or dark.
profile_hidden	boolean	When true, your profile is hidden from other users.

Checking Nickname Availability

Before setting a nickname, you can verify it is not already taken:

GET /api/v1/users/nickname/available?nickname=janedoe

Returns a boolean indicating whether the nickname is available.

Avatar Management

Uploading an Avatar

POST /api/v1/users/me/avatar

Send the image as a multipart form upload. The image is stored in Cloudflare R2, and the resulting URL is saved to your profile.

Removing Your Avatar

DELETE /api/v1/users/me/avatar

Removes your current avatar and reverts to the default.

Public Profiles

Any user can view another user's public profile (unless that user has set profile_hidden to true):

• By user ID: GET /api/v1/users/{id}
• By nickname: GET /api/v1/users/by_nickname/{nickname}

Public profiles display the user's name, nickname, avatar, and trading statistics. Sensitive information such as email and wallet details is never exposed.

Summary of Endpoints

Method	Endpoint	Auth	Description
GET	/api/v1/users/me	Required	Get your own profile
PUT	/api/v1/users/me	Required	Update profile fields
POST	/api/v1/users/me/avatar	Required	Upload avatar image
DELETE	/api/v1/users/me/avatar	Required	Remove avatar
GET	/api/v1/users/nickname/available	Required	Check nickname availability
GET	/api/v1/users/{id}	Optional	View user profile by ID
GET	/api/v1/users/by_nickname/{nickname}	Optional	View user profile by nickname