# Unified Token Intelligence API

Access consolidated token data through a single endpoint — combining market metrics, technical indicators, on-chain activity, and social sentiment. Designed for advanced token profiling, decision support, and agentic automation.

### **Endpoint**

<mark style="color:yellow;">**GET**</mark> <mark style="color:orange;">`https://api.dapplooker.com/v1/crypto-market`</mark>

> #### 💡 Pro **Tips**&#x20;
>
> * This endpoint returns a maximum of 30 items per page. Use <mark style="color:orange;">`page`</mark> query parameter and pagination attributes (being returned in the response) to navigate through results.
> * You can fetch tokens data directly by specifying the <mark style="color:orange;">`chain`</mark> and <mark style="color:orange;">`ecosystem`</mark>—no need to pass individual token addresses, ids or tickers.
> * To retrieve data for specific token(s), use the <mark style="color:orange;">`token_addresses`</mark> , <mark style="color:orange;">`token_ids`</mark> or <mark style="color:orange;">`token_tickers`</mark> query parameter.
> * This endpoint is **x402 payment–enabled**, opening access for all users — simply **pay and use** without needing an API key.

### **Authentication**

This endpoint supports **two authentication methods**:

<table data-header-hidden><thead><tr><th width="254.30078125"></th><th></th></tr></thead><tbody><tr><td><strong>Method</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>API Key</strong></td><td>Provide your Loky API key using the <mark style="color:orange;"><code>api_key</code></mark> parameter for authenticated access.</td></tr><tr><td><strong>x402 Payment Protocol</strong></td><td>If <mark style="color:orange;"><code>api_key</code></mark> is not provided, the request automatically uses the <a href="https://x402.gitbook.io/x402">x402 protocol</a> for on-chain payment verification.</td></tr></tbody></table>

