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": "solana_So11111111111111111111111111111111111111112",
      "type": "token",
      "attributes": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
        "banner_image_url": null,
        "coingecko_coin_id": "wrapped-solana",
        "gt_score": 88.9908256880734,
        "gt_verified": true,
        "mint_authority": "no",
        "freeze_authority": "no",
        "is_honeypot": "unknown",
        "developer_address": null,
        "developer_holding_percentage": null
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
            "type": "pool"
          }
        }
      }
    },
    {
      "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
      "type": "token",
      "attributes": {
        "address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
        "name": "Pippin",
        "symbol": "pippin",
        "decimals": 6,
        "image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163",
        "banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c",
        "coingecko_coin_id": "pippin",
        "gt_score": 86.54440366972477,
        "gt_verified": true,
        "mint_authority": "no",
        "freeze_authority": "no",
        "is_honeypot": "unknown",
        "developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu",
        "developer_holding_percentage": "0.0"
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
            "type": "pool"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
      "type": "pool",
      "attributes": {
        "base_token_address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
        "quote_token_address": "So11111111111111111111111111111111111111112",
        "sentiment_vote_positive_percentage": 0,
        "sentiment_vote_negative_percentage": 0,
        "community_sus_report": 27
      }
    }
  ]
}

GET

onchain

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": "solana_So11111111111111111111111111111111111111112",
      "type": "token",
      "attributes": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
        "banner_image_url": null,
        "coingecko_coin_id": "wrapped-solana",
        "gt_score": 88.9908256880734,
        "gt_verified": true,
        "mint_authority": "no",
        "freeze_authority": "no",
        "is_honeypot": "unknown",
        "developer_address": null,
        "developer_holding_percentage": null
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
            "type": "pool"
          }
        }
      }
    },
    {
      "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
      "type": "token",
      "attributes": {
        "address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
        "name": "Pippin",
        "symbol": "pippin",
        "decimals": 6,
        "image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163",
        "banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c",
        "coingecko_coin_id": "pippin",
        "gt_score": 86.54440366972477,
        "gt_verified": true,
        "mint_authority": "no",
        "freeze_authority": "no",
        "is_honeypot": "unknown",
        "developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu",
        "developer_holding_percentage": "0.0"
      },
      "relationships": {
        "pool": {
          "data": {
            "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
            "type": "pool"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
      "type": "pool",
      "attributes": {
        "base_token_address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
        "quote_token_address": "So11111111111111111111111111111111111111112",
        "sentiment_vote_positive_percentage": 0,
        "sentiment_vote_negative_percentage": 0,
        "community_sus_report": 27
      }
    }
  ]
}

Notes

Learn more about GT Score and GT Verified.
holders data is currently in Beta, with ongoing improvements to coverage and update frequency.
Supported networks
Chain Network id
Solana solana
Ethereum eth
Base base
BNB Chain bsc
Optimism optimism
Arbitrum arbitrum
Polygon polygon_pos
TON ton
Sui sui-network
Robinhood robinhood
Ronin ronin
Bittensor bittensor
- distribution_percentage coverage:
  - Solana: top_10, 11_20, 21_40, rest
  - Other chains: top_10, 11_30, 31_50, rest
Bonding curve tokens (non-graduated launchpad tokens) include a launchpad_details object with graduation status.

Chain	Network `id`
Solana	`solana`
Ethereum	`eth`
Base	`base`
BNB Chain	`bsc`
Optimism	`optimism`
Arbitrum	`arbitrum`
Polygon	`polygon_pos`
TON	`ton`
Sui	`sui-network`
Robinhood	`robinhood`
Ronin	`ronin`
Bittensor	`bittensor`

Metadata (image, websites, description, socials) is unvetted unless the token is GT Verified (gt_verified: true) or reviewed by CoinGecko.
For CoinGecko-reviewed metadata, use Coin Data by ID or Coin Data by Token Address.

For pool market data (price, transactions, volume), use Specific Pool Data instead.

SDK Examples

const response = await client.onchain.networks.pools.info.get('8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt', {
  network: 'solana',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.networks.pools.info.get(
  "8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt",
  network="solana",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:solana

required

Network ID. *refers to /onchain/networks.

pool_address

string

default:8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt

required

Pool contract address.

Query Parameters

include

enum<string>

Attributes to include.

Available options:

pool

Response

200 - application/json

Pool tokens info data

data

object[]

required

Hide child attributes

data.id

string

required

Token identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.address

string

required

Token contract address

data.attributes.name

string

required

Token name

data.attributes.symbol

string

required

Token symbol

data.attributes.decimals

integer

required

Token decimals

data.attributes.image_url

string | null

required

Token image URL

data.attributes.image

object

required

Token image URLs in different sizes

Hide child attributes

data.attributes.image.thumb

string

data.attributes.image.small

string

data.attributes.image.large

string

data.attributes.banner_image_url

string | null

required

Token banner image URL

data.attributes.coingecko_coin_id

string | null

required

CoinGecko coin ID

data.attributes.websites

string[]

required

Token websites

data.attributes.discord_url

string | null

required

Discord URL

data.attributes.farcaster_url

string | null

required

Farcaster URL

data.attributes.zora_url

string | null

required

Zora URL

data.attributes.telegram_handle

string | null

required

Telegram handle

data.attributes.twitter_handle

string | null

required

Twitter handle

data.attributes.description

string | null

required

Token description

data.attributes.gt_score

number

required

GeckoTerminal trust score

data.attributes.gt_score_details

object

required

GeckoTerminal trust score breakdown

Hide child attributes

data.attributes.gt_score_details.pool

number

data.attributes.gt_score_details.transaction

number

data.attributes.gt_score_details.creation

number

data.attributes.gt_score_details.info

number

data.attributes.gt_score_details.holders

number

data.attributes.gt_verified

boolean

required

Whether the token is verified on GeckoTerminal

data.attributes.categories

string[]

required

Token categories

data.attributes.gt_category_ids

string[]

required

GeckoTerminal category IDs

data.attributes.holders

object

required

Token holder information

Hide child attributes

data.attributes.holders.count

integer

Number of holders

data.attributes.holders.distribution_percentage

object

Holder distribution percentage (keys vary by chain, e.g. top_10, 11_30, 31_50, rest)

Hide child attributes

data.attributes.holders.distribution_percentage.{key}

string

data.attributes.holders.last_updated

string

Last updated timestamp

data.attributes.mint_authority

string | null

required

Mint authority status

data.attributes.freeze_authority

string | null

required

Freeze authority status

data.attributes.is_honeypot

required

Whether the token is a honeypot (boolean or 'unknown')

data.attributes.developer_address

string | null

required

Developer wallet address

data.attributes.developer_holding_percentage

string | null

required

Developer holding as a percentage of total supply

data.relationships

object

required

Hide child attributes

data.relationships.pool

object

Hide child attributes

data.relationships.pool.data

object

Hide child attributes

data.relationships.pool.data.id

string

data.relationships.pool.data.type

string

included

object[]

Included pool data, present when include=pool is specified

Hide child attributes

included.id

string

included.type

string

included.attributes

object

Hide child attributes

included.attributes.base_token_address

string

Base token contract address

included.attributes.quote_token_address

string

Quote token contract address

included.attributes.quote_token_addresses

string[]

Quote token contract addresses, present for pools with more than 2 tokens

included.attributes.sentiment_vote_positive_percentage

number

GeckoTerminal community positive sentiment vote percentage

included.attributes.sentiment_vote_negative_percentage

number

GeckoTerminal community negative sentiment vote percentage

included.attributes.community_sus_report

integer

GeckoTerminal community suspicious reports count

CoinGecko API

Onchain API

Pool Tokens Info by Pool Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples