> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/wallet-intelligence/token-intelligence.md).

# Token Intelligence

Holder changes, concentration, velocity, momentum.

## Endpoint

```
GET https://api.dapplooker.com/v1/token-intelligence
```

***

## Query Parameters

| Parameter        | Type   | Required | Description                                                                           |
| ---------------- | ------ | -------- | ------------------------------------------------------------------------------------- |
| chain            | string | Yes      | Network to query (`base`, `solana`, etc.)                                             |
| token\_tickers   | string | No       | Comma-separated token symbols                                                         |
| token\_addresses | string | No       | Comma-separated contract addresses                                                    |
| token\_ids       | string | No       | Comma-separated internal token ids                                                    |
| ecosystem        | string | No       | Filter by ecosystem (e.g. `virtuals`)                                                 |
| page             | number | No       | Pagination page                                                                       |
| api\_key         | string | Yes      | Your unique DappLooker API key used for authentication. Optional if querying via x402 |

Use at least one token filter or ecosystem filter.

***

## Example Requests

```bash
# Query by ticker
curl --location 'https://api.dapplooker.com/v1/token-intelligence?api_key=<API_KEY>&chain=base&token_tickers=AIXBT'

# Query by token address
curl --location 'https://api.dapplooker.com/v1/token-intelligence?api_key=<API_KEY>&chain=base&token_addresses=0x4F9Fd6Be4a90f2620860d680c0d4d5Fb53d1A825'

# Query by token ids
curl --location 'https://api.dapplooker.com/v1/token-intelligence?api_key=<API_KEY>&chain=base&token_ids=aixbt,vaderai-by-virtuals'

# Query ecosystem with pagination
curl --location 'https://api.dapplooker.com/v1/token-intelligence?api_key=<API_KEY>&chain=base&ecosystem=virtuals&page=1'
```

***

## Example Response

```json
{
  "success": true,
  "data": [
    {
      "id": "aixbt",

      "token_info": {
        "symbol": "AIXBT",
        "name": "aixbt by Virtuals",
        "chain": "base",
        "ecosystem": "virtuals",
        "ca": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825"
      },

      "token_metrics": {
        "usd_price": 0.2168,
        "market_cap_usd": 202601848,
        "fdv_usd": 216746287,
        "volume_24h_usd": 92977418,
        "liquidity_usd": 3146010,
        "price_change_percentage_24h": -7.91
      },

      "technical_indicators": {
        "rsi": 40.35,
        "support": 0.2103,
        "resistance": 0.2459
      },

      "token_holder_insights": {
        "total_holder_count": 322354,
        "top_10_holder_percentage": 40.65,
        "top_50_holder_percentage": 62.26
      },

      "smart_money_insights": {
        "top_25_holder_buy_24h": 5051812,
        "top_25_holder_sold_24h": 5509253
      },

      "dev_wallet_insights": {
        "dev_sold": false,
        "bundle_wallet_count": 1
      },

      "last_updated_at": "2025-05-30T06:18:49.679Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 30,
      "pageCount": 1,
      "total": 1
    }
  }
}
```

***

## Response Schema

### Token Identity

| Field     | Type   | Description               |
| --------- | ------ | ------------------------- |
| id        | string | Internal token identifier |
| symbol    | string | Token ticker              |
| name      | string | Full token name           |
| chain     | string | Blockchain network        |
| ecosystem | string | Ecosystem category        |
| ca        | string | Contract address          |

***

### Market Metrics

| Field                         | Type   | Description                         |
| ----------------------------- | ------ | ----------------------------------- |
| usd\_price                    | number | Current token price                 |
| market\_cap\_usd              | number | Market capitalization               |
| fdv\_usd                      | number | Fully diluted valuation             |
| volume\_24h\_usd              | number | 24h trading volume                  |
| liquidity\_usd                | number | Current liquidity                   |
| price\_change\_percentage\_\* | number | Price performance across timeframes |

***

### Technical Indicators

| Field      | Type   | Description                |
| ---------- | ------ | -------------------------- |
| rsi        | number | Relative Strength Index    |
| support    | number | Estimated support level    |
| resistance | number | Estimated resistance level |

***

### Holder Intelligence

| Field                        | Type   | Description                    |
| ---------------------------- | ------ | ------------------------------ |
| total\_holder\_count         | number | Total holders                  |
| top\_10\_holder\_percentage  | number | Supply held by top 10 wallets  |
| top\_50\_holder\_percentage  | number | Supply held by top 50 wallets  |
| top\_100\_holder\_percentage | number | Supply held by top 100 wallets |

***

### Smart Money Signals

| Field                      | Type   | Description              |
| -------------------------- | ------ | ------------------------ |
| top\_25\_holder\_buy\_24h  | number | Large wallet buys (24h)  |
| top\_25\_holder\_sold\_24h | number | Large wallet sells (24h) |

***

### Developer Wallet Signals

| Field                 | Type    | Description                   |
| --------------------- | ------- | ----------------------------- |
| dev\_sold             | boolean | Whether developer wallet sold |
| dev\_sold\_percentage | number  | % supply sold by dev wallet   |
| bundle\_wallet\_count | number  | Related wallet clusters       |
| fresh\_wallet         | boolean | Newly created deployer wallet |

### Pagination

| Field     | Type   | Description           |
| --------- | ------ | --------------------- |
| page      | number | Current page          |
| pageSize  | number | Items per page        |
| pageCount | number | Total pages           |
| total     | number | Total matching tokens |