GET /api/v1/users/by_nickname/{nickname}

Returns the public profile of a user by their unique nickname. Behaves identically to Get User but accepts a nickname string instead of a numeric ID.

Authentication

None required. This is a public endpoint.

Request

Path Parameters

Parameter	Type	Required	Description
nickname	string	Yes	The user's unique nickname

Example

curl -X GET https://intotes.com/api/v1/users/by_nickname/alice_bet \
  -H "Authorization: Bearer <token>"

Response

200 OK

{
  "id": 42,
  "name": "Alice",
  "nickname": "alice_bet",
  "profile_hidden": false,
  "avatar_url": "https://cdn.intotes.com/avatars/42.jpg",
  "positions": [],
  "closed_positions": [],
  "closed_positions_has_more": false,
  "total_predictions": 12,
  "biggest_win": 8500,
  "registered_date": "2025-06-15"
}

If profile_hidden is true, only id, name, nickname, profile_hidden, and avatar_url are returned.

Response Fields

Field	Type	Description
id	int64	User ID
name	string	Display name
nickname	string	Unique username (nullable)
profile_hidden	bool	Whether the user has hidden their profile
avatar_url	string	URL of the user's avatar image
positions	array	Open positions with details
closed_positions	array	Closed positions with details
total_predictions	int64	Total number of closed positions
biggest_win	int64	Largest PnL win in kopecks
registered_date	string	Registration date in YYYY-MM-DD format

Errors

Status	Code	Description
400	invalid_nickname	The provided nickname is not valid
404	user_not_found	No user exists with this nickname