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>",
        "fromWalletMetadata": {
          "entityName": "<string>",
          "entityLogo": "<string>",
          "entityLabels": [
            "<string>"
          ],
          "entityType": "<string>",
          "entityDescription": "<string>",
          "entityTwitter": "<string>",
          "entityWebsite": "<string>",
          "entityGithub": "<string>",
          "entityDiscord": "<string>",
          "entityTelegram": "<string>",
          "extra": {}
        }
      }
    }
  ],
  "pagination": {
    "total": 123,
    "offset": 123,
    "limit": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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