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

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

Request Body required

application/json

key string REQUIRED

Ethereum wallet address (will be normalized to lowercase)

displayName string REQUIRED

Custom display name to set

signature string REQUIRED

EIP-191 signature of the display name message

signer string REQUIRED

Address that signed the message (must match key)

timestamp integer (int64) REQUIRED

Unix timestamp in seconds (must be within 10 minutes of current time)

Responses

200 Display name set successfully

application/json

success boolean

400 Bad Request - Invalid signature, timestamp, or authorization

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
}'

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);

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())

200 Response

{
  "success": true
}

400 Response

{
  "error": "<string>"
}

POST /display-name

Base URL

Request Body required application/json

Response

Was this page helpful?

Previous Set Profile Preference

Next Profile Lookup