Skip to content

Get Tag Info

POST
/v4/web3/tag-info

Resolve a Holyheld tag to its public display information before initiating an on-chain flow.

Authorizations

ApiKeyAuth
Type
API Key (header: X-Api-Key)

Request Body

application/json
JSON
{
"tag": "SDKTEST"
}

Responses

OK

application/json
JSON
{
"status": "ok",
"payload": {
"avatarSrc": "https://cdn.example.com/avatar.png",
"tagName": "SDKTEST"
}
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI

Code examples

bash
curl -X POST https://api.brrr.network/v4/web3/tag-info \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tag": "SDKTEST"
  }'
javascript
const response = await fetch('https://api.brrr.network/v4/web3/tag-info', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.BRRR_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tag: 'SDKTEST',
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(`Tag lookup failed: ${error.errorCode}`);
}

const data = await response.json();
console.log('Tag info:', data.payload);
python
import os
import httpx

response = httpx.post(
    'https://api.brrr.network/v4/web3/tag-info',
    headers={
        'X-Api-Key': os.environ['BRRR_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'tag': 'SDKTEST',
    },
)
response.raise_for_status()
print('Tag info:', response.json()['payload'])