# 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](https://docs.dapplooker.com/data-apis-for-ai/api-endpoints/unified-token-intelligence-api) and [Technical Indicators](https://docs.dapplooker.com/data-apis-for-ai/api-endpoints/multi-interval-technical-analysis) 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.