# Labeled Wallets & Programs

Access Vybe's comprehensive database of labeled Solana accounts—CEX wallets, project treasuries, KOLs, market makers, VCs, and more. This data transforms anonymous wallet addresses into actionable intelligence for whale tracking, flow analysis, and smart money alerts.

## Why Labeled Wallets Matter

On-chain data is powerful, but anonymous addresses are hard to interpret. Knowing that `9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM` is **Binance's hot wallet** changes everything:

* A large transfer *to* that address = potential sell pressure incoming
* A large transfer *from* that address = new demand entering the market
* Accumulation by that address = institutional interest

Vybe maintains a continuously updated database of thousands of labeled wallets, turning raw blockchain data into market intelligence.

***

## Endpoint

```
GET /wallets/known-accounts
```

***

## Parameters

| Parameter      | Type   | Description                                                             |
| -------------- | ------ | ----------------------------------------------------------------------- |
| `labels`       | array  | Filter by category: `CEX`, `KOL`, `DEFI`, `NFT`, `MM`, `VC`, `TREASURY` |
| `entityName`   | string | Filter by entity (e.g., "Binance")                                      |
| `ownerAddress` | string | Look up a specific address                                              |
| `name`         | string | Search by account name                                                  |

***

## Available Labels

| Label      | Description                       | Examples                     |
| ---------- | --------------------------------- | ---------------------------- |
| `CEX`      | Centralized exchanges             | Binance, Coinbase, Kraken    |
| `KOL`      | Key opinion leaders / influencers | Crypto Twitter personalities |
| `DEFI`     | DeFi protocol wallets             | Raydium treasury, Marinade   |
| `NFT`      | NFT project wallets               | Mad Lads treasury            |
| `MM`       | Market makers                     | Wintermute, Jump             |
| `VC`       | Venture capital                   | Multicoin, Polychain         |
| `TREASURY` | Project treasuries                | Protocol treasuries          |

***

## Example: Get All CEX Wallets

```bash
curl "https://api.vybenetwork.com/wallets/known-accounts?labels=CEX" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json
{
  "data": [
    {
      "ownerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "name": "Binance Hot Wallet 1",
      "entityName": "Binance",
      "labels": ["CEX"],
      "entityId": 1
    },
    {
      "ownerAddress": "2AQdpHJ2JpcEgPiATUXjQxA8QmafFegfQwSLWSprPicm",
      "name": "Coinbase Commerce",
      "entityName": "Coinbase",
      "labels": ["CEX"],
      "entityId": 2
    },
    {
      "ownerAddress": "H8sMJSCQxfKiFTCfDR3DUMLPwcRbM61LGFJ8N4dK3WjS",
      "name": "Kraken Hot Wallet",
      "entityName": "Kraken",
      "labels": ["CEX"],
      "entityId": 3
    }
  ]
}
```

***

## Example: Identify Unknown Wallet

Look up any wallet to see if it's a known entity:

```bash
curl "https://api.vybenetwork.com/wallets/known-accounts?ownerAddress=9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json
{
  "data": [
    {
      "ownerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "name": "Binance Hot Wallet 1",
      "entityName": "Binance",
      "labels": ["CEX"],
      "entityId": 1
    }
  ]
}
```

If the wallet isn't labeled, `data` will be empty.

***

## Common Use Cases

| Use Case                 | Implementation                            |
| ------------------------ | ----------------------------------------- |
| **CEX Flow Tracking**    | Monitor deposits/withdrawals to exchanges |
| **Smart Money Alerts**   | Follow KOL and VC wallet activity         |
| **Whale Identification** | Put names to large holders                |
| **Flow Analysis**        | Track where funds are moving              |
| **Copy Trading**         | Mirror successful KOL trades              |
| **Market Intelligence**  | Detect institutional activity             |

***

## CEX Flow Monitor

Track tokens flowing to and from exchanges—a key indicator of buy/sell pressure:

