Skip to main content

Overview

The Webacy API categorizes blockchain addresses into label types to help identify the nature and purpose of addresses.

Primary Label Types

TypeDescription
cexCentralized Exchange
dexDecentralized Exchange
operatorChain Operations (validators, miners)
chadminChain Administration
defiDecentralized Finance Applications
nftNFT Contracts & Applications
bridgeLayer 2/Alt L1 Bridge Dapps
dappDecentralized Applications
gamesGaming Dapps
tokenToken Contracts
flotsamJunk or Uncategorized

Label Subtypes

Centralized Exchange (cex)

SubtypeDescription
hot_walletAddresses that collect funds from deposits, send withdrawals
deposit_walletExchange deposit addresses
cold_walletRarely-used fund storage
chadminExchange administration
contract_deployerContract creation contracts
general_contractGeneral-purpose contracts
multisigMulti-signature wallets
token_contractExchange-owned tokens

Decentralized Exchange (dex)

SubtypeDescription
swap_contractToken exchange facilitation
token_contractDEX-associated tokens
poolFarming, staking, liquidity pools
vaultDEX-controlled vaults
fee_walletFee collection
daoDAO control addresses
chadminAdministrative addresses
contract_deployerContract creators
foundationFoundation addresses
governanceGovernance contracts
rewardsReward distribution
strategyStrategy contracts
token_distributionToken distribution contracts
token_saleToken sale contracts
general_contractGeneral contracts
multisigMulti-signature wallets

Operator

SubtypeDescription
validatorAddresses that run nodes and validate blocks
mining_poolKnown mining pools
solo_minerIndividual block reward recipients

Chain Admin (chadmin)

SubtypeDescription
genesisMint/burn addresses
foundationChain foundation addresses
general_contractOther chadmin contracts

DeFi

SubtypeDescription
token_contractDeFi tokens
poolLiquidity pools
vaultVaults
fee_walletFee collection
daoDAO addresses
votingVoting contracts
chadminAdmin addresses
contract_deployerContract deployers
treasuryTreasury addresses
governanceGovernance contracts
rewardsReward contracts
oraclePrice oracles
token_saleToken sales
general_contractGeneral contracts
multisigMulti-sig wallets

NFT

SubtypeDescription
token_contractFungible tokens
nf_token_contractNFT contracts
contract_deployerContract deployers
fee_contractFee contracts
marketplaceNFT marketplaces
general_contractGeneral contracts

Flotsam (Risky/Junk)

SubtypeDescription
toxicScams, attacks, malicious addresses
OtherUncategorized addresses

Using Labels in Risk Assessment

Labels provide context for risk evaluation:
function assessRisk(address, labels) {
  // Known exchanges are generally lower risk
  if (labels.type === 'cex' && labels.subtype === 'hot_wallet') {
    return 'low';
  }

  // Toxic flotsam is high risk
  if (labels.type === 'flotsam' && labels.subtype === 'toxic') {
    return 'high';
  }

  return 'medium';
}

Response Example

{
  "address": "0x...",
  "labels": {
    "type": "cex",
    "subtype": "hot_wallet",
    "name": "Binance",
    "confidence": 0.99
  }
}
Need more granular labels? Contact our team at [email protected] to discuss custom label solutions.