CoinGecko

CoinGecko Tokens API

Query token data by contract address including price, volume, top pools, and token information.

GitHub OpenAPI

Operations 5

GET /onchain/networks/{network}/tokens/{address} Get token data by contract address #
GET /onchain/networks/{network}/tokens/multi/{addresses} Get multiple tokens by addresses #
GET /onchain/networks/{network}/tokens/{address}/pools Get top pools for a token #
GET /onchain/networks/{network}/tokens/{address}/info Get token info by contract address #
GET /onchain/networks/{network}/tokens/{token_address}/pools Get pools for a specific token #

Documentation

📖
Documentation
https://docs.coingecko.com
📖
Documentation
https://docs.coingecko.com/reference/introduction
📖
Documentation
https://docs.coingecko.com/reference/endpoint-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/coingecko/refs/heads/main/openapi/coingecko-tokens-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/coingecko/refs/heads/main/asyncapi/coingecko-asyncapi.yml

Other Resources

🔗
Pricing
https://www.coingecko.com/en/api/pricing
🔗
Landing Page
https://www.coingecko.com/en/api
🔗
Landing Page
https://www.coingecko.com/en/api/dex

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/coingecko-tokens-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

coingecko-tokens-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: CoinGecko Onchain DEX Tokens API
  description: The CoinGecko Onchain DEX API, powered by GeckoTerminal, provides access to real-time decentralized exchange data across over 250 blockchain networks, 1,800 DEXes, and 30 million tokens. It offers more than 20 endpoints for querying liquidity pools, token data by contract address, OHLCV chart data, trending pools, and pool search functionality. This API enables developers to build applications that track onchain trading activity, monitor DeFi liquidity, and analyze decentralized market data without needing to interact directly with individual blockchain networks.
  version: 3.0.1
  contact:
    name: CoinGecko Support
    url: https://support.coingecko.com
  termsOfService: https://www.coingecko.com/en/terms
servers:
- url: https://pro-api.coingecko.com/api/v3
  description: CoinGecko Pro API Server (paid plans)
- url: https://api.coingecko.com/api/v3
  description: CoinGecko Demo API Server (free tier, limited endpoints)
security:
- proApiKeyHeader: []
- proApiKeyQuery: []
- demoApiKeyHeader: []
- demoApiKeyQuery: []
tags:
- name: Tokens
  description: Query token data by contract address including price, volume, top pools, and token information.
paths:
  /onchain/networks/{network}/tokens/{address}:
    get:
      operationId: getOnchainTokenByAddress
      summary: Get token data by contract address
      description: Get detailed data for a specific token by its contract address on a given network. Includes price, volume, market cap, and other token metrics.
      tags:
      - Tokens
      parameters:
      - $ref: '#/components/parameters/networkId'
      - name: address
        in: path
        required: true
        description: The token contract address
        schema:
          type: string
      - name: include
        in: query
        description: Additional data to include (e.g., top_pools)
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Token'
        '404':
          description: Token not found
  /onchain/networks/{network}/tokens/multi/{addresses}:
    get:
      operationId: getOnchainMultipleTokens
      summary: Get multiple tokens by addresses
      description: Get price and market data for multiple tokens in a single request by providing a comma-separated list of token contract addresses on a specific network.
      tags:
      - Tokens
      parameters:
      - $ref: '#/components/parameters/networkId'
      - name: addresses
        in: path
        required: true
        description: Comma-separated list of token contract addresses (up to 30)
        schema:
          type: string
      - name: include
        in: query
        description: Additional data to include (e.g., top_pools)
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Token'
  /onchain/networks/{network}/tokens/{address}/pools:
    get:
      operationId: getOnchainTokenTopPools
      summary: Get top pools for a token
      description: Get the top liquidity pools that include a specific token on a given network, useful for finding trading venues for a token.
      tags:
      - Tokens
      parameters:
      - $ref: '#/components/parameters/networkId'
      - name: address
        in: path
        required: true
        description: The token contract address
        schema:
          type: string
      - name: include
        in: query
        description: Additional data to include (e.g., base_token, quote_token, dex)
        schema:
          type: string
      - name: page
        in: query
        description: Page number for pagination
        schema:
          type: integer
          default: 1
      - name: sort
        in: query
        description: Sort order
        schema:
          type: string
          enum:
          - h24_tx_count_desc
          - h24_volume_usd_desc
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Pool'
        '404':
          description: Token not found
  /onchain/networks/{network}/tokens/{address}/info:
    get:
      operationId: getOnchainTokenInfo
      summary: Get token info by contract address
      description: Get metadata and descriptive information for a specific token by its contract address on a given network. Includes name, symbol, description, image, and website links.
      tags:
      - Tokens
      parameters:
      - $ref: '#/components/parameters/networkId'
      - name: address
        in: path
        required: true
        description: The token contract address
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/TokenInfo'
        '404':
          description: Token not found
  /onchain/networks/{network}/tokens/{token_address}/pools:
    get:
      operationId: getOnchainTokenPools
      summary: Get pools for a specific token
      description: Get all liquidity pools that contain a specific token on a given network. Results include pool metrics like volume, liquidity, and price data.
      tags:
      - Tokens
      parameters:
      - $ref: '#/components/parameters/networkId'
      - name: token_address
        in: path
        required: true
        description: The token contract address
        schema:
          type: string
      - name: include
        in: query
        description: Additional data to include (e.g., base_token, quote_token, dex)
        schema:
          type: string
      - name: page
        in: query
        description: Page number for pagination
        schema:
          type: integer
          default: 1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Pool'
        '404':
          description: Token not found
