Skip to main content
GET
/
networks
/
{network}
/
pools
/
{pool_address}
/
info
Pool Tokens Info by Pool Address
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/info \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "data": [
    {
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "type": "token",
      "attributes": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
        "image": {
          "thumb": "https://assets.coingecko.com/coins/images/2518/thumb/weth.png?1696503332",
          "small": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
          "large": "https://assets.coingecko.com/coins/images/2518/large/weth.png?1696503332"
        },
        "coingecko_coin_id": "weth",
        "websites": [
          "https://weth.io/"
        ],
        "description": "WETH is the tokenized/packaged form of ETH that you use to pay for items when you interact with Ethereum dApps...",
        "gt_score": 92.6605504587156,
        "gt_score_details": {
          "pool": 87.5,
          "transaction": 0,
          "creation": 100,
          "info": 100,
          "holders": 100
        },
        "discord_url": null,
        "farcaster_url": null,
        "zora_url": null,
        "telegram_handle": null,
        "twitter_handle": null,
        "categories": [],
        "gt_categories_id": [],
        "holders": {
          "count": 1385496,
          "distribution_percentage": {
            "top_10": "55.1184",
            "11_30": "13.5825",
            "31_50": "4.7971",
            "rest": "26.502"
          },
          "last_updated": "2025-03-12T13:07:47Z"
        },
        "mint_authority": null,
        "freeze_authority": null,
        "is_honeypot": false
      }
    },
    {
      "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
      "type": "token",
      "attributes": {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "name": "Tether USD",
        "symbol": "USDT",
        "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
        "coingecko_coin_id": "tether",
        "websites": [
          "https://tether.to/"
        ],
        "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar. ...",
        "gt_score": 92.6605504587156,
        "gt_score_details": {
          "pool": 87.5,
          "transaction": 0,
          "creation": 100,
          "info": 100,
          "holders": 0
        },
        "discord_url": null,
        "farcaster_url": null,
        "zora_url": null,
        "telegram_handle": null,
        "twitter_handle": "Tether_to",
        "categories": [],
        "gt_categories_id": [],
        "holders": {
          "count": 7041203,
          "distribution_percentage": {
            "top_10": "45.5782",
            "11_30": "13.4293",
            "31_50": "3.9681",
            "rest": "37.0244"
          },
          "last_updated": "2025-03-12T05:28:50Z"
        },
        "mint_authority": null,
        "freeze_authority": null,
        "is_honeypot": false
      }
    }
  ],
  "included": [
    {
      "id": "eth_0x06da0fd433c1a5d7a4faa01111c044910a184553",
      "type": "pool",
      "attributes": {
        "base_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "quote_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "sentiment_vote_positive_percentage": 0,
        "sentiment_vote_negative_percentage": 0,
        "community_sus_report": 0
      }
    }
  ]
}

​
Tips

  • If you would like to query pool data such as price, transactions, volume and etc. You can go to this endpoint /networks/{network}/pools/{address} instead.
  • Cache/Update frequency: every 60 seconds.
  • Learn more about GT score here.
  • Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by CoinGecko team, you may use the following endpoints:

​
Note

  • holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
    • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
    • distribution_percentage coverage:
      • Solana: top_10, 11_20, 21_40, rest
      • Other chains: top_10, 11_30, 31_50, rest
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.

Authorizations

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

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
pool_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required

pool contract address

Example:

"0x06da0fd433c1a5d7a4faa01111c044910a184553"

Query Parameters

​
include
enum<string>

attributes to include

Available options:
pool

Response

200 - application/json

Get pool tokens info on a network

​
data
object[]
​
included
object[]