CoinGecko

CoinGecko Derivatives API

Derivatives market data including tickers and exchange information.

Documentation GitHub OpenAPI

Operations 4

GET /derivatives List all derivative tickers #

GET /derivatives/exchanges List derivative exchanges #

GET /derivatives/exchanges/{id} Get derivative exchange data by ID #

GET /derivatives/exchanges/list List derivative exchanges (ID map) #

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

openapi: 3.2.0
info:
  title: Coingecko Derivatives API
  version: '1.0'
  description: 'Operations tagged Derivatives 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: Derivatives
  description: Derivatives market data including tickers and exchange information.
paths:
  /derivatives:
    get:
      operationId: getDerivatives
      summary: List all derivative tickers
      description: Get the list of all derivative tickers across all exchanges including price, index, basis, spread, and open interest data.
      tags:
      - Derivatives
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DerivativeTicker'
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /derivatives/exchanges:
    get:
      operationId: getDerivativesExchanges
      summary: List derivative exchanges
      description: Get the list of all derivative exchanges with data including open interest, trade volume, and number of perpetual and futures pairs.
      tags:
      - Derivatives
      parameters:
      - name: order
        in: query
        description: Sort order for results
        schema:
          type: string
          enum:
          - name_asc
          - name_desc
          - open_interest_btc_asc
          - open_interest_btc_desc
          - trade_volume_24h_btc_asc
          - trade_volume_24h_btc_desc
      - name: per_page
        in: query
        description: Number of results per page
        schema:
          type: integer
          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/DerivativeExchange'
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /derivatives/exchanges/{id}:
    get:
      operationId: getDerivativeExchangeById
      summary: Get derivative exchange data by ID
      description: Get detailed data for a specific derivative exchange including tickers, open interest, and trade volume.
      tags:
      - Derivatives
      parameters:
      - name: id
        in: path
        required: true
        description: The derivative exchange ID
        schema:
          type: string
      - name: include_tickers
        in: query
        description: Include derivative tickers data
        schema:
          type: string
          enum:
          - all
          - unexpired
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DerivativeExchange'
        '404':
          description: Derivative exchange not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /derivatives/exchanges/list:
    get:
      operationId: getDerivativeExchangesList
      summary: List derivative exchanges (ID map)
      description: Get the complete list of all supported derivative exchange IDs and names.
      tags:
      - Derivatives
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Derivative exchange identifier
                    name:
                      type: string
                      description: Derivative exchange display name
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
components:
  schemas:
    DerivativeTicker:
      type: object
      properties:
        market:
          type: string
          description: Derivative exchange name
        symbol:
          type: string
          description: Trading pair symbol
        index_id:
          type: string
          description: Index identifier
        price:
          type: string
          description: Current price
        price_percentage_change_24h:
          type: number
          description: 24-hour price change percentage
        contract_type:
          type: string
          description: Contract type (perpetual or dated)
        index:
          type: number
          description: Index price
        basis:
          type: number
          description: Basis (difference between futures and spot price)
        spread:
          type: number
          description: Bid-ask spread percentage
        funding_rate:
          type: number
          description: Funding rate for perpetual contracts
        open_interest:
          type: number
          description: Open interest in USD
        volume_24h:
          type: number
          description: 24-hour trading volume
        last_traded_at:
          type: string
          format: date-time
          description: Last trade timestamp
        expired_at:
          type: string
          format: date-time
          description: Contract expiration date (null for perpetual)
    DerivativeExchange:
      type: object
      properties:
        name:
          type: string
          description: Exchange display name
        id:
          type: string
          description: Exchange identifier
        open_interest_btc:
          type: number
          description: Total open interest in BTC
        trade_volume_24h_btc:
          type: string
          description: 24-hour trading volume in BTC
        number_of_perpetual_pairs:
          type: integer
          description: Number of perpetual trading pairs
        number_of_futures_pairs:
          type: integer
          description: Number of futures trading pairs
        image:
          type: string
          format: uri
          description: Exchange logo URL
        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
    DerivativesExchangesID:
      type: object
      required:
      - name
      - open_interest_btc
      - trade_volume_24h_btc
      - number_of_perpetual_pairs
      - number_of_futures_pairs
      - image
      - year_established
      - country
      - description
      - url
      properties:
        name:
          type: string
          description: Derivatives exchange name
        open_interest_btc:
          type:
          - number
          - 'null'
          description: Derivatives exchange open interest in BTC
        trade_volume_24h_btc:
          type: string
          description: Derivatives exchange trade volume in BTC in 24 hours
        number_of_perpetual_pairs:
          type: integer
          description: Number of perpetual pairs in the derivatives exchange
        number_of_futures_pairs:
          type: integer
          description: Number of futures pairs in the derivatives exchange
        image:
          type: string
          description: Derivatives exchange image URL
        year_established:
          type:
          - integer
          - 'null'
          description: Derivatives exchange established year
        country:
          type:
          - string
          - 'null'
          description: Derivatives exchange incorporated country
        description:
          type: string
          description: Derivatives exchange description
        url:
          type: string
          description: Derivatives exchange website URL
        tickers:
          type: array
          description: Derivative tickers data, available when include_tickers is specified
          items:
            type: object
            required:
            - symbol
            - base
            - target
            - coin_id
            - target_coin_id
            - trade_url
            - contract_type
            - last
            - h24_percentage_change
            - index
            - index_basis_percentage
            - bid_ask_spread
            - funding_rate
            - open_interest_usd
            - h24_volume
            - converted_volume
            - converted_last
            - last_traded
            - expired_at
            properties:
              symbol:
                type: string
                description: Derivative ticker symbol
              base:
                type: string
                description: Derivative base asset
              target:
                type: string
                description: Derivative target asset
              coin_id:
                type: string
                description: Derivative base asset coin ID
              target_coin_id:
                type: string
                description: Derivative target asset coin ID
              trade_url:
                type: string
                description: Derivative trade URL
              contract_type:
                type: string
                description: Derivative contract type
              last:
                type: number
                description: Derivative last price
              h24_percentage_change:
                type: number
                description: Derivative price percentage change in 24 hours
              index:
                type: number
                description: Derivative underlying asset price
              index_basis_percentage:
                type: number
                description: Difference of derivative price and index price in percentage
              bid_ask_spread:
                type: number
                description: Derivative bid-ask spread
              funding_rate:
                type: number
                description: Derivative funding rate
              open_interest_usd:
                type: number
                description: Derivative open interest in USD
              h24_volume:
                type: number
                description: Derivative volume in 24 hours
              converted_volume:
                type: object
                description: Derivative converted volume
                properties:
                  btc:
                    type: string
                  eth:
                    type: string
                  usd:
                    type: string
              converted_last:
                type: object
                description: Derivative converted last price
                properties:
                  btc:
                    type: string
                  eth:
                    type: string
                  usd:
                    type: string
              last_traded:
                type: number
                description: Derivative last traded time in UNIX timestamp
              expired_at:
                type:
                - number
                - 'null'
                description: Derivative expiry time in UNIX timestamp
    DerivativesExchangesList:
      type: array
      items:
        type: object
        required:
        - id
        - name
        properties:
          id:
            type: string
            description: Derivatives exchange ID
          name:
            type: string
            description: Derivatives exchange name
    DerivativesExchanges:
      type: array
      items:
        type: object
        required:
        - name
        - id
        - open_interest_btc
        - trade_volume_24h_btc
        - number_of_perpetual_pairs
        - number_of_futures_pairs
        - image
        - year_established
        - country
        - description
        - url
        properties:
          name:
            type: string
            description: Derivatives exchange name
          id:
            type: string
            description: Derivatives exchange ID
          open_interest_btc:
            type: number
            description: Derivatives exchange open interest in BTC
          trade_volume_24h_btc:
            type: string
            description: Derivatives exchange trade volume in BTC in 24 hours
          number_of_perpetual_pairs:
            type: integer
            description: Number of perpetual pairs in the derivatives exchange
          number_of_futures_pairs:
            type: integer
            description: Number of futures pairs in the derivatives exchange
          image:
            type: string
            description: Derivatives exchange image URL
          year_established:
            type:
            - integer
            - 'null'
            description: Derivatives exchange established year
          country:
            type:
            - string
            - 'null'
            description: Derivatives exchange incorporated country
          description:
            type: string
            description: Derivatives exchange description
          url:
            type: string
            description: Derivatives exchange website URL
    DerivativesTickers:
      type: array
      items:
        type: object
        required:
        - market
        - symbol
        - index_id
        - price
        - price_percentage_change_24h
        - contract_type
        - index
        - basis
        - spread
        - funding_rate
        - open_interest
        - volume_24h
        - last_traded_at
        - expired_at
        properties:
          market:
            type: string
            description: Derivative market name
          symbol:
            type: string
            description: Derivative ticker symbol
          index_id:
            type: string
            description: Derivative underlying asset
          price:
            type: string
            description: Derivative ticker price
          price_percentage_change_24h:
            type: number
            description: Derivative ticker price percentage change in 24 hours
          contract_type:
            type: string
            description: Derivative contract type
          index:
            type: number
            description: Derivative underlying asset price
          basis:
            type: number
            description: Difference of derivative price and index price
          spread:
            type: number
            description: Derivative bid-ask spread
          funding_rate:
            type: number
            description: Derivative funding rate
          open_interest:
            type: number
            description: Derivative open interest
          volume_24h:
            type: number
            description: Derivative trading volume in 24 hours
          last_traded_at:
            type: number
            description: Derivative last traded time in UNIX timestamp
          expired_at:
            type:
            - number
            - 'null'
            description: Derivative expiry time in UNIX timestamp
  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