components:
  parameters:
    networkId:
      name: network
      in: path
      required: true
      description: The blockchain network identifier (e.g., eth, bsc, polygon_pos, solana, arbitrum, avalanche, base)
      schema:
        type: string
  schemas:
    Pool:
      type: object
      properties:
        id:
          type: string
          description: Pool identifier (network_address format)
        type:
          type: string
          description: Resource type (pool)
        attributes:
          type: object
          properties:
            base_token_price_usd:
              type: string
              description: Base token price in USD
            base_token_price_native_currency:
              type: string
              description: Base token price in network native currency
            quote_token_price_usd:
              type: string
              description: Quote token price in USD
            quote_token_price_native_currency:
              type: string
              description: Quote token price in network native currency
            base_token_price_quote_token:
              type: string
              description: Base token price in quote token
            quote_token_price_base_token:
              type: string
              description: Quote token price in base token
            address:
              type: string
              description: Pool contract address
            name:
              type: string
              description: Pool name (e.g., TOKEN_A / TOKEN_B)
            pool_created_at:
              type: string
              format: date-time
              description: Pool creation timestamp
            fdv_usd:
              type: string
              description: Fully diluted valuation in USD
            market_cap_usd:
              type: string
              description: Market cap in USD
            price_change_percentage:
              type: object
              description: Price change percentages over various timeframes
              properties:
                m5:
                  type: string
                  description: 5-minute price change percentage
                h1:
                  type: string
                  description: 1-hour price change percentage
                h6:
                  type: string
                  description: 6-hour price change percentage
                h24:
                  type: string
                  description: 24-hour price change percentage
            transactions:
              type: object
              description: Transaction counts over various timeframes
              properties:
                m5:
                  $ref: '#/components/schemas/TransactionCount'
                m15:
                  $ref: '#/components/schemas/TransactionCount'
                m30:
                  $ref: '#/components/schemas/TransactionCount'
                h1:
                  $ref: '#/components/schemas/TransactionCount'
                h24:
                  $ref: '#/components/schemas/TransactionCount'
            volume_usd:
              type: object
              description: Volume in USD over various timeframes
              properties:
                m5:
                  type: string
                h1:
                  type: string
                h6:
                  type: string
                h24:
                  type: string
            reserve_in_usd:
              type: string
              description: Total liquidity reserve in USD
        relationships:
          type: object
          description: Related resources (base_token, quote_token, dex, network)
          properties:
            base_token:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      type: string
            quote_token:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      type: string
            dex:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      type: string
    TransactionCount:
      type: object
      properties:
        buys:
          type: integer
          description: Number of buy transactions
        sells:
          type: integer
          description: Number of sell transactions
        buyers:
          type: integer
          description: Number of unique buyers
        sellers:
          type: integer
          description: Number of unique sellers
    Token:
      type: object
      properties:
        id:
          type: string
          description: Token identifier (network_address format)
        type:
          type: string
          description: Resource type (token)
        attributes:
          type: object
          properties:
            address:
              type: string
              description: Token contract address
            name:
              type: string
              description: Token name
            symbol:
              type: string
              description: Token ticker symbol
            decimals:
              type: integer
              description: Token decimal places
            coingecko_coin_id:
              type: string
              description: Corresponding CoinGecko coin ID
            price_usd:
              type: string
              description: Current price in USD
            fdv_usd:
              type: string
              description: Fully diluted valuation in USD
            total_reserve_in_usd:
              type: string
              description: Total reserve across all pools in USD
            volume_usd:
              type: object
              description: Volume in USD over various timeframes
              properties:
                h24:
                  type: string
            market_cap_usd:
              type: string
              description: Market cap in USD
    TokenInfo:
      type: object
      properties:
        id:
          type: string
          description: Token identifier
        type:
          type: string
          description: Resource type (token)
        attributes:
          type: object
          properties:
            address:
              type: string
              description: Token contract address
            name:
              type: string
              description: Token name
            symbol:
              type: string
              description: Token ticker symbol
            coingecko_coin_id:
              type: string
              description: Corresponding CoinGecko coin ID
            image_url:
              type: string
              format: uri
              description: Token logo image URL
            description:
              type: string
              description: Token description text
            websites:
              type: array
              description: Official website URLs
              items:
                type: string
                format: uri
            gt_score:
              type: number
              description: GeckoTerminal trust score
            discord_url:
              type: string
              format: uri
              description: Discord community URL
            telegram_handle:
              type: string
              description: Telegram handle
            twitter_handle:
              type: string
              description: Twitter/X handle
  securitySchemes:
    proApiKeyHeader:
      type: apiKey
      in: header
      name: x-cg-pro-api-key
      description: CoinGecko Pro API key passed via request header.
    proApiKeyQuery:
      type: apiKey
      in: query
      name: x_cg_pro_api_key
      description: CoinGecko Pro API key passed via query string parameter.
    demoApiKeyHeader:
      type: apiKey
      in: header
      name: x-cg-demo-api-key
      description: CoinGecko Demo API key for free tier access to limited onchain endpoints.
    demoApiKeyQuery:
      type: apiKey
      in: query
      name: x_cg_demo_api_key
      description: CoinGecko Demo API key passed via query string parameter.
externalDocs:
  description: CoinGecko Onchain DEX API Documentation
  url: https://docs.coingecko.com/reference/endpoint-overview