# Trending Tokens

### **Endpoint**

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

> #### 💡 Pro **Tips**&#x20;
>
> * This endpoint returns the **top 10 trending tokens** on a selected chain—perfect for spotting what’s gaining traction in real time.
> * Use `strategy` for a volume-weighted view of staking growth or smart money signals.
> * It provides **live market data** such as volume, liquidity, market cap, and short-term price changes (1h & 24h)—ideal for quick sentiment reads.
> * Use it to **identify high-momentum tokens** early before they gain broader visibility.
> * Combine with other endpoints like [Token Details](/data-apis-for-ai/unified-token-intelligence-api.md) and [Technical Indicators](/products/api-endpoints/trading-intelligence/multi-interval-technical-analysis.md) to build a **deeper picture** of each trending token’s fundamentals.
> * 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="153.40625"></th><th width="108.828125"></th><th width="153.64453125"></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>strategy</code></mark></td><td>string</td><td>No</td><td>Method to rank trending projects.<br>Supported values: <mark style="color:orange;">mcap</mark> (Default), <mark style="color:orange;">volume_and_staking</mark>, <mark style="color:orange;">volume_and_smartmoney</mark></td></tr></tbody></table>

### **Sample Request**

{% code overflow="wrap" %}

```bash
# With Base Chain
curl --location 'https://api.dapplooker.com/v1/trending?api_key=<API_KEY>&chain=base'

# With Solana Chain
curl --location 'https://api.dapplooker.com/v1/trending?api_key=<API_KEY>&chain=solana'

# With Volume and Staking Trend Strategy
curl --location 'https://api.dapplooker.com/v1/trending?api_key=<API_KEY>&chain=base&strategy=volume_and_staking'

# With Volume and Smart Money Strategy
curl --location 'https://api.dapplooker.com/v1/trending?api_key=<API_KEY>&chain=base&strategy=volume_and_smartmoney'
```

{% endcode %}

### **Sample Response**

#### Mcap Strategy

```json
{
  "success": true,
  "data": [
    {
      "token_id": "pog-digital",
      "token_name": "Pog Coin",
      "token_symbol": "POGS",
      "token_address": "0x728f0a7fec1859cb0d71a432271d4e80310d235f",
      "volume": "754.89",
      "liquidity": "23253.20000",
      "mcap": "1712403.00",
      "price_change_percentage_1h": "0.58",
      "price_change_percentage_24h": "-3.15",
      "network": "base"
    },
    {
      "token_id": "whim-bet-by-virtuals",
      "token_name": "whim.bet by Virtuals",
      "token_symbol": "WHIM",
      "token_address": "0x39a1cce09d7354ac2db86c6b02924360a10e4793",
      "volume": "87029.00",
      "liquidity": "370716.60000",
      "mcap": "1273079.00",
      "price_change_percentage_1h": "2.05",
      "price_change_percentage_24h": "21.71",
      "network": "base"
    }
    ... // Upto 10 items
  ]
}
```

#### Volume & Staking Trend Strategy

```json
{
  "success": true,
  "data": [
    {
      "token_id": "vaderai-by-virtuals",
      "token_name": "Vader",
      "token_symbol": "VADER",
      "token_address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
      "volume": "943481.00",
      "liquidity": "1142503.00000",
      "mcap": "14841210.00",
      "price_change_percentage_1h": "0.50",
      "price_change_percentage_24h": "4.71",
      "network": "base",
      "score": 6.843227835323,
      "net_staked_percentage": 8.34997,
      "stake_retention_percentage": 20.94,
      "stake_value_24h": 95124.12911,
      "unstake_value_24h": 289281.3447,
      "whale_holding_percentage": 34.4,
      "token_holders": 229712,
      "total_stakers": 5568
    }
    ... // Upto 3 items
  ]
}
```

#### Volume & Smart Money Strategy

