curl -X POST 'https://api.serialized.xyz/v1/wallet/labels' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u"},{"address":"0xd13da05b9288ba4961973110594bd0fe3428791f"},{"address":"not-a-wallet"}]}'
{
"data": [
{
"data": {
"address": "3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u",
"labels": [
"whale"
],
"labelTokens": {
"checked": 50,
"sniper": 0,
"bundler": 0,
"whale": 8,
"insider": 0
},
"entity": null,
"platform": null,
"funding": {
"chain": "solana",
"funder": {
"address": "5VCwKtCXgCJ6kit5FybXjvriW3xELsFDhYrPSqtJNmcD",
"name": "OKX",
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg",
"entity": {
"name": "OKX",
"type": "cex",
"labels": [
"custody"
],
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg"
}
},
"fundedAt": 1634019095000,
"txHash": "3TN6yZK7z9gUhKU8XXxhJdN3uDY5FRqGZeMY2rSZMKxUGENMtnwiF8KxhrgcNZfvey8da9BRRNcFgtSVKQNxDmCe",
"amountNative": "3000000000",
"amount": 3,
"currency": {
"symbol": "SOL",
"name": "Solana",
"decimals": 9,
"logo": "https://cdn.serialized.xyz/dex/coin-sol.c107b7bd.png",
"address": "So11111111111111111111111111111111111111112"
}
},
"profile": null,
"linkedWallets": []
}
},
{
"data": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"labels": [
"smartTrader"
],
"labelTokens": null,
"entity": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"funding": {
"chain": "evm:8453",
"funder": {
"address": "0x20fe51a9229eef2cf8ad9e89d91cab9312cf3b7a",
"name": "Coinbase",
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png",
"entity": {
"name": "Coinbase",
"type": null,
"labels": [],
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png"
}
},
"fundedAt": 1722264859000,
"txHash": "0xb0634b8a6581f0ce99b8cb6ac8f986fb290cb9c34641c4197d8d56c30586ffff",
"amountNative": "49999990000000000",
"amount": 0.04999999,
"currency": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"logo": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png",
"address": "0x0000000000000000000000000000000000000000"
}
},
"profile": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"displayName": null,
"avatarUrl": null,
"ensName": null,
"basename": null,
"solName": null,
"bio": null,
"socials": null,
"followerCounts": null,
"isProTrader": false,
"isSmartTrader": true
},
"linkedWallets": []
}
},
{
"error": {
"code": "INVALID_PARAM",
"message": "Invalid address \"not-a-wallet\": expected a base58 Solana address"
}
}
],
"meta": {
"asOf": 1794357470820
}
}
Wallet Labels
Wallet Labels: batch
Batch twin: the labels of up to 100 wallets in one call, EVM and Solana mixed freely. Response in input order, one slot per wallet, billed 2 credits per 25 wallets.
POST
/
v1
/
wallet
/
labels
curl -X POST 'https://api.serialized.xyz/v1/wallet/labels' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u"},{"address":"0xd13da05b9288ba4961973110594bd0fe3428791f"},{"address":"not-a-wallet"}]}'
{
"data": [
{
"data": {
"address": "3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u",
"labels": [
"whale"
],
"labelTokens": {
"checked": 50,
"sniper": 0,
"bundler": 0,
"whale": 8,
"insider": 0
},
"entity": null,
"platform": null,
"funding": {
"chain": "solana",
"funder": {
"address": "5VCwKtCXgCJ6kit5FybXjvriW3xELsFDhYrPSqtJNmcD",
"name": "OKX",
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg",
"entity": {
"name": "OKX",
"type": "cex",
"labels": [
"custody"
],
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg"
}
},
"fundedAt": 1634019095000,
"txHash": "3TN6yZK7z9gUhKU8XXxhJdN3uDY5FRqGZeMY2rSZMKxUGENMtnwiF8KxhrgcNZfvey8da9BRRNcFgtSVKQNxDmCe",
"amountNative": "3000000000",
"amount": 3,
"currency": {
"symbol": "SOL",
"name": "Solana",
"decimals": 9,
"logo": "https://cdn.serialized.xyz/dex/coin-sol.c107b7bd.png",
"address": "So11111111111111111111111111111111111111112"
}
},
"profile": null,
"linkedWallets": []
}
},
{
"data": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"labels": [
"smartTrader"
],
"labelTokens": null,
"entity": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"funding": {
"chain": "evm:8453",
"funder": {
"address": "0x20fe51a9229eef2cf8ad9e89d91cab9312cf3b7a",
"name": "Coinbase",
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png",
"entity": {
"name": "Coinbase",
"type": null,
"labels": [],
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png"
}
},
"fundedAt": 1722264859000,
"txHash": "0xb0634b8a6581f0ce99b8cb6ac8f986fb290cb9c34641c4197d8d56c30586ffff",
"amountNative": "49999990000000000",
"amount": 0.04999999,
"currency": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"logo": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png",
"address": "0x0000000000000000000000000000000000000000"
}
},
"profile": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"displayName": null,
"avatarUrl": null,
"ensName": null,
"basename": null,
"solName": null,
"bio": null,
"socials": null,
"followerCounts": null,
"isProTrader": false,
"isSmartTrader": true
},
"linkedWallets": []
}
},
{
"error": {
"code": "INVALID_PARAM",
"message": "Invalid address \"not-a-wallet\": expected a base58 Solana address"
}
}
],
"meta": {
"asOf": 1794357470820
}
}
POST /v1/wallet/labels · 2 credits per 25 wallets
Batch twin: the labels of up to 100 wallets in one call, EVM and Solana mixed freely, response in input order. Each slot is { data }, the body of the single GET for that wallet, or { error: { code, message } } for that address alone: an invalid address never fails the others. Send { "items": [{ "address": "…" }] }, 1 to 100 items. Billed 2 credits per 25 wallets served: up to 25 wallets cost 2 credits, 26 to 50 cost 4, and so on; an address sent twice counts once, and a slot in error is not billed.
A slot’s
data is exactly what GET /v1/wallet/labels returns for that wallet: address, labels, labelTokens, entity, funding, profile and linkedWallets; see that page for the fields.curl -X POST 'https://api.serialized.xyz/v1/wallet/labels' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"address":"3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u"},{"address":"0xd13da05b9288ba4961973110594bd0fe3428791f"},{"address":"not-a-wallet"}]}'
{
"data": [
{
"data": {
"address": "3b3zfYBQ61sEicY4bhQMKUvRo9bAxPYAz32uyAP9Cj9u",
"labels": [
"whale"
],
"labelTokens": {
"checked": 50,
"sniper": 0,
"bundler": 0,
"whale": 8,
"insider": 0
},
"entity": null,
"platform": null,
"funding": {
"chain": "solana",
"funder": {
"address": "5VCwKtCXgCJ6kit5FybXjvriW3xELsFDhYrPSqtJNmcD",
"name": "OKX",
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg",
"entity": {
"name": "OKX",
"type": "cex",
"labels": [
"custody"
],
"logo": "https://pbs.twimg.com/profile_images/1968722816154345472/vEj4j3o9_normal.jpg"
}
},
"fundedAt": 1634019095000,
"txHash": "3TN6yZK7z9gUhKU8XXxhJdN3uDY5FRqGZeMY2rSZMKxUGENMtnwiF8KxhrgcNZfvey8da9BRRNcFgtSVKQNxDmCe",
"amountNative": "3000000000",
"amount": 3,
"currency": {
"symbol": "SOL",
"name": "Solana",
"decimals": 9,
"logo": "https://cdn.serialized.xyz/dex/coin-sol.c107b7bd.png",
"address": "So11111111111111111111111111111111111111112"
}
},
"profile": null,
"linkedWallets": []
}
},
{
"data": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"labels": [
"smartTrader"
],
"labelTokens": null,
"entity": null,
"platform": {
"id": "uniswap",
"name": "Uniswap",
"logo": "https://cdn.serialized.xyz/dex/platform-uniswap.c096b59c.png"
},
"funding": {
"chain": "evm:8453",
"funder": {
"address": "0x20fe51a9229eef2cf8ad9e89d91cab9312cf3b7a",
"name": "Coinbase",
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png",
"entity": {
"name": "Coinbase",
"type": null,
"labels": [],
"logo": "https://pbs.twimg.com/profile_images/2069440039612719104/m-UOfXvz_normal.png"
}
},
"fundedAt": 1722264859000,
"txHash": "0xb0634b8a6581f0ce99b8cb6ac8f986fb290cb9c34641c4197d8d56c30586ffff",
"amountNative": "49999990000000000",
"amount": 0.04999999,
"currency": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"logo": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png",
"address": "0x0000000000000000000000000000000000000000"
}
},
"profile": {
"address": "0xd13da05b9288ba4961973110594bd0fe3428791f",
"displayName": null,
"avatarUrl": null,
"ensName": null,
"basename": null,
"solName": null,
"bio": null,
"socials": null,
"followerCounts": null,
"isProTrader": false,
"isSmartTrader": true
},
"linkedWallets": []
}
},
{
"error": {
"code": "INVALID_PARAM",
"message": "Invalid address \"not-a-wallet\": expected a base58 Solana address"
}
}
],
"meta": {
"asOf": 1794357470820
}
}
Body
application/json
Response
200
Standard { data, meta } envelope.