> ## 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.

# Set Custom Display Name

Allows users to set a custom display name that takes priority over display names from all profile sources through cryptographic signature verification.

` POST /display-name `

Set Custom Display Name

Allows users to set a custom display name that takes priority over display names from all profile sources through cryptographic signature verification.

## Servers

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

## Request body (required)

Content type: ` application/json `

- ` value `: type ` object ` — Request to set custom display name

  - Required fields: ` key `, ` displayName `, ` signature `, ` signer `, ` timestamp `

  - ` key `: type ` string ` — Ethereum wallet address (will be normalized to lowercase)

  - ` displayName `: type ` string ` — Custom display name to set

  - ` signature `: type ` string ` — EIP-191 signature of the display name message

  - ` signer `: type ` string ` — Address that signed the message (must match key)

  - ` timestamp `: type ` integer `; format ` int64 ` — Unix timestamp in seconds (must be within 10 minutes of current time)

## Responses

### ` 200 ` — Display name set successfully

Content type: ` application/json `

- ` value `: type ` object `

  - ` success `: type ` boolean `

    - example: ` true `

### ` 400 ` — Bad Request - Invalid signature, timestamp, or authorization

Content type: ` application/json `

- ` value `: type ` object `

  - Required fields: ` error `

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

## Request examples

### cURL

```curl
curl -X POST 'https://profiles.b3.fun/display-name' \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "string",
  "displayName": "string",
  "signature": "string",
  "signer": "string",
  "timestamp": 0
}'
```

### JavaScript

```javascript
const response = await fetch('https://profiles.b3.fun/display-name', {
  method: 'POST',
  headers: {
      "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "string",
    "displayName": "string",
    "signature": "string",
    "signer": "string",
    "timestamp": 0
  })
});

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

### Python

```python
import requests

response = requests.post('https://profiles.b3.fun/display-name', json={
  "key": "string",
  "displayName": "string",
  "signature": "string",
  "signer": "string",
  "timestamp": 0
})
print(response.json())
```