GET
/
Profile Lookup
curl --request GET \
  --url https://profiles.b3.fun/
{
  "name": "<string>",
  "address": "<string>",
  "avatar": "<string>",
  "bio": "<string>",
  "displayName": "<string>",
  "profiles": [
    {
      "type": "ensdata",
      "address": "<string>",
      "name": "<string>",
      "avatar": "<string>",
      "bio": "<string>",
      "displayName": "<string>",
      "userId": "<string>"
    }
  ]
}

Query Parameters

​
address
string

Ethereum wallet address to lookup (e.g., 0x1234567890abcdef1234567890abcdef12345678)

​
name
string

Username or ENS name to lookup (e.g., vitalik.eth, username.b3.fun)

​
fresh
boolean
default:false

Skip cache and fetch fresh data

​
b3GlobalId
string

B3 Global ID to lookup (e.g., c0fd88a3-0589-41d5-8834-d6ae782f675e)

Response

Successful profile lookup

Aggregated profile data from multiple Web3 identity sources

​
name
string | null

Primary name or username (ENS name, Basement username, etc.)

​
address
string | null

Normalized Ethereum wallet address

​
avatar
string | null

Profile avatar URL from preferred source

​
bio
string | null

Profile bio/description from preferred source

​
displayName
string | null

Display name from preferred source or custom user setting. Falls back to 'name' if not set.

​
profiles
object[]

Array of all profile data from different sources