> ## 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.
# Pool Tokens Info by Pool Address
> This endpoint allows you to **query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network**
### Tips
* If you would like to query pool data such as price, transactions, volume, etc., you can go to this endpoint [`/networks/{network}/pools/{address}`](/v3.0.1/reference/pool-address) instead.
* Learn more about [GT Score](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated) and [GT Verified](https://support.coingecko.com/hc/en-us/articles/54413671274649-What-is-GT-Verified-Badge).
* 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 the CoinGecko team, you may use the following endpoints:
* [Coin Data by ID](/v3.0.1/reference/coins-id)
* [Coin Data by Token Address](/v3.0.1/reference/coins-contract-address)
### 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.
## OpenAPI
````yaml api-reference/onchain-demo.json get /networks/{network}/pools/{pool_address}/info
openapi: 3.0.0
info:
title: Onchain DEX API (Demo)
version: 3.0.0
servers:
- url: https://api.coingecko.com/api/v3/onchain
security:
- apiKeyAuth: []
- apiKeyQueryParam: []
paths:
/networks/{network}/pools/{pool_address}/info:
get:
tags:
- Tokens
summary: Pool Tokens Info by Pool Address
description: >-
This endpoint allows you to **query pool metadata (base and quote token
details, image, socials, websites, description, contract address, etc.)
based on a provided pool contract address on a network**
operationId: pool-token-info-contract-address
parameters:
- name: network
in: path
description: |-
network ID
*refers to [/networks](/v3.0.1/reference/networks-list)
required: true
schema:
type: string
example: eth
default: eth
- name: pool_address
in: path
description: pool contract address
required: true
schema:
type: string
example: '0x06da0fd433c1a5d7a4faa01111c044910a184553'
default: '0x06da0fd433c1a5d7a4faa01111c044910a184553'
responses:
'200':
description: Get pool tokens info on a network
content:
application/json:
schema:
$ref: '#/components/schemas/PoolTokensInfo'
components:
schemas:
PoolTokensInfo:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
properties:
address:
type: string
name:
type: string
symbol:
type: string
decimals:
type: integer
image_url:
type: string
image:
type: object
properties:
thumb:
type: string
small:
type: string
large:
type: string
coingecko_coin_id:
type: string
websites:
type: array
items:
type: string
discord_url:
type: string
nullable: true
farcaster_url:
type: string
nullable: true
zora_url:
type: string
nullable: true
telegram_handle:
type: string
nullable: true
twitter_handle:
type: string
nullable: true
description:
type: string
gt_score:
type: number
gt_score_details:
type: object
properties:
pool:
type: number
transaction:
type: number
creation:
type: number
info:
type: number
holders:
type: number
gt_verified:
type: boolean
categories:
type: array
items:
type: string
gt_category_ids:
type: array
items:
type: string
holders:
type: object
properties:
count:
type: integer
distribution_percentage:
type: object
properties:
top_10:
type: string
'11_30':
type: string
'31_50':
type: string
rest:
type: string
last_updated:
type: string
mint_authority:
type: string
nullable: true
freeze_authority:
type: string
nullable: true
is_honeypot:
oneOf:
- type: boolean
- type: string
relationships:
type: object
properties:
pool:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
example:
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
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-cg-demo-api-key
apiKeyQueryParam:
type: apiKey
in: query
name: x_cg_demo_api_key
````