> ## 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. # Search Wallet Labels > Reverse lookup - find wallets by entity name, entity type, or label. Paginated results with full wallet metadata. ### Query Details | Name | Required | Description | | ------------ | -------- | ------------------------------------------------------------------------------ | | `entityName` | No | Fuzzy search on entity name (e.g. `binance`, `ansem`) | | `entityType` | No | Exact match on entity type (e.g. `cex`, `dex`, `individual`, `fund`, `bridge`) | | `label` | No | Exact match on wallet label (e.g. `Hot Wallet`, `Cold Wallet`, `MEV Bot`) | | `offset` | No | Pagination offset (default: 0) | | `limit` | No | Results per page, 1-100 (default: 20) | At least one of `entityName`, `entityType`, or `label` must be provided. ### Usage Examples * Search by entity name ```bash theme={null} curl 'https://api.mobula.io/api/2/wallet/labels/search?entityName=binance' ``` * Search by entity type ```bash theme={null} curl 'https://api.mobula.io/api/2/wallet/labels/search?entityType=cex&limit=10' ``` * Search by label ```bash theme={null} curl 'https://api.mobula.io/api/2/wallet/labels/search?label=MEV%20Bot' ``` * Combined filters with pagination ```bash theme={null} curl 'https://api.mobula.io/api/2/wallet/labels/search?entityType=cex&label=Hot%20Wallet&offset=0&limit=20' ``` ### Response Fields | Field | Description | | ----------------------- | ---------------------------------------------------------------- | | `data` | Array of matching wallets (same shape as `/2/wallet/labels`) | | `data[].walletAddress` | The wallet address | | `data[].labels` | Array of labels (proTrader, smartTrader, freshTrader, etc.) | | `data[].walletMetadata` | Entity metadata (name, logo, type, socials) | | `data[].platform` | Platform metadata (id, name, logo) if linked to a known platform | | `data[].fundingInfo` | Funding source information for the wallet | | `pagination.total` | Total number of matching wallets | | `pagination.offset` | Current offset | | `pagination.limit` | Current 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`. ## OpenAPI ````yaml get /2/wallet/labels/search openapi: 3.0.0 info: version: 1.0.0 title: Mobula API description: >- Documentation of the Mobula API **Demo API**: The default server (demo-api.mobula.io) is a demo API with rate limits. For production use, please use api.mobula.io with an API key from https://admin.mobula.io servers: - url: https://demo-api.mobula.io/api/ description: Demo API (rate limited, for testing only) - url: https://api.mobula.io/api/ description: Production API (requires API key) security: [] tags: - name: V2 - Token description: Token details, price, security, ATH, and holder data - name: V2 - Market Data description: Market details, OHLCV history, and lighthouse metrics - name: V2 - Trades description: Token trades, enriched trades, and trade filters - name: V2 - Wallet description: Wallet positions, activity, trades, analysis, and labels - name: V2 - Assets description: Cross-chain asset details and price history - name: V2 - Swap description: Swap quoting and execution - name: V2 - Perps description: Perpetual futures quoting, execution, and positions - name: V2 - Bridge description: Cross-chain bridge quoting and intent status (Alpha Preview) - name: V2 - DeFi description: Bonding pools and pulse data - name: V2 - Search description: Universal fast search - name: V2 - Blockchains description: System metadata and chain listings - name: V1 - Market Data description: Market prices, history, sparklines, pairs, and multi-data - name: V1 - Wallet description: Wallet portfolio, transactions, history, and NFTs - name: V1 - Token description: First buyers - name: V1 - Trades description: Market trades by pair - name: V1 - Metadata description: Token metadata, categories, trendings, and news - name: V1 - Assets description: List all assets - name: V1 - Search description: Search for assets, tokens, and pairs - name: V1 - DeFi description: Bonding pool pulse data - name: V1 - Blockchains description: Blockchain listings, pairs, and stats - name: V1 - Webhooks description: Webhook management - name: V1 - Feed description: Custom feed creation paths: /2/wallet/labels/search: get: tags: - V2 - Wallet summary: Search wallets by entity name, type, or label description: >- Reverse lookup: find wallets by entity name (fuzzy), entity type (exact), or label (exact). Returns paginated results with wallet metadata, labels, and funding info. parameters: - schema: type: string required: false name: entityName in: query - schema: type: string required: false name: entityType in: query - schema: type: string required: false name: label in: query - schema: type: number nullable: true minimum: 0 default: 0 required: false name: offset in: query - schema: type: number minimum: 1 maximum: 100 default: 20 required: false name: limit in: query responses: '200': description: Wallet labels search response content: application/json: schema: type: object properties: data: type: array items: type: object properties: walletAddress: type: string labels: type: array items: type: string walletMetadata: type: object nullable: true properties: entityName: type: string nullable: true entityLogo: type: string nullable: true entityLabels: type: array items: type: string entityType: type: string nullable: true entityDescription: type: string nullable: true entityTwitter: type: string nullable: true entityWebsite: type: string nullable: true entityGithub: type: string nullable: true entityDiscord: type: string nullable: true entityTelegram: type: string nullable: true required: - entityName - entityLogo - entityLabels - entityType - entityDescription - entityTwitter - entityWebsite - entityGithub - entityDiscord - entityTelegram platform: type: object nullable: true properties: id: type: string name: type: string logo: type: string required: - id - name - logo fundingInfo: type: object nullable: true properties: from: type: string nullable: true date: type: string nullable: true chainId: type: string nullable: true txHash: type: string nullable: true formattedAmount: type: number nullable: true currency: type: object nullable: true properties: name: type: string symbol: type: string logo: type: string nullable: true decimals: type: number address: type: string required: - name - symbol - logo - decimals - address fromWalletTag: type: string nullable: true fromWalletLogo: type: string nullable: true fromWalletMetadata: type: object nullable: true properties: entityName: type: string nullable: true entityLogo: type: string nullable: true entityLabels: type: array items: type: string entityType: type: string nullable: true entityDescription: type: string nullable: true entityTwitter: type: string nullable: true entityWebsite: type: string nullable: true entityGithub: type: string nullable: true entityDiscord: type: string nullable: true entityTelegram: type: string nullable: true extra: type: object additionalProperties: nullable: true required: - entityName - entityLogo - entityLabels - entityType - entityDescription - entityTwitter - entityWebsite - entityGithub - entityDiscord - entityTelegram required: - from - date - chainId - txHash - formattedAmount - currency - fromWalletTag - fromWalletLogo required: - walletAddress - labels pagination: type: object properties: total: type: number offset: type: number limit: type: number required: - total - offset - limit required: - data - pagination ````