> ## 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.

# Get Token Logo Reuses

> List the other tokens reusing this token's logo — byte-identical logo file detection for copycat / impersonation screening.

### Query Details

This endpoint returns the OTHER tokens whose logo is the **byte-identical file** as the queried token's logo (matched on the sha256 hash of the original logo bytes — not perceptual similarity). A popular token's logo being reused across many freshly-minted tokens is a strong copycat / impersonation signal.

| Parameter | Required | Description                                                                   |
| --------- | -------- | ----------------------------------------------------------------------------- |
| `chainId` | Yes      | Blockchain chain ID (e.g., `evm:56`, `solana:solana`).                        |
| `address` | Yes      | Token contract / mint address.                                                |
| `limit`   | No       | Max number of reusing tokens returned per page. 1–100, default `20`.          |
| `cursor`  | No       | Opaque cursor from a previous response's `nextCursor` to fetch the next page. |

<Note>
  `count` is the total number of other tokens sharing the logo, capped at `1001` (read `1001` as "1000+"). It is `0` when the logo is unique — or when the token's logo hasn't been hashed yet. Tokens are ranked by 24h volume descending, so the "real" token typically comes first and the copycats trail behind.
</Note>

***

### Response Overview

Top-level `data` object:

* **count**: Number of OTHER tokens sharing this logo (the queried token itself is excluded). Capped at `1001`.
* **tokens**: Array of reusing tokens, ranked by `volume24hUSD` descending.
* **nextCursor**: Opaque cursor for the next page, or `null` when there are no more results.

Each `tokens[i]`:

* **address** / **chainId**: The reusing token's address and chain ID.
* **name** / **symbol**: Token metadata, `null` if unknown.
* **logo**: URL of the (shared) logo file.
* **volume24hUSD**: 24h trading volume in USD, `null` if unknown.
* **priceUSD**: Current price in USD, `null` if unknown.
* **marketCapUSD** / **marketCapDilutedUSD**: Market cap from circulating / total supply, `null` if not computable.
* **createdAt**: Token creation time in milliseconds since epoch, `null` if unknown.

### Usage Examples

**Check a Solana token for logo copycats (GET):**

```bash theme={null}
curl -X GET "https://api.mobula.io/api/2/token/logo-reuses?chainId=solana:solana&address=6VW37HKxpTtYidHCCmKTZZEYswhPdbicQuVaqzsypump"
```

**Paginate further with the cursor:**

```bash theme={null}
curl -X GET "https://api.mobula.io/api/2/token/logo-reuses?chainId=solana:solana&address=6VW37HKxpTtYidHCCmKTZZEYswhPdbicQuVaqzsypump&limit=50&cursor=eyJ2IjowLCJjIjoi..."
```

#### Sample Response

```json theme={null}
{
  "data": {
    "count": 8,
    "tokens": [
      {
        "address": "0x3a33b54df04abee852b66dad5e7379f6371f2074",
        "chainId": "evm:4663",
        "name": "bul",
        "symbol": "BUL",
        "logo": "https://metadata.mobula.io/assets/logos/evm_4663_0x3a33b54df04abee852b66dad5e7379f6371f2074.webp",
        "volume24hUSD": 0,
        "priceUSD": 0.0000034685682119902066,
        "marketCapUSD": 3468.5682119902067,
        "marketCapDilutedUSD": 3468.5682119902067,
        "createdAt": 1787152548000
      },
      {
        "address": "3ZcohvqqB9sMTFp1zAiv52yJ4M35fnz4wc9on9GXpump",
        "chainId": "solana:solana",
        "name": "bul",
        "symbol": "BUL",
        "logo": "https://metadata.mobula.io/assets/logos/solana_solana_3ZcohvqqB9sMTFp1zAiv52yJ4M35fnz4wc9on9GXpump.webp",
        "volume24hUSD": 0,
        "priceUSD": 0.000014693921615830631,
        "marketCapUSD": 14693.921615830632,
        "marketCapDilutedUSD": 14693.921615830632,
        "createdAt": 1787152536000
      }
    ],
    "nextCursor": "eyJ2IjowLCJjIjoic29sYW5hOnNvbGFuYSIsImEiOiIzWmNvaHZxcUI5c01URnAxekFpdjUyeUo0TTM1Zm56NHdjOW9uOUdYcHVtcCIsIm4iOjh9"
  }
}
```

### Error Responses

**404 — Token not found:**

```json theme={null}
{ "statusCode": 404, "message": "Token not found" }
```

**400 — Missing address:**

```json theme={null}
{ "statusCode": 400, "message": "Address is required for logo reuses" }
```

**400 — Malformed cursor:**

```json theme={null}
{ "statusCode": 400, "message": "Invalid cursor" }
```

### Use Cases

* **Copycat detection**: flag freshly-minted tokens hijacking an established token's logo.
* **Pre-trade due diligence**: verify you're buying the original — the highest-volume token in the list is usually the real one.
* **Listing / moderation pipelines**: auto-deprioritize tokens whose logo matches hundreds of others (placeholder or spam art).
* **Cross-chain impersonation**: reuses are matched across ALL chains Mobula indexes, catching copycats deployed on a different chain than the original.


## OpenAPI

````yaml get /2/token/logo-reuses
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 - Usage
    description: Per-key API and WebSocket usage history
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V2 - Prediction Markets
    description: >-
      Polymarket markets/events, wallet positions, and the full execution stack
      (auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy,
      deposit/withdraw, redeem). Alpha — see /api/2/pm/*.
  - 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, 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/token/logo-reuses:
    get:
      tags:
        - V2 - Token
      summary: List Tokens Reusing This Token's Logo
      description: >-
        Other tokens whose logo is the byte-identical file (sha256 of the
        original logo bytes) — copycat detection. Returns the total count plus
        the reusing tokens ranked by 24h volume. `count` is 0 when the token has
        no logo hash yet or its logo is unique.
      parameters:
        - schema:
            type: string
            description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
          required: false
          description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
          name: chainId
          in: query
        - schema:
            type: string
            description: Token contract address
          required: true
          description: Token contract address
          name: address
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 100
            description: 'Max number of reusing tokens returned, max 100 (default: 20)'
          required: false
          description: 'Max number of reusing tokens returned, max 100 (default: 20)'
          name: limit
          in: query
        - schema:
            type: string
            description: >-
              Opaque cursor from a previous response (`nextCursor`) to fetch the
              next page
          required: false
          description: >-
            Opaque cursor from a previous response (`nextCursor`) to fetch the
            next page
          name: cursor
          in: query
      responses:
        '200':
          description: Logo reuses response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      count:
                        type: number
                      tokens:
                        type: array
                        items:
                          type: object
                          properties:
                            address:
                              type: string
                            chainId:
                              type: string
                            name:
                              type: string
                              nullable: true
                            symbol:
                              type: string
                              nullable: true
                            logo:
                              type: string
                            volume24hUSD:
                              type: number
                              nullable: true
                            priceUSD:
                              type: number
                              nullable: true
                            marketCapUSD:
                              type: number
                              nullable: true
                            marketCapDilutedUSD:
                              type: number
                              nullable: true
                            createdAt:
                              type: number
                              nullable: true
                          required:
                            - address
                            - chainId
                            - name
                            - symbol
                            - logo
                            - volume24hUSD
                            - priceUSD
                            - marketCapUSD
                            - marketCapDilutedUSD
                            - createdAt
                      nextCursor:
                        type: string
                        nullable: true
                    required:
                      - count
                      - tokens
                      - nextCursor
                required:
                  - data

````