> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 / `

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.

## Servers

- ` https://profiles.b3.fun ` — Production server

## Parameters

### ` address ` (query, optional)

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

- ` value `: type ` string `

  - pattern: ` "^0x[a-fA-F0-9]{40}$" `

### ` name ` (query, optional)

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

- ` value `: type ` string `

### ` fresh ` (query, optional)

Skip cache and fetch fresh data

- ` value `: type ` boolean `

  - default: ` false `

### ` b3GlobalId ` (query, optional)

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

- ` value `: type ` string `

## Responses

### ` 200 ` — Successful profile lookup

Content type: ` application/json `

- ` value `: type ` object ` — Aggregated profile data from multiple Web3 identity sources

  - ` name `: type ` string `; nullable — Primary name or username (ENS name, Basement username, etc.)

  - ` address `: type ` string `; nullable — Normalized Ethereum wallet address

  - ` avatar `: type ` string `; nullable — Profile avatar URL from preferred source

  - ` bio `: type ` string `; nullable — Profile bio/description from preferred source

  - ` displayName `: type ` string `; nullable — Display name from preferred source or custom user setting. Falls back to 'name' if not set.

  - ` profiles `: type ` array ` — Array of all profile data from different sources

    - ` array item `: type ` object ` — Profile data from a specific source

      - Required fields: ` type `

      - ` type `: type ` string ` — Profile source type

        - enum: ` ["ensdata","basement","b3-ens","thirdweb-farcaster","thirdweb-lens","global-account"] `

      - ` address `: type ` string `; nullable — Wallet address associated with this profile

      - ` name `: type ` string `; nullable — Name or username from this source

      - ` avatar `: type ` string `; nullable — Avatar URL from this source

      - ` bio `: type ` string `; nullable — Bio/description from this source

      - ` displayName `: type ` string `; nullable — Display name from this source

      - ` userId `: type ` string `; nullable — B3 Global Account user ID (only present for global-account profile type)

### ` 400 ` — Bad Request - Missing required parameters

Content type: ` application/json `

- ` value `: type ` object `

  - Required fields: ` error `

  - ` error `: type ` string ` — Error message describing what went wrong

### ` 404 ` — Profile not found

## Request examples

### cURL

```curl
curl -X GET 'https://profiles.b3.fun/'
```

### JavaScript

```javascript
const response = await fetch('https://profiles.b3.fun/', {
  method: 'GET'
});

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

### Python

```python
import requests

response = requests.get('https://profiles.b3.fun/')
print(response.json())
```