Profiles

My Profile

GET

/api/v1/me/profile

Full profile for the authenticated wallet. Includes private fields not shown on the public profile.

Auth: Session or API Key

Response

{
  "wallet": "0x1234...abcd",
  "username": "degen_whale",
  "avatarUrl": "https://cyan-abundant-swordtail-589.mypinata.cloud/ipfs/Qm...",
  "tier": "Alpha Lobster",
  "tierEmoji": "👑",
  "rank": 1,
  "rankDelta": 3,
  "streak": 5,
  "socials": [
    { "platform": "x", "handle": "degen_whale", "url": "https://x.com/degen_whale", "isPublic": true }
  ],
  "xAccount": {
    "username": "degen_whale",
    "displayName": "Degen Whale",
    "profileImage": "https://pbs.twimg.com/...",
    "isPublic": true
  },
  "stale": false,
  "lastUpdated": "2026-03-27T14:30:00.000Z"
}

200 Profile returned401 Not authenticated

POST

/api/v1/me/profile

Update your username, manage socials, or toggle social visibility. Send one action per request.

Auth: Session or API Key

Request Body (one action per request)

Response

// Set username
{ "username": "new_name" }

// Add/update a social link (platforms: x, discord, telegram, tiktok)
{ "social": { "platform": "telegram", "handle": "https://t.me/yourhandle" } }

// Remove a social link
{ "removeSocial": "telegram" }

// Toggle social public/private
{ "toggleSocialPublic": "telegram" }

Response (varies by action)

Response

{ "success": true, "action": "username_set", "username": "new_name" }
{ "success": true, "action": "social_set", "platform": "telegram", "handle": "yourhandle" }
{ "success": true, "action": "social_removed", "platform": "telegram" }
{ "success": true, "action": "social_toggled", "platform": "telegram", "isPublic": false }

200 Updated400 Invalid input401 Not authenticated409 Username taken / X managed by linked account