Skip to main content
The Get Wallet Labels endpoint returns wallet labels for one or more wallet addresses across blockchains like Solana, Ethereum and more, and can optionally return labels in the context of a specific token. It is ideal for developers building wallet scoring, trader discovery, copy-trading tools, alpha dashboards, and on-chain profiling systems.

​
What this endpoint does

With this API, you can:
  • Retrieve wallet labels for one or multiple wallets
  • Detect trading-style labels like proTrader, smartTrader, freshTrader, sniper, insider, bundler, and more
  • Optionally provide a token address to get labels in the context of that token
  • Use the output to power wallet profiling, filtering, and ranking in your product
Unlike raw wallet stats, this endpoint gives you a high-level “wallet classification” that’s easier to use in UIs and scoring logic.

​
What you’ll need

  • Basic knowledge of REST APIs
  • A wallet address
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener + a block explorer to find active wallets and token contract addresses

​
When to use Get Wallet Labels

Use this endpoint when you want to:
  • Identify “smart money” style wallets and trading behavior
  • Label wallets for discovery (leaderboards, filtering, tagging systems)
  • Build trader profiles (pro trader vs fresh trader vs sniper)
  • Add wallet classification to dashboards or wallet analytics products
  • Run wallet screening before copying trades or tracking addresses
If you want wallet swaps only, use wallet/trades.
If you want wallet activity feeds, use wallet/activity.

​
Walkthrough — Get Wallet Labels for a Wallet

​
1. Prepare your query

The wallet/labels endpoint requires one parameter to work:
ParameterDescription
walletAddressesRequired. A string or array of wallet addresses
tokenAddressOptional. If set, returns labels in the context of that token

​
2. Find a wallet address to test

To retrieve real wallet data:
  1. Open DexScreener
  2. Open any token page
  3. Go to the Transactions (or traders activity) section
  4. Pick a recent transaction and copy the signer wallet address
This address is used in walletAddresses.

​
3. (Optional) Find a token address to label by token context

If you want token-specific label context:
  • On the same DexScreener token page, copy the token contract address
This address is used as tokenAddress.

​
4. Fill the API form

In the Mobula docs “Try it” form:
  • Paste your wallet(s) into walletAddresses
  • (Optional) paste the token contract into tokenAddress
  • Click Send

​
Reviewing the wallet labels response

The response returns labels for the wallet(s) you submitted. What you should expect:
  • A list of label outputs per wallet
  • Labels can include classifications like: proTrader, smartTrader, freshTrader, sniper, insider, bundler, etc.
  • If you provided tokenAddress, labels are returned with token context

​
Try It Live with Mobula Wallet Labels Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Wallet Labels Demo UI Docs

​
Summary

The Get Wallet Labels endpoint helps you classify wallets with trader-style labels, including:
  • Wallet labels like proTrader, smartTrader, freshTrader, sniper, insider, bundler
  • Optional token-context labeling with tokenAddress
  • Support for multiple wallet inputs via walletAddresses
If you’re building wallet discovery, trader scoring, or profiling tools, this endpoint is a clean way to enrich wallets with actionable labels.

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here