Profile Lookup

Retrieves aggregated profile information for a given address or name. Combines data from multiple Web3 identity sources including ENS, Lens, Farcaster, and Basement profiles.

GET /
Retrieves aggregated profile information for a given address or name. Combines data from multiple Web3 identity sources including ENS, Lens, Farcaster, and Basement profiles.

Query Parameters

address string optional query
Ethereum wallet address to lookup (e.g., 0x1234567890abcdef1234567890abcdef12345678)
name string optional query
Username or ENS name to lookup (e.g., vitalik.eth, username.b3.fun)
fresh boolean optional query
Skip cache and fetch fresh data
b3GlobalId string optional query
B3 Global ID to lookup (e.g., c0fd88a3-0589-41d5-8834-d6ae782f675e)

Responses

200 Successful profile lookup
application/json
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
Array of:
type string REQUIRED
Profile source type
Enum: ensdata, basement, b3-ens, thirdweb-farcaster, thirdweb-lens, global-account
address string | null
Wallet address associated with this profile
name string | null
Name or username from this source
avatar string | null
Avatar URL from this source
bio string | null
Bio/description from this source
displayName string | null
Display name from this source
userId string | null
B3 Global Account user ID (only present for global-account profile type)
400 Bad Request - Missing required parameters
404 Profile not found 
curl -X GET 'https://profiles.b3.fun/'
const response = await fetch('https://profiles.b3.fun/', {
  method: 'GET'
});

const data = await response.json();
console.log(data);
import requests

response = requests.get('https://profiles.b3.fun/')
print(response.json())
200 Response 
{
  "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>"
    }
  ]
}
GET /
Previous Decode logs and transactions​
Next Set Profile Preference
Ask a question... ⌘I