```javascript
async function monitorCEXFlows(tokenMint, minAmount = 10000) {
  // Step 1: Get all CEX wallets
  const cexResponse = await fetch(
    "https://api.vybenetwork.com/wallets/known-accounts?labels=CEX",
    { headers: { "X-API-Key": API_KEY } }
  );
  const { data: cexWallets } = await cexResponse.json();
  
  // Build lookup maps
  const cexAddresses = new Set(cexWallets.map(w => w.ownerAddress));
  const cexNames = Object.fromEntries(
    cexWallets.map(w => [w.ownerAddress, w.entityName])
  );
  
  // Step 2: Get recent transfers for this token
  const transfersResponse = await fetch(
    `https://api.vybenetwork.com/transfers?mintAddress=${tokenMint}&minAmount=${minAmount}&limit=100`,
    { headers: { "X-API-Key": API_KEY } }
  );
  const { data: transfers } = await transfersResponse.json();
  
  // Step 3: Categorize transfers
  const inflows = [];  // To CEX (potential sells)
  const outflows = []; // From CEX (potential buys)
  
  transfers.forEach(tx => {
    if (cexAddresses.has(tx.receiverAddress)) {
      inflows.push({
        ...tx,
        cex: cexNames[tx.receiverAddress],
        interpretation: "Potential sell incoming"
      });
    }
    if (cexAddresses.has(tx.senderAddress)) {
      outflows.push({
        ...tx,
        cex: cexNames[tx.senderAddress],
        interpretation: "Potential buy / withdrawal"
      });
    }
  });
  
  // Calculate totals
  const totalInflow = inflows.reduce((sum, tx) => sum + parseFloat(tx.amount), 0);
  const totalOutflow = outflows.reduce((sum, tx) => sum + parseFloat(tx.amount), 0);
  
  return {
    summary: {
      netFlow: totalOutflow - totalInflow > 0 ? "NET OUTFLOW (Bullish)" : "NET INFLOW (Bearish)",
      totalInflow: totalInflow.toLocaleString(),
      totalOutflow: totalOutflow.toLocaleString()
    },
    inflows,
    outflows
  };
}
```

***

## Smart Money Tracker

Follow what successful traders and VCs are doing:

```javascript
async function trackSmartMoney() {
  // Get KOL and VC wallets
  const [kolResponse, vcResponse] = await Promise.all([
    fetch("https://api.vybenetwork.com/wallets/known-accounts?labels=KOL", {
      headers: { "X-API-Key": API_KEY }
    }),
    fetch("https://api.vybenetwork.com/wallets/known-accounts?labels=VC", {
      headers: { "X-API-Key": API_KEY }
    })
  ]);
  
  const kols = await kolResponse.json();
  const vcs = await vcResponse.json();
  const smartMoney = [...kols.data, ...vcs.data];
  
  // Get recent trades for each (limit to prevent rate limiting)
  const recentActivity = await Promise.all(
    smartMoney.slice(0, 20).map(async wallet => {
      const trades = await fetch(
        `https://api.vybenetwork.com/trades?authorityAddress=${wallet.ownerAddress}&limit=10`,
        { headers: { "X-API-Key": API_KEY } }
      ).then(r => r.json());
      
      return {
        name: wallet.name,
        entity: wallet.entityName,
        label: wallet.labels[0],
        wallet: wallet.ownerAddress,
        recentTrades: trades.data
      };
    })
  );
  
  // Find tokens multiple smart money wallets are buying
  const tokenBuys = {};
  recentActivity.forEach(wallet => {
    wallet.recentTrades?.forEach(trade => {
      if (trade.side === 'buy') {
        if (!tokenBuys[trade.mintAddress]) {
          tokenBuys[trade.mintAddress] = {
            symbol: trade.symbol,
            buyers: []
          };
        }
        tokenBuys[trade.mintAddress].buyers.push(wallet.name);
      }
    });
  });
  
  // Tokens bought by multiple smart money wallets = interesting
  const hotTokens = Object.entries(tokenBuys)
    .filter(([_, data]) => data.buyers.length > 1)
    .map(([mint, data]) => ({
      mint,
      symbol: data.symbol,
      buyerCount: data.buyers.length,
      buyers: data.buyers
    }))
    .sort((a, b) => b.buyerCount - a.buyerCount);
  
  return {
    trackedWallets: smartMoney.length,
    recentActivity,
    hotTokens
  };
}
```

***

## Wallet Labeler

Add labels to your own wallet displays:

```javascript
async function enrichWalletData(walletAddress) {
  // Check if wallet is labeled
  const response = await fetch(
    `https://api.vybenetwork.com/wallets/known-accounts?ownerAddress=${walletAddress}`,
    { headers: { "X-API-Key": API_KEY } }
  );
  const { data } = await response.json();
  
  if (data.length > 0) {
    const label = data[0];
    return {
      address: walletAddress,
      isLabeled: true,
      name: label.name,
      entity: label.entityName,
      type: label.labels[0],
      displayName: `${label.name} (${label.entityName})`
    };
  }
  
  return {
    address: walletAddress,
    isLabeled: false,
    displayName: `${walletAddress.slice(0, 4)}...${walletAddress.slice(-4)}`
  };
}
```

***

## Related Endpoints

* [Token Transfers](../transaction-history/token-transfers.md) - Track movements
* [Top Traders](../trader-analytics/top-traders.md) - Performance-based discovery
* [Wallet PnL](../trader-analytics/wallet-pnl.md) - Analyze wallet performance