curl -X POST 'https://api.serialized.xyz/v1/wallet/profile' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"address":"GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E"}]}'
{
"data": [
{
"data": {
"profile": {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"displayName": "vitalik.eth",
"avatarUrl": "https://pbs.twimg.com/profile_images/2042521108067352576/3rv2_9m1_normal.jpg",
"ensName": "vitalik.eth",
"basename": null,
"solName": null,
"bio": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
"socials": {
"twitter": "VitalikButerin",
"farcaster": "vitalik.eth",
"github": "vbuterin",
"website": "https://vitalik.ca/"
},
"followerCounts": {
"twitter": 7861864,
"farcaster": 536314
},
"isProTrader": false,
"isSmartTrader": false
},
"linkedWallets": [
"0xa6a54119b8d20219e6ffeb8026fb557651c3b9b6"
]
}
},
{
"data": {
"profile": null,
"linkedWallets": []
}
}
],
"meta": {
"asOf": 1787163134666
}
}
Wallet Profile
Wallet Profile: batch
Batch twin: up to 100 addresses per call, response array in input order. Each slot is { data } where data is the body of the single GET ({ profile, linkedWallets }), the same slot shape as every other batch endpoint. A wallet without a known identity comes back as { data: { profile: null, linkedWallets: [] } } (identities are harvested continuously - retry later, never assume permanent).
POST
/
v1
/
wallet
/
profile
curl -X POST 'https://api.serialized.xyz/v1/wallet/profile' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"address":"GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E"}]}'
{
"data": [
{
"data": {
"profile": {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"displayName": "vitalik.eth",
"avatarUrl": "https://pbs.twimg.com/profile_images/2042521108067352576/3rv2_9m1_normal.jpg",
"ensName": "vitalik.eth",
"basename": null,
"solName": null,
"bio": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
"socials": {
"twitter": "VitalikButerin",
"farcaster": "vitalik.eth",
"github": "vbuterin",
"website": "https://vitalik.ca/"
},
"followerCounts": {
"twitter": 7861864,
"farcaster": 536314
},
"isProTrader": false,
"isSmartTrader": false
},
"linkedWallets": [
"0xa6a54119b8d20219e6ffeb8026fb557651c3b9b6"
]
}
},
{
"data": {
"profile": null,
"linkedWallets": []
}
}
],
"meta": {
"asOf": 1787163134666
}
}
POST /v1/wallet/profile · 1 credit per 25 wallets
Batch twin: up to 100 addresses per call, response array in input order. Each slot is { data } where data is the body of the single GET ({ profile, linkedWallets }), the same slot shape as every other batch endpoint. A wallet without a known identity comes back as { data: { profile: null, linkedWallets: [] } } (identities are harvested continuously - retry later, never assume permanent). Billed 1 credit per 25 wallets served; the same address requested more than once counts as one wallet.
curl -X POST 'https://api.serialized.xyz/v1/wallet/profile' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"address":"GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E"}]}'
{
"data": [
{
"data": {
"profile": {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"displayName": "vitalik.eth",
"avatarUrl": "https://pbs.twimg.com/profile_images/2042521108067352576/3rv2_9m1_normal.jpg",
"ensName": "vitalik.eth",
"basename": null,
"solName": null,
"bio": "I choose balance. First-level balance.\n\nmi pinxe lo crino tcati\n\nhttps://t.co/gCQrmCby7P",
"socials": {
"twitter": "VitalikButerin",
"farcaster": "vitalik.eth",
"github": "vbuterin",
"website": "https://vitalik.ca/"
},
"followerCounts": {
"twitter": 7861864,
"farcaster": 536314
},
"isProTrader": false,
"isSmartTrader": false
},
"linkedWallets": [
"0xa6a54119b8d20219e6ffeb8026fb557651c3b9b6"
]
}
},
{
"data": {
"profile": null,
"linkedWallets": []
}
}
],
"meta": {
"asOf": 1787163134666
}
}
Body
application/json
Response
200
Standard { data, meta } envelope.