```json
{
  "success": true,
  "data": [
    {
      "token_id": "vaderai-by-virtuals",
      "token_name": "Vader",
      "token_symbol": "VADER",
      "token_address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
      "volume": "943481.00",
      "liquidity": "1142503.00000",
      "mcap": "14841210.00",
      "price_change_percentage_1h": "0.50",
      "price_change_percentage_24h": "4.71",
      "network": "base",
      "score": 6.843227835323,
      "total_buy_24h": 95124.12911,
      "total_sell_24h": 289281.3447,
      "total_buy_7d": 95124.12911,
      "total_sell_7d": 289281.3447,
      "total_buy_30d": 95124.12911,
      "total_sell_30d": 289281.3447
    }
    ... // Upto 3 items
  ]
}
```

### **Response Fields Explanation**

* <mark style="color:orange;">`token_id`</mark> *(string)*: A unique assigned identifier for the token.
* <mark style="color:orange;">`token_name`</mark> *(string)*: The full, human-readable name of the token.
* <mark style="color:orange;">`token_symbol`</mark> *(string)*: The token’s ticker symbol, typically used in trading.
* <mark style="color:orange;">`token_address`</mark> *(string)*: The on-chain address (contract address) of the token.
* <mark style="color:orange;">`volume`</mark> *(string)*: The total trading volume for the token in the last 24 hours, denominated in USD.
* <mark style="color:orange;">`liquidity`</mark> *(string)*: The current liquidity available for the token, typically based on decentralized exchange pools.
* <mark style="color:orange;">`mcap`</mark> *(string)*: The market capitalization of the token, calculated as price × circulating supply.
* <mark style="color:orange;">`price_change_percentage_1h`</mark> *(string)*: The token’s price percentage change over the past 1 hour.
* <mark style="color:orange;">`price_change_percentage_24h`</mark> *(string)*: The token’s price percentage change over the past 24 hours.
* <mark style="color:orange;">`network`</mark> *(string)*: The blockchain network on which the token is deployed (e.g., `base`, `solana`).
* <mark style="color:orange;">`score`</mark> (*number*): Composite score calculated using weighted factors (70% trading volume, 30% staking and smart money trends).
* <mark style="color:orange;">`net_staked_percentage`</mark> (*number*): Percentage of the token’s total supply currently staked on the network.
* <mark style="color:orange;">`stake_retention_percentage`</mark> (*number*): Percentage of staked tokens retained compared to previous periods, indicating staking loyalty.
* <mark style="color:orange;">`stake_value_24h`</mark> (*number*): Total USD value of tokens staked in the last 24 hours.
* <mark style="color:orange;">`unstake_value_24h`</mark> (*number*): Total USD value of tokens unstaked in the last 24 hours.
* <mark style="color:orange;">`whale_holding_percentage`</mark> (*number*): Percentage of the token supply held by large wallet addresses ("whales").
* <mark style="color:orange;">`token_holders`</mark> (*number*): Total number of unique wallet addresses holding the token.
* <mark style="color:orange;">`total_stakers`</mark> (*number*): Total number of unique wallet addresses currently staking the token.
* <mark style="color:orange;">`total_buy_24h`</mark> (*number*): Total USD value of token purchases in the last 24 hours.
* <mark style="color:orange;">`total_sell_24h`</mark> (*number*): Total USD value of token sales in the last 24 hours.
* <mark style="color:orange;">`total_buy_7d`</mark> (*number*): Total USD value of token purchases in the last 7 days.
* <mark style="color:orange;">`total_sell_7d`</mark> (*number*): Total USD value of token sales in the last 7 days.
* <mark style="color:orange;">`total_buy_30d`</mark> (*number*): Total USD value of token purchases in the last 30 days.
* <mark style="color:orange;">`total_sell_30d`</mark> (*number*): Total USD value of token sales in the last 30 days.


---

# 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/data-apis-for-ai/trending-tokens.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.