Wallet labels

What a wallet is known to be (creator, insider, sniper, smart money, bot, fresh), the rule behind each label, and where labels appear.

Every row that names a wallet carries its labels, read the same way everywhere. Each label comes from indexed data by a stated rule. No outside list is used: none that is trustworthy covers BSC and Solana wallets, and a stale or guessed list would be wrong data.

Label	Rule
`creator`	Created a token Aurelia saw created: a launchpad's creation event named it. All indexed time.
`insider`	In the last 30 days, bought a launched token (not its creator) in its creation transaction, or on Solana in its creation slot: in the same bundle as the launch. On BSC also: bought it within 600 blocks (about 4.5 minutes) of its creation after receiving BNB from its creator. One such buy is enough.
`sniper`	In the last 30 days, first bought at least 3 different launched tokens within about 4 seconds of their creation, and was not an insider there: Solana slots 1–10 after the creation slot, BSC blocks 0–9 from the creation block, outside the creation transaction. A person clicking through an interface does not buy that fast; three times is a habit.
`smart_money`	Over the last 30 days: realized PnL of at least $10,000 over at least 10 tokens with a realized result, at least half of them winners, and not a bot. The figures are those of the analysis over `30d`, quote tokens left out.
`bot`	At least 3,500 swaps in the last 7 days: 500 a day, one every three minutes around the clock.
`fresh`	Its first funding was less than 7 days ago. Known only once its funding is: the portfolio reads it on request, so a wallet never looked up is not `fresh`. Never inferred from when Aurelia first saw a wallet.

When they appear

A worker derives each launch's creator, insiders and snipers every minute, once the blocks of its window are indexed, and rebuilds every label and the wallet rankings every 15 minutes. A label appears at the first rebuild after the data it rests on is indexed. A rollback takes back what it derived from the dropped blocks.

Where

In every list of wallets: trades (the trader), traders, holders, portfolios (the wallet and its funder), a token's creator, activity (the counterparty of a transfer), and on the socket.
As a filter: label= on /trades and /tokens/:chain/:address/traders.
As discovery: GET /wallets?label= ranks the labeled wallets by PnL, volume or win rate. fresh is not ranked: it rests on funding read on request.

Top snipers by 30-day volume, captured on a test instance:

curl -s 'https://app.aurelia.build/api/wallets?chains=evm:56&label=sniper&sort=volume30d&limit=2'
{
  "chains": [
    "evm:56"
  ],
  "label": "sniper",
  "sort": "volume30d",
  "rankedAt": 1790618277000,
  "wallets": [
    {
      "chain": "evm:56",
      "wallet": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
      "labels": [
        "sniper",
        "fresh"
      ],
      "pnl7dUsd": 59.80025976621041,
      "pnl30dUsd": 59.80025976621041,
      "volume30dUsd": 1068,
      "winRate30d": 1,
      "wins30d": 1,
      "losses30d": 0,
      "swaps7d": 22
    },
    {
      "chain": "evm:56",
      "wallet": "0x000000000000000000000000000000000000a00c",
      "labels": [
        "sniper"
      ],
      "pnl7dUsd": 23.812869219293884,
      "pnl30dUsd": 23.812869219293884,
      "volume30dUsd": 180,
      "winRate30d": 1,
      "wins30d": 1,
      "losses30d": 0,
      "swaps7d": 14
    }
  ],
  "next": null
}

Try it in the interactive docs Create a free account