Skip to main content
GET
/
networks
/
{network}
/
pools
/
{pool_address}
/
info
Pool Tokens Info by Pool Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/info \
  --header 'x-cg-demo-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/"
        ],
        "discord_url": null,
        "farcaster_url": null,
        "zora_url": null,
        "telegram_handle": null,
        "twitter_handle": null,
        "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
        },
        "gt_verified": true,
        "categories": [],
        "gt_category_ids": [],
        "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
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
            "type": "pool"
          }
        }
      }
    },
    {
      "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/"
        ],
        "discord_url": null,
        "farcaster_url": null,
        "zora_url": null,
        "telegram_handle": null,
        "twitter_handle": "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
        },
        "gt_verified": true,
        "categories": [],
        "gt_category_ids": [],
        "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
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
            "type": "pool"
          }
        }
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Tips

​
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.
  • Cache / Update Frequency: every 60 seconds.

Authorizations

​
x-cg-demo-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"

Response

200 - application/json

Get pool tokens info on a network

​
data
object[]