Skip to main content
GET
/
pools
/
trending_search
💼 Trending Search Pools
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/pools/trending_search \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "trending_rank": 0,
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "name": "WETH / USDC 0.05%",
        "pool_created_at": "2021-12-29T12:35:14Z",
        "fdv_usd": "11007041041",
        "market_cap_usd": null,
        "volume_usd": {
          "h24": "536545444.904535"
        },
        "reserve_in_usd": "163988541.3812"
      },
      "relationships": {
        "network": {
          "data": {
            "id": "eth",
            "type": "network"
          }
        },
        "dex": {
          "data": {
            "id": "uniswap_v3",
            "type": "dex"
          }
        },
        "base_token": {
          "data": {
            "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "type": "token"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "type": "token",
      "attributes": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
        "coingecko_coin_id": "weth"
      }
    }
  ]
}

​
Note

  • If the token’s market cap is not verified by the team, the API response will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
  • Attributes specified in the include param will be returned under the top-level “included” key.
  • Cache/Update frequency: every 60 seconds.
  • 💼 Exclusive for Paid Plan subscribers (Analyst plan or above).

Authorizations

​
x-cg-pro-api-key
string
header
required

Query Parameters

​
include
string
default:base_token

attributes to include, comma-separated if more than one to include Available values: base_token, quote_token, dex, network

​
pools
integer

number of pools to return, maximum 10 Default value: 4

Response

200 - application/json

Get trending search pools across all networks

​
data
object[]
​
included
object[]