For seamless integration, user can follow the [**x402 Quickstart Guide for Buyers**](https://x402.gitbook.io/x402/getting-started/quickstart-for-buyers).

### **Query Parameters**

<table data-header-hidden><thead><tr><th width="171.734375"></th><th width="117.70703125"></th><th width="162.51171875"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Mandatory</strong></td><td><strong>Description</strong></td></tr><tr><td><mark style="color:orange;"><code>api_key</code></mark></td><td>string</td><td>No</td><td>Your unique Loky API key used for authentication</td></tr><tr><td><mark style="color:orange;"><code>chain</code></mark></td><td>string</td><td>Yes</td><td>The network chain to query. Supported chains: <mark style="color:orange;">base, solana</mark></td></tr><tr><td><mark style="color:orange;"><code>token_tickers</code></mark></td><td>string</td><td>No</td><td>Comma-separated token tickers (upto 30) to fetch info</td></tr><tr><td><mark style="color:orange;"><code>token_addresses</code></mark></td><td>string</td><td>No</td><td>Comma-separated token contract addresses (upto 30) to fetch info</td></tr><tr><td><mark style="color:orange;"><code>token_ids</code></mark></td><td>string</td><td>No</td><td>Comma-separated token IDs (upto 30) to fetch info</td></tr><tr><td><mark style="color:orange;"><code>ecosystem</code></mark></td><td>string</td><td>No</td><td>Specific ecosystem tokens to query. Supported ecosystem: <mark style="color:orange;">virtuals</mark></td></tr><tr><td><mark style="color:orange;"><code>page</code></mark></td><td>integer</td><td>No, Default page 1</td><td>Page number, 30 items per page</td></tr></tbody></table>

### **Sample Request**

{% code overflow="wrap" %}

```bash
# With Token Tickers
curl --location 'https://api.dapplooker.com/v1/crypto-market?api_key=<API_KEY>&chain=base&token_tickers=AIXBT'

# With Token Addresses
curl --location 'https://api.dapplooker.com/v1/crypto-market?api_key=<API_KEY>&chain=base&token_addresses=0x4F9Fd6Be4a90f2620860d680c0d4d5Fb53d1A825'

# With Token IDs
curl --location 'https://api.dapplooker.com/v1/crypto-market?api_key=<API_KEY>&chain=base&token_ids=aixbt,vaderai-by-virtuals'

# With Pagination Enabled Ecosystem Filter
curl --location 'https://api.dapplooker.com/v1/crypto-market/?api_key=<API_KEY>&chain=base&ecosystem=virtuals&page=1'
```

{% endcode %}

### **Sample Response**

{% code overflow="wrap" %}

```json
{
  "success": true,
  "data": [
    {
      "id": "aixbt",
      "token_info": {
        "id": "aixbt",
        "symbol": "AIXBT",
        "name": "aixbt by Virtuals",
        "handle": "aixbt_agent",
        "description": "AIXBT is an AI agent and driven crypto market intelligence platform designed to provide token holders with a strategic edge in the rapidly evolving crypto space. Leveraging advanced narrative detection and alpha-focused analysis, AIXBT automates the process of tracking and interpreting market trends, helping users gain actionable insights. This project emphasizes integrating various data sources and platforms for comprehensive analysis and decision-making.",
        "ca": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825",
        "chain": "base",
        "ecosystem": "virtuals"
      },
      "technical_indicators": {
        "support": "0.2103200000",
        "resistance": "0.2459300000",
        "rsi": "40.35",
        "sma": "0.2305506000"
      },
      "token_holder_insights": {
        "total_holder_count": 322354,
        "holder_count_change_percentage_24h": "0.07",
        "fifty_percentage_holding_wallet_count": "18.00",
        "first_100_buyers_initial_bought": "945882.24",
        "first_100_buyers_initial_bought_percentage": "0.09",
        "first_100_buyers_current_holding": "2029647.49",
        "first_100_buyers_current_holding_percentage": "0.20",
        "top_10_holder_balance": "406519449.12",
        "top_10_holder_percentage": "40.65",
        "top_50_holder_balance": "622587344.39",
        "top_50_holder_percentage": "62.26",
        "top_100_holder_balance": "672075585.75",
        "top_100_holder_percentage": "67.21"
      },
      "smart_money_insights": {
        "top_25_holder_buy_24h": "5051812.00",
        "top_25_holder_sold_24h": "5509253.60"
      },
      "dev_wallet_insights": {
        "wallet_address": "0x8dfb37aae4f8fcbd1f90015a9e75b48f50fd9f59",
        "wallet_balance": null,
        "dev_wallet_total_holding_percentage": null,
        "dev_wallet_outflow_txs_count_24h": null,
        "dev_wallet_outflow_amount_24h": null,
        "fresh_wallet": false,
        "dev_sold": false,
        "dev_sold_percentage": "0.00",
        "bundle_wallet_count": 1,
        "bundle_wallet_supply_percentage": null
      },
      "token_metrics": {
        "usd_price": "0.2168",
        "mcap": "202601848.00",
        "fdv": "216746287.00",
        "volume_24h": "92977418.00",
        "total_liquidity": "3146010.00",
        "price_change_percentage_1h": "-1.56",
        "price_change_percentage_24h": "-7.91",
        "price_change_percentage_7d": "3.52",
        "price_change_percentage_30d": "36.41",
        "volume_change_percentage_7d": "-13.40",
        "volume_change_percentage_30d": "13.70",
        "mcap_change_percentage_7d": "16.00",
        "mcap_change_percentage_30d": "51.50",
        "price_high_24h": "0.2354",
        "price_ath": "0.9426",
        "circulating_supply": "934741953.00",
        "total_supply": "1000000000.00"
      },
      "x_social_metrics": {
        "mindshare_3d": 3.89078276679337,
        "mindshare_change_percentage_3d": -8.96,
        "impression_count_3d": 1993494,
        "impression_count_change_percentage_3d": -1.31,
        "engagement_count_3d": 32860,
        "engagement_count_change_percentage_3d": 0.59,
        "follower_count_3d": 458966,
        "smart_follower_count_3d": 7363,
        "mindshare_7d": 4.14033463609196,
        "mindshare_change_percentage_7d": -0.02,
        "impression_count_7d": 4740567,
        "impression_count_change_percentage_7d": 2.09,
        "engagement_count_7d": 78922,
        "engagement_count_change_percentage_7d": -3.13,
        "follower_count_7d": 458966,
        "smart_follower_count_7d": 7343
      },
      "last_updated_at": "2025-05-30T06:18:49.679Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 30,
      "pageCount": 1,
      "total": 1
    }
  }
}
```

{% endcode %}

### **Response Fields Explanation**

#### **Token Info:**

* <mark style="color:orange;">`id`</mark> (*string*): Unique identifier for the token.
* <mark style="color:orange;">`symbol`</mark> (*string*): Token name.
* <mark style="color:orange;">`ecosystem`</mark> (*string*): Ecosystem of the token.
* <mark style="color:orange;">`image`</mark> (*string*): URL of the token’s image.
* <mark style="color:orange;">`description`</mark> (*string*): Description of the token.
* <mark style="color:orange;">`ca`</mark> (*string*): Contract address of the token.

#### Token Holder Insights:

* <mark style="color:orange;">`total_holder_count`</mark> (*integer*): Total number of token holders.
* <mark style="color:orange;">`holder_count_change_percentage_24h`</mark> (*decimal*): Change in the number of holders over the last 24 hours (percentage).
* <mark style="color:orange;">`fifty_percentage_holding_wallet_count`</mark> (*integer*): Number of wallets holding 50% of the total supply.
* <mark style="color:orange;">`first_100_buyers_initial_bought`</mark> (*decimal*): Total amount initially purchased by the first 100 buyers.
* <mark style="color:orange;">`first_100_buyers_initial_bought_percentage`</mark> (*decimal*): Percentage of total supply initially bought by the first 100 buyers.
* <mark style="color:orange;">`first_100_buyers_current_holding`</mark> (*decimal*): Current total holdings of the first 100 buyers.
* <mark style="color:orange;">`first_100_buyers_current_holding_percentage`</mark> (*decimal*): Current percentage of total supply held by the first 100 buyers.
* <mark style="color:orange;">`top_10_holder_balance`</mark> (*decimal*): Combined token balance of the top 10 holders.
* <mark style="color:orange;">`top_10_holder_percentage`</mark> (*decimal*): Percentage of total token supply held by the top 10 holders.
* <mark style="color:orange;">`top_50_holder_balance`</mark> (*decimal*): Combined token balance of the top 50 holders.
* <mark style="color:orange;">`top_50_holder_percentage`</mark> (*decimal*): Percentage of total token supply held by the top 50 holders.
* <mark style="color:orange;">`top_100_holder_balance`</mark> (*decimal*): Combined token balance of the top 100 holders.
* <mark style="color:orange;">`top_100_holder_percentage`</mark> (*decimal*): Percentage of total token supply held by the top 100 holders.

#### Technical Indicators:

* <mark style="color:orange;">`support`</mark> (*decimal*): Support price level.
* <mark style="color:orange;">`resistance`</mark> (*decimal*): Resistance price level.
* <mark style="color:orange;">`rsi`</mark> (*decimal*): Relative Strength Index (RSI) of the token.
* <mark style="color:orange;">`sma`</mark> (*decimal*): Simple Moving Average (SMA) of the token.

#### **Token Metrics:**

* <mark style="color:orange;">`usd_price`</mark> (*decimal*): Current price of the token in USD.
* <mark style="color:orange;">`mcap`</mark> (*decimal*): Market capitalization of the token.
* <mark style="color:orange;">`fully_diluted_valuation`</mark> (*decimal*): Fully diluted valuation of the token.
* <mark style="color:orange;">`volume_24h`</mark> (*decimal*): Trading volume of the token in the last 24 hours.
* <mark style="color:orange;">`price_change_percentage_1h`</mark> (*decimal*): Price change in the last 1 hour (percentage).
* <mark style="color:orange;">`price_change_percentage_24h`</mark> (*decimal*): Price change in the last 24 hours (percentage).
* <mark style="color:orange;">`price_change_percentage_7d`</mark> (*decimal*): Price change in the last 7 days (percentage).
* <mark style="color:orange;">`price_change_percentage_30d`</mark> (*decimal*): Price change in the last 30 days (percentage).
* <mark style="color:orange;">`volume_change_percentage_7d`</mark> (*decimal*): 7-day trading volume change (percentage).
* <mark style="color:orange;">`volume_change_percentage_30d`</mark> (*decimal*): 30-day trading volume change (percentage).
* <mark style="color:orange;">`mcap_change_percentage_7d`</mark> (*decimal*): 7-day market capitalization change (percentage).
* <mark style="color:orange;">`mcap_change_percentage_30d`</mark> (*decimal*): 30-day market capitalization change (percentage).
* <mark style="color:orange;">`price_high_24h`</mark> (*decimal*): Highest price of the token in the last 24 hours.
* <mark style="color:orange;">`price_ath`</mark> (*decimal*): All-time high price of the token.
* <mark style="color:orange;">`circulating_supply`</mark> (*decimal*): Number of tokens currently in circulation.
* <mark style="color:orange;">`total_supply`</mark> (*decimal*): Total supply of the token.

#### X Social Metrics:

* <mark style="color:orange;">`mindshare_3d`</mark> (*decimal*): Token's share of attention in social discussions in the past 3 days.
* <mark style="color:orange;">`mindshare_change_percentage_3d`</mark> (decimal): Percent change of mindshare value in the past 3 days.
* <mark style="color:orange;">`impression_count_3d`</mark> (*integer*): Number of times the token content is viewed in the past 3 days.
* <mark style="color:orange;">`impression_count_change_percentage_3d`</mark> (decimal): Percent change of impression count value in the past 3 days.
* <mark style="color:orange;">`engagement_count_3d`</mark> (*integer*): Interactions like likes, shares, and comments in the past 3 days.
* <mark style="color:orange;">`engagement_count_change_percentage_3d`</mark> (decimal): Percent change of engagement count value in the past 3 days.
* <mark style="color:orange;">`follower_count_3d`</mark> (*integer*): Total followers tracking the token in the past 3 days.
* <mark style="color:orange;">`smart_follower_count_3d`</mark> (*integer*): Followers with high influence or expertise in the past 3 days.
* <mark style="color:orange;">`mindshare_7d`</mark> (*decimal*): Token's share of attention in social discussions in the past 7 days.
* <mark style="color:orange;">`mindshare_change_percentage_7d`</mark> (decimal): Percent change of mindshare value in the past 7 days.
* <mark style="color:orange;">`impression_count_7d`</mark> (*integer*): Number of times the token content is viewed in the past 7 days.
* <mark style="color:orange;">`impression_count_change_percentage_7d`</mark> (decimal): Percent change of impression count value in the past 7 days.
* <mark style="color:orange;">`engagement_count_7d`</mark> (*integer*): Interactions like likes, shares, and comments in the past 7 days.
* <mark style="color:orange;">`engagement_count_change_percentage_7d`</mark> (decimal): Percent change of engagement count value in the past 7 days.
* <mark style="color:orange;">`follower_count_7d`</mark> (*integer*): Total followers tracking the token in the past 7 days.
* <mark style="color:orange;">`smart_follower_count_7d`</mark> (*integer*): Followers with high influence or expertise in the past 7 days.

#### **Last Update Datetime:**

* <mark style="color:orange;">`last_updated_at`</mark> (DateTime): ISO timestamp of last data update.

#### Pagination Attributes:

* <mark style="color:orange;">`page`</mark> *(integer)*: The current given page number, also being returned in the response.
* <mark style="color:orange;">`pageSize`</mark> *(integer)*: The number of max items can be included per page.
* <mark style="color:orange;">`pageCount`</mark> *(integer)*: The total number of pages available.
* <mark style="color:orange;">`total`</mark> *(integer)*: The total number of items available across all pages.