CoinGecko

CoinGecko Simple API

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

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 #

Documentation

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

Specifications

⚙
OpenAPI
https://artifacts.apis.io/coingecko/openapi/coingecko-simple-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/coingecko/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:coingecko-simple-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-simple-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Coingecko Simple API
  version: '1.0'
  description: 'Operations tagged Simple across 3 of this provider''s published API definitions: coingecko-crypto-market-data-api-openapi.yml, coingecko-onchain-dex-api-openapi.yml, coingecko-openapi.json. 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
  schemas:
    SupportedCurrencies:
      type: array
      items:
        type: string
    SimplePrice:
      type: object
      additionalProperties:
        type: object
        properties:
          usd:
            type: number
            description: Price in the target currency
          usd_market_cap:
            type: number
            description: Market capitalization in the target currency
          usd_24h_vol:
            type: number
            description: 24-hour trading volume in the target currency
          usd_24h_change:
            type: number
            description: 24-hour price change percentage in the target currency
          last_updated_at:
            type: number
            description: Last updated timestamp in UNIX seconds
  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.
    headerAuth:
      type: apiKey
      in: header
      name: x-cg-pro-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_pro_api_key
      description: Learn how to [set up your API key](https://docs.coingecko.com/docs/setting-up-your-api-key)
x-refined-from:
- coingecko-crypto-market-data-api-openapi.yml
- coingecko-onchain-dex-api-openapi.yml
- coingecko-openapi.json