CoinGecko

CoinGecko Simple API

Simple price and token price lookups without the overhead of full coin data responses.

Documentation GitHub OpenAPI

Operations 4

GET /simple/price Get coin price by IDs #

GET /simple/token_price/{id} Get token price by contract address #

GET /simple/supported_vs_currencies Get supported vs currencies #

GET /onchain/simple/networks/{network}/token_price/{addresses} Get token prices by contract addresses #

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-simple-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

openapi: 3.2.0
info:
  title: Coingecko Simple API
  version: 3.0.1
  contact:
    name: CoinGecko Support
    url: https://support.coingecko.com
  termsOfService: https://www.coingecko.com/en/terms
  description: 'Operations tagged Simple across 2 of this provider''s published API definitions: coingecko-crypto-market-data-api-openapi.yml, coingecko-onchain-dex-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.coingecko.com/api/v3
  description: CoinGecko Demo API Server
- url: https://pro-api.coingecko.com/api/v3
  description: CoinGecko Pro API Server (paid plans)
tags:
- name: Simple
  description: Simple price and token price lookups without the overhead of full coin data responses.
paths:
  /simple/price:
    get:
      operationId: getSimplePrice
      summary: Get coin price by IDs
      description: Query the prices of one or more coins by using their unique CoinGecko coin IDs. Optionally include market cap, 24h volume, 24h change, and last updated timestamp.
      tags:
      - Simple
      parameters:
      - $ref: '#/components/parameters/coinIds'
      - $ref: '#/components/parameters/vsCurrencies'
      - name: include_market_cap
        in: query
        description: Include market cap in the response
        schema:
          type: boolean
          default: false
      - name: include_24hr_vol
        in: query
        description: Include 24-hour trading volume in the response
        schema:
          type: boolean
          default: false
      - name: include_24hr_change
        in: query
        description: Include 24-hour price change percentage in the response
        schema:
          type: boolean
          default: false
      - name: include_last_updated_at
        in: query
        description: Include last updated timestamp in the response
        schema:
          type: boolean
          default: false
      - name: precision
        in: query
        description: Decimal precision for currency price values (0-18)
        schema:
          type: string
          enum:
          - '0'
          - '1'
          - '2'
          - '3'
          - '4'
          - '5'
          - '6'
          - '7'
          - '8'
          - '9'
          - '10'
          - '11'
          - '12'
          - '13'
          - '14'
          - '15'
          - '16'
          - '17'
          - '18'
          - full
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: object
                  additionalProperties:
                    type: number
        '400':
          description: Bad request - invalid parameters
        '401':
          description: Unauthorized - invalid or missing API key
        '429':
          description: Rate limit exceeded
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /simple/token_price/{id}:
    get:
      operationId: getSimpleTokenPrice
      summary: Get token price by contract address
      description: Query the prices of one or more tokens by using their contract addresses on a specific asset platform. This endpoint is useful for looking up token prices when you have the contract address rather than the CoinGecko coin ID.
      tags:
      - Simple
      parameters:
      - $ref: '#/components/parameters/assetPlatformId'
      - name: contract_addresses
        in: query
        required: true
        description: Comma-separated list of token contract addresses on the specified asset platform
        schema:
          type: string
      - $ref: '#/components/parameters/vsCurrencies'
      - name: include_market_cap
        in: query
        description: Include market cap in the response
        schema:
          type: boolean
          default: false
      - name: include_24hr_vol
        in: query
        description: Include 24-hour trading volume in the response
        schema:
          type: boolean
          default: false
      - name: include_24hr_change
        in: query
        description: Include 24-hour price change percentage in the response
        schema:
          type: boolean
          default: false
      - name: include_last_updated_at
        in: query
        description: Include last updated timestamp in the response
        schema:
          type: boolean
          default: false
      - name: precision
        in: query
        description: Decimal precision for currency price values (0-18)
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: object
                  additionalProperties:
                    type: number
        '400':
          description: Bad request - invalid parameters
        '401':
          description: Unauthorized - invalid or missing API key
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /simple/supported_vs_currencies:
    get:
      operationId: getSimpleSupportedVsCurrencies
      summary: Get supported vs currencies
      description: Get the list of all supported vs currencies (fiat and crypto) that can be used in price queries.
      tags:
      - Simple
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                  description: Currency identifier (e.g., usd, btc, eth)
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /onchain/simple/networks/{network}/token_price/{addresses}:
    get:
      operationId: getOnchainSimpleTokenPrice
      summary: Get token prices by contract addresses
      description: Get the USD prices of multiple tokens on a specific network by their contract addresses. Returns the latest price data for each requested token.
      tags:
      - Simple
      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
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      attributes:
                        type: object
                        properties:
                          token_prices:
                            type: object
                            additionalProperties:
                              type: string
                              description: USD price as string
        '400':
          description: Bad request - invalid parameters
        '401':
          description: Unauthorized - invalid or missing API key
      security:
      - proApiKeyHeader: []
      - proApiKeyQuery: []
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    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)
components:
  parameters:
    coinIds:
      name: ids
      in: query
      required: true
      description: Comma-separated list of CoinGecko coin IDs (e.g., bitcoin,ethereum)
      schema:
        type: string
    assetPlatformId:
      name: id
      in: path
      required: true
      description: The asset platform ID (e.g., ethereum, polygon-pos, solana)
      schema:
        type: string
    vsCurrencies:
      name: vs_currencies
      in: query
      required: true
      description: Comma-separated list of target currencies (e.g., usd,eur,btc)
      schema:
        type: string
    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
  securitySchemes:
    demoApiKeyHeader:
      type: apiKey
      in: header
      name: x-cg-demo-api-key
      description: CoinGecko Demo API key passed via request header. Obtain a free key from the CoinGecko developer dashboard.
    demoApiKeyQuery:
      type: apiKey
      in: query
      name: x_cg_demo_api_key
      description: CoinGecko Demo API key passed via query string parameter.
    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.
x-refined-from:
- coingecko-crypto-market-data-api-openapi.yml
- coingecko-onchain-dex-api-openapi.yml