> ## 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. # Token Info by Token Address > To query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network export const CacheInfo = ({publicRate, paidRate, rate}) => { const fmt = v => v === 0 ? 'Real-time (Cacheless)' : `Every ${v}`; if (rate !== undefined) { return Cache / Update Frequency:
{fmt(rate)} ; } if (publicRate !== undefined && paidRate !== undefined) { return Cache / Update Frequency: ; } return null; }; #### Notes * 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). * `holders` data is currently in Beta, with ongoing improvements to coverage and update frequency. | 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` is based on total supply and includes all wallet types (CEX, treasury, etc.): * 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. Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team.
For CoinGecko-reviewed metadata, use [Coin Data by ID](/demo/reference/coins-id) or [Coin Data by Token Address](/demo/reference/coins-contract-address). For token market data (price, supply, volume), use [Token Data](/demo/reference/token-data-contract-address) instead. #### SDK Examples ```typescript TypeScript theme={null} const response = await client.onchain.networks.tokens.info.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', { network: 'solana', }); console.log(JSON.stringify(response, null, 2)); ``` ```python Python theme={null} response = client.onchain.networks.tokens.info.get( "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump", network="solana", ) print(response.model_dump_json(indent=2)) ``` ## OpenAPI ````yaml openapi-specs/demo-api.json get /onchain/networks/{network}/tokens/{address}/info openapi: 3.0.0 info: title: CoinGecko Demo API version: 3.0.0 servers: - url: https://api.coingecko.com/api/v3 security: - headerAuth: [] - queryAuth: [] paths: /onchain/networks/{network}/tokens/{address}/info: get: summary: Token Info by Token Address description: >- To query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network operationId: token-info-contract-address parameters: - name: network in: path required: true description: |- Network ID. *refers to [`/onchain/networks`](/reference/networks-list). schema: type: string default: solana - name: address in: path required: true description: Token contract address. schema: type: string default: Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump responses: '200': description: Token info data content: application/json: schema: $ref: '#/components/schemas/TokenInfo' example: data: 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 image: thumb: >- https://coin-images.coingecko.com/coins/images/51589/thumb/pippin_logo.png?1731570163 small: >- https://coin-images.coingecko.com/coins/images/51589/small/pippin_logo.png?1731570163 large: >- 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 websites: - https://pippin.love - https://www.yohei.me discord_url: null farcaster_url: null zora_url: null telegram_handle: ThePippinCo twitter_handle: pippinlovesyou description: >- Pippin is an SVG unicorn drawn using the latest LLM benchmarks on ChatGPT 4o. It is an autonomous AI agent on X. gt_score: 86.54440366972477 gt_score_details: pool: 87.5 transaction: 66.667 creation: 100 info: 100 holders: 100 gt_verified: true categories: - Pump Fun - Ai Agents gt_category_ids: - pump-fun - ai-agents holders: count: 47911 distribution_percentage: top_10: '73.7977' '11_20': '8.7309' '21_40': '5.6147' rest: '11.8567' last_updated: '2026-05-27T17:41:13Z' mint_authority: 'no' freeze_authority: 'no' is_honeypot: unknown developer_address: 4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu developer_holding_percentage: '0.0' components: schemas: TokenInfo: type: object required: - data properties: data: $ref: '#/components/schemas/TokenInfoItem' TokenInfoItem: type: object required: - id - type - attributes properties: id: type: string description: Token identifier type: type: string description: Resource type attributes: type: object required: - address - name - symbol - decimals - image_url - image - banner_image_url - coingecko_coin_id - websites - discord_url - farcaster_url - zora_url - telegram_handle - twitter_handle - description - gt_score - gt_score_details - gt_verified - categories - gt_category_ids - holders - mint_authority - freeze_authority - is_honeypot - developer_address - developer_holding_percentage properties: address: type: string description: Token contract address name: type: string description: Token name symbol: type: string description: Token symbol decimals: type: integer description: Token decimals image_url: type: string nullable: true description: Token image URL image: type: object description: Token image URLs in different sizes properties: thumb: type: string small: type: string large: type: string banner_image_url: type: string nullable: true description: Token banner image URL coingecko_coin_id: type: string nullable: true description: CoinGecko coin ID websites: type: array description: Token websites items: type: string discord_url: type: string nullable: true description: Discord URL farcaster_url: type: string nullable: true description: Farcaster URL zora_url: type: string nullable: true description: Zora URL telegram_handle: type: string nullable: true description: Telegram handle twitter_handle: type: string nullable: true description: Twitter handle description: type: string nullable: true description: Token description gt_score: type: number description: GeckoTerminal trust score gt_score_details: type: object description: GeckoTerminal trust score breakdown properties: pool: type: number transaction: type: number creation: type: number info: type: number holders: type: number gt_verified: type: boolean description: Whether the token is verified on GeckoTerminal categories: type: array description: Token categories items: type: string gt_category_ids: type: array description: GeckoTerminal category IDs items: type: string holders: type: object description: Token holder information properties: count: type: integer description: Number of holders distribution_percentage: type: object description: >- Holder distribution percentage (keys vary by chain, e.g. top_10, 11_30, 31_50, rest) additionalProperties: type: string last_updated: type: string description: Last updated timestamp mint_authority: type: string nullable: true description: Mint authority status freeze_authority: type: string nullable: true description: Freeze authority status is_honeypot: oneOf: - type: boolean - type: string description: Whether the token is a honeypot (boolean or 'unknown') developer_address: type: string nullable: true description: Developer wallet address developer_holding_percentage: type: string nullable: true description: Developer holding as a percentage of total supply securitySchemes: headerAuth: type: apiKey in: header name: x-cg-demo-api-key description: >- Learn how to [set up your API key](https://docs.coingecko.com/docs/setting-up-your-api-key) queryAuth: type: apiKey in: query name: x_cg_demo_api_key description: >- Learn how to [set up your API key](https://docs.coingecko.com/docs/setting-up-your-api-key) ````