Skip to main content
GET
/
2
/
wallet
/
labels
/
search
Search wallets by entity name, type, or label
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/labels/search
{
  "data": [
    {
      "walletAddress": "<string>",
      "labels": [
        "<string>"
      ],
      "walletMetadata": {
        "entityName": "<string>",
        "entityLogo": "<string>",
        "entityLabels": [
          "<string>"
        ],
        "entityType": "<string>",
        "entityDescription": "<string>",
        "entityTwitter": "<string>",
        "entityWebsite": "<string>",
        "entityGithub": "<string>",
        "entityDiscord": "<string>",
        "entityTelegram": "<string>"
      },
      "platform": {
        "id": "<string>",
        "name": "<string>",
        "logo": "<string>"
      },
      "fundingInfo": {
        "from": "<string>",
        "date": "<string>",
        "chainId": "<string>",
        "txHash": "<string>",
        "formattedAmount": 123,
        "currency": {
          "name": "<string>",
          "symbol": "<string>",
          "logo": "<string>",
          "decimals": 123,
          "address": "<string>"
        },
        "fromWalletTag": "<string>",
        "fromWalletLogo": "<string>"
      }
    }
  ],
  "pagination": {
    "total": 123,
    "offset": 123,
    "limit": 123
  }
}

Query Details

NameRequiredDescription
entityNameNoFuzzy search on entity name (e.g. binance, ansem)
entityTypeNoExact match on entity type (e.g. cex, dex, individual, fund, bridge)
labelNoExact match on wallet label (e.g. Hot Wallet, Cold Wallet, MEV Bot)
offsetNoPagination offset (default: 0)
limitNoResults per page, 1-100 (default: 20)
At least one of entityName, entityType, or label must be provided.

Usage Examples

  • Search by entity name
curl 'https://api.mobula.io/api/2/wallet/labels/search?entityName=binance'
  • Search by entity type
curl 'https://api.mobula.io/api/2/wallet/labels/search?entityType=cex&limit=10'
  • Search by label
curl 'https://api.mobula.io/api/2/wallet/labels/search?label=MEV%20Bot'
  • Combined filters with pagination
curl 'https://api.mobula.io/api/2/wallet/labels/search?entityType=cex&label=Hot%20Wallet&offset=0&limit=20'

Response Fields

FieldDescription
dataArray of matching wallets (same shape as /2/wallet/labels)
data[].walletAddressThe wallet address
data[].labelsArray of labels (proTrader, smartTrader, freshTrader, etc.)
data[].walletMetadataEntity metadata (name, logo, type, socials)
data[].platformPlatform metadata (id, name, logo) if linked to a known platform
data[].fundingInfoFunding source information for the wallet
pagination.totalTotal number of matching wallets
pagination.offsetCurrent offset
pagination.limitCurrent page size

Available Entity Types

Common entity types: cex, dex, individual, fund, bridge, mev, hacker, yield, lending-decentralized, derivatives, gaming, liquid-staking, stablecoin, ai, misc, zora-profile.

Available Labels

Common labels: Hot Wallet, Cold Wallet, MEV Bot, Gnosis Safe Proxy, V2 Pool, V3 Pool, Market, Burn Address, Dead Address, Gate Deposit.

Query Parameters

entityName
string
entityType
string
label
string
offset
number | null
default:0
Required range: x >= 0
limit
number
default:20
Required range: 1 <= x <= 100

Response

200 - application/json

Wallet labels search response

data
object[]
required
pagination
object
required