# Token Intelligence

## 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 | No       | API key if not using 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 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapplooker.com/products/api-endpoints/wallet-intelligence/token-intelligence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.