CoinGecko

CoinGecko Exchanges API

Exchange data including volumes, tickers, and status updates.

GitHub OpenAPI

Operations 6

GET /exchanges List all exchanges #
GET /exchanges/list List all supported exchanges (ID map) #
GET /exchanges/{id} Get exchange data by ID #
GET /exchanges/{id}/tickers Get exchange tickers #
GET /exchanges/{id}/volume_chart Get exchange volume chart data #
GET /exchanges/{id}/volume_chart/range Exchange Volume Chart within Time Range by ID #

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-exchanges-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-exchanges-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-exchanges-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Coingecko Exchanges API
  version: '1.0'
  description: 'Operations tagged Exchanges across 2 of this provider''s published API definitions: coingecko-crypto-market-data-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
tags:
- name: Exchanges
  description: Exchange data including volumes, tickers, and status updates.
paths:
  /exchanges:
    get:
      operationId: getExchanges
      summary: List all exchanges
      description: Get a paginated list of all supported exchanges with volume, trust score, and other exchange-related data. Results are ordered by trading volume by default.
      tags:
      - Exchanges
      parameters:
      - name: per_page
        in: query
        description: Number of results per page (1-250)
        schema:
          type: integer
          minimum: 1
          maximum: 250
          default: 100
      - name: page
        in: query
        description: Page number for pagination
        schema:
          type: integer
          default: 1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Exchange'
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /exchanges/list:
    get:
      operationId: getExchangesList
      summary: List all supported exchanges (ID map)
      description: Get the complete list of all supported exchange IDs and names. Use this to obtain exchange IDs for use in other endpoints.
      tags:
      - Exchanges
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Exchange identifier
                    name:
                      type: string
                      description: Exchange display name
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /exchanges/{id}:
    get:
      operationId: getExchangeById
      summary: Get exchange data by ID
      description: Get comprehensive data for a specific exchange including volume, trust score, year established, country, and social links.
      tags:
      - Exchanges
      parameters:
      - $ref: '#/components/parameters/exchangeId'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangeData'
        '404':
          description: Exchange not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /exchanges/{id}/tickers:
    get:
      operationId: getExchangeTickers
      summary: Get exchange tickers
      description: Get paginated trading pair tickers for a specific exchange. Results include price, volume, spread, and trust score data for each trading pair.
      tags:
      - Exchanges
      parameters:
      - $ref: '#/components/parameters/exchangeId'
      - name: coin_ids
        in: query
        description: Filter tickers by coin IDs (comma-separated)
        schema:
          type: string
      - name: include_exchange_logo
        in: query
        description: Include exchange logo URL in the response
        schema:
          type: boolean
          default: false
      - name: page
        in: query
        description: Page number for pagination
        schema:
          type: integer
          default: 1
      - name: depth
        in: query
        description: Include order book depth (2% cost to move)
        schema:
          type: boolean
          default: false
      - name: order
        in: query
        description: Sort order for tickers
        schema:
          type: string
          enum:
          - trust_score_desc
          - trust_score_asc
          - volume_desc
          - volume_asc
          default: trust_score_desc
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                    description: Exchange name
                  tickers:
                    type: array
                    items:
                      $ref: '#/components/schemas/Ticker'
        '404':
          description: Exchange not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /exchanges/{id}/volume_chart:
    get:
      operationId: getExchangeVolumeChart
      summary: Get exchange volume chart data
      description: Get historical volume chart data for a specific exchange over a specified number of days.
      tags:
      - Exchanges
      parameters:
      - $ref: '#/components/parameters/exchangeId'
      - name: days
        in: query
        required: true
        description: Number of days of historical data (1, 7, 14, 30, 90, 180, 365)
        schema:
          type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: array
                  description: Volume data point as [timestamp, volume_in_btc]
                  items:
                    type: string
                  minItems: 2
                  maxItems: 2
        '404':
          description: Exchange not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /exchanges/{id}/volume_chart/range:
    get:
      summary: Exchange Volume Chart within Time Range by ID
      description: To query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID
      operationId: exchanges-id-volume-chart-range
      x-mint:
        href: /reference/exchanges-id-volume-chart-range
      parameters:
      - name: id
        in: path
        required: true
        description: "Exchange ID or derivative exchange ID. \n*refers to [`/exchanges/list`](/reference/exchanges-list) or [`/derivatives/exchanges/list`](/reference/derivatives-exchanges-list)."
        schema:
          type: string
          default: binance
      - name: from
        in: query
        required: true
        description: Starting date in UNIX timestamp.
        schema:
          type: number
          default: '1767196800'
      - name: to
        in: query
        required: true
        description: Ending date in UNIX timestamp.
        schema:
          type: number
          default: '1769702400'
      responses:
        '200':
          description: Exchange volume chart data within time range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangeVolumeChart'
              example:
              - - 1767282600000.0
                - '100719.0303690094832477'
              - - 1767369000000.0
                - '132387.93566259711126'
      tags:
      - Exchanges
      security:
      - headerAuth: []
      - queryAuth: []
    servers:
    - url: https://pro-api.coingecko.com/api/v3
components:
  schemas:
    ExchangeData:
      type: object
      properties:
        name:
          type: string
          description: Exchange display name
        year_established:
          type: integer
          description: Year the exchange was established
        country:
          type: string
          description: Country where the exchange is based
        description:
          type: string
          description: Exchange description
        url:
          type: string
          format: uri
          description: Exchange website URL
        image:
          type: string
          format: uri
          description: Exchange logo URL
        facebook_url:
          type: string
          format: uri
          description: Exchange Facebook URL
        reddit_url:
          type: string
          format: uri
          description: Exchange Reddit URL
        telegram_url:
          type: string
          format: uri
          description: Exchange Telegram URL
        slack_url:
          type: string
          format: uri
          description: Exchange Slack URL
        other_url_1:
          type: string
          format: uri
          description: Other URL 1
        other_url_2:
          type: string
          format: uri
          description: Other URL 2
        twitter_handle:
          type: string
          description: Exchange Twitter handle
        has_trading_incentive:
          type: boolean
          description: Whether the exchange has trading incentives
        centralized:
          type: boolean
          description: Whether the exchange is centralized
        public_notice:
          type: string
          description: Public notices from the exchange
        alert_notice:
          type: string
          description: Alert notices from the exchange
        trust_score:
          type: integer
          description: Trust score (1-10)
        trust_score_rank:
          type: integer
          description: Trust score ranking position
        trade_volume_24h_btc:
          type: number
          description: 24-hour trading volume in BTC
        trade_volume_24h_btc_normalized:
          type: number
          description: Normalized 24-hour trading volume in BTC
        tickers:
          type: array
          items:
            $ref: '#/components/schemas/Ticker'
    Exchange:
      type: object
      properties:
        id:
          type: string
          description: Exchange identifier
        name:
          type: string
          description: Exchange display name
        year_established:
          type: integer
          description: Year the exchange was established
        country:
          type: string
          description: Country where the exchange is based
        description:
          type: string
          description: Exchange description
        url:
          type: string
          format: uri
          description: Exchange website URL
        image:
          type: string
          format: uri
          description: Exchange logo URL
        has_trading_incentive:
          type: boolean
          description: Whether the exchange has trading incentives
        trust_score:
          type: integer
          description: Trust score (1-10)
        trust_score_rank:
          type: integer
          description: Trust score ranking position
        trade_volume_24h_btc:
          type: number
          description: 24-hour trading volume in BTC
        trade_volume_24h_btc_normalized:
          type: number
          description: Normalized 24-hour trading volume in BTC
    Ticker:
      type: object
      properties:
        base:
          type: string
          description: Base currency ticker
        target:
          type: string
          description: Target currency ticker
        market:
          type: object
          properties:
            name:
              type: string
              description: Exchange name
            identifier:
              type: string
              description: Exchange identifier
            has_trading_incentive:
              type: boolean
              description: Whether the exchange has trading incentives
        last:
          type: number
          description: Last traded price
        volume:
          type: number
          description: Trading volume
        converted_last:
          type: object
          description: Last price converted to BTC, ETH, and USD
          additionalProperties:
            type: number
        converted_volume:
          type: object
          description: Volume converted to BTC, ETH, and USD
          additionalProperties:
            type: number
        trust_score:
          type: string
          description: Trust score color (green, yellow, red)
        bid_ask_spread_percentage:
          type: number
          description: Bid-ask spread percentage
        timestamp:
          type: string
          format: date-time
          description: Ticker data timestamp
        last_traded_at:
          type: string
          format: date-time
          description: Last trade timestamp
        last_fetch_at:
          type: string
          format: date-time
          description: Last data fetch timestamp
        is_anomaly:
          type: boolean
          description: Whether the ticker is flagged as anomalous
        is_stale:
          type: boolean
          description: Whether the ticker data is stale
        trade_url:
          type: string
          format: uri
          description: URL to trade this pair
        coin_id:
          type: string
          description: CoinGecko coin ID of base currency
        target_coin_id:
          type: string
          description: CoinGecko coin ID of target currency
    CoinsIdTickers:
      type: object
      required:
      - name
      - tickers
      properties:
        name:
          type: string
          description: Coin name
        tickers:
          type: array
          description: List of tickers
          items:
            type: object
            required:
            - base
            - target
            - market
            - last
            - volume
            - converted_last
            - converted_volume
            - trust_score
            - bid_ask_spread_percentage
            - timestamp
            - last_traded_at
            - last_fetch_at
            - is_anomaly
            - is_stale
            - trade_url
            - token_info_url
            - coin_id
            - target_coin_id
            - coin_mcap_usd
            properties:
              base:
                type: string
                description: Ticker base currency
              target:
                type: string
                description: Ticker target currency
              market:
                type: object
                description: Exchange information
                properties:
                  name:
                    type: string
                    description: Exchange name
                  identifier:
                    type: string
                    description: Exchange identifier
                  has_trading_incentive:
                    type: boolean
                    description: Exchange trading incentive
                  logo:
                    type: string
                    description: Exchange logo URL
              last:
                type: number
                description: Last price
              volume:
                type: number
                description: Trading volume
              cost_to_move_up_usd:
                type: number
                description: Cost to move price up by 2% in USD
              cost_to_move_down_usd:
                type: number
                description: Cost to move price down by 2% in USD
              converted_last:
                type: object
                description: Converted last price
                properties:
                  btc:
                    type: number
                  eth:
                    type: number
                  usd:
                    type: number
              converted_volume:
                type: object
                description: Converted trading volume
                properties:
                  btc:
                    type: number
                  eth:
                    type: number
                  usd:
                    type: number
              trust_score:
                type:
                - string
                - 'null'
                description: Trust score
              bid_ask_spread_percentage:
                type: number
                description: Bid-ask spread percentage
              timestamp:
                type: string
                description: Ticker timestamp
              last_traded_at:
                type: string
                description: Last traded timestamp
              last_fetch_at:
                type: string
                description: Last fetch timestamp
              is_anomaly:
                type: boolean
                description: Whether ticker is anomalous
              is_stale:
                type: boolean
                description: Whether ticker is stale
              trade_url:
                type: string
                description: Trade URL
              token_info_url:
                type:
                - string
                - 'null'
                description: Token info URL
              coin_id:
                type: string
                description: Base currency coin ID
              target_coin_id:
                type: string
                description: Target currency coin ID
              coin_mcap_usd:
                type: number
                description: Coin market cap in USD
    ExchangesList:
      type: array
      items:
        type: object
        required:
        - id
        - name
        properties:
          id:
            type: string
            description: Exchange ID
          name:
            type: string
            description: Exchange name
    ExchangesId:
      type: object
      required:
      - name
      - year_established
      - country
      - description
      - url
      - image
      - facebook_url
      - reddit_url
      - telegram_url
      - slack_url
      - other_url_1
      - other_url_2
      - twitter_handle
      - has_trading_incentive
      - centralized
      - public_notice
      - alert_notice
      - trust_score
      - trust_score_rank
      - coins
      - pairs
      - trade_volume_24h_btc
      - tickers
      - status_updates
      properties:
        name:
          type: string
          description: Exchange name
        year_established:
          type:
          - number
          - 'null'
          description: Year the exchange was established
        country:
          type:
          - string
          - 'null'
          description: Country where the exchange is based
        description:
          type: string
          description: Exchange description
        url:
          type: string
          description: Exchange website URL
        image:
          type: string
          description: Exchange logo URL
        facebook_url:
          type: string
          description: Facebook URL
        reddit_url:
          type: string
          description: Reddit URL
        telegram_url:
          type: string
          description: Telegram URL
        slack_url:
          type: string
          description: Slack URL
        other_url_1:
          type: string
          description: Other URL 1
        other_url_2:
          type: string
          description: Other URL 2
        twitter_handle:
          type: string
          description: Twitter handle
        has_trading_incentive:
          type: boolean
          description: Whether the exchange has trading incentive
        centralized:
          type: boolean
          description: Whether the exchange is centralized
        public_notice:
          type: string
          description: Public notice
        alert_notice:
          type: string
          description: Alert notice
        trust_score:
          type:
          - number
          - 'null'
          description: Exchange trust score
        trust_score_rank:
          type:
          - number
          - 'null'
          description: Exchange trust score rank
        coins:
          type: number
          description: Number of coins listed
        pairs:
          type: number
          description: Number of trading pairs
        trade_volume_24h_btc:
          type: number
          description: Exchange 24h trading volume in BTC
        tickers:
          type: array
          description: Exchange tickers
          items:
            type: object
            properties:
              base:
                type: string
                description: Ticker base currency
              target:
                type: string
                description: Ticker target currency
              market:
                type: object
                description: Exchange information
                properties:
                  name:
                    type: string
                    description: Exchange name
                  identifier:
                    type: string
                    description: Exchange identifier
                  has_trading_incentive:
                    type: boolean
                    description: Exchange trading incentive
              last:
                type: number
                description: Last price
              volume:
                type: number
                description: Trading volume
              converted_last:
                type: object
                description: Converted last price
                properties:
                  btc:
                    type: number
                  eth:
                    type: number
                  usd:
                    type: number
              converted_volume:
                type: object
                description: Converted trading volume
                properties:
                  btc:
                    type: number
                  eth:
                    type: number
                  usd:
                    type: number
              trust_score:
                type:
                - string
                - 'null'
                description: Trust score
              bid_ask_spread_percentage:
                type: number
                description: Bid-ask spread percentage
              timestamp:
                type: string
                description: Ticker timestamp
              last_traded_at:
                type: string
                description: Last traded timestamp
              last_fetch_at:
                type: string
                description: Last fetch timestamp
              is_anomaly:
                type: boolean
                description: Whether ticker is anomalous
              is_stale:
                type: boolean
                description: Whether ticker is stale
              trade_url:
                type: string
                description: Trade URL
              token_info_url:
                type:
                - string
                - 'null'
                description: Token info URL
              coin_id:
                type: string
                description: Base currency coin ID
              target_coin_id:
                type: string
                description: Target currency coin ID
              coin_mcap_usd:
                type: number
                description: Coin market cap in USD
        status_updates:
          type: array
          description: Status updates
          items:
            type: object
            properties:
              description:
                type: string
                description: Status update description
              category:
                type: string
                description: Status update category
              created_at:
                type: string
                description: Status update creation time
              user:
                type: string
                description: Status update user
              user_title:
                type: string
                description: Status update user title
              pin:
                type: boolean
                description: Whether status update is pinned
              project:
                type: object
                description: Project information
                properties:
                  type:
                    type: string
                    description: Project type
                  id:
                    type: string
                    description: Project ID
                  name:
                    type: string
                    description: Project name
                  image:
                    type: object
                    description: Project image URLs
                    properties:
                      thumb:
                        type: string
                      small:
                        type: string
                      large:
                        type: string
    ExchangeVolumeChart:
      type: array
      description: Volume chart data points as [timestamp, volume_in_btc] pairs
      items:
        type: array
        items:
          oneOf:
          - type: number
          - type: string
    Exchanges:
      type: array
      items:
        type: object
        required:
        - id
        - name
        - year_established
        - country
        - description
        - url
        - image
        - has_trading_incentive
        - trust_score
        - trust_score_rank
        - trade_volume_24h_btc
        properties:
          id:
            type: string
            description: Exchange ID
          name:
            type: string
            description: Exchange name
          year_established:
            type:
            - number
            - 'null'
            description: Year the exchange was established
          country:
            type:
            - string
            - 'null'
            description: Country where the exchange is based
          description:
            type: string
            description: Exchange description
          url:
            type: string
            description: Exchange website URL
          image:
            type: string
            description: Exchange logo URL
          has_trading_incentive:
            type: boolean
            description: Whether the exchange has trading incentive
          trust_score:
            type:
            - number
            - 'null'
            description: Exchange trust score
          trust_score_rank:
            type:
            - number
            - 'null'
            description: Exchange trust score rank
          trade_volume_24h_btc:
            type: number
            description: Exchange 24h trading volume in BTC
  parameters:
    exchangeId:
      name: id
      in: path
      required: true
      description: The exchange ID (e.g., binance, coinbase-exchange)
      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.
    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)
externalDocs:
  description: CoinGecko API Documentation
  url: https://docs.coingecko.com
x-refined-from:
- coingecko-crypto-market-data-api-openapi.yml
- coingecko-openapi.json