CoinGecko

CoinGecko NFTs API

NFT collection data including floor prices and market information.

Documentation GitHub OpenAPI

Operations 7

GET /nfts/list List supported NFT collections #

GET /nfts/{id} Get NFT collection data by ID #

GET /nfts/{asset_platform_id}/contract/{contract_address} Get NFT collection data by contract address #

GET /nfts/markets List NFTs with market data #

GET /nfts/{id}/market_chart Get NFT collection market chart #

GET /nfts/{asset_platform_id}/contract/{contract_address}/market_chart Get NFT market chart by contract address #

GET /nfts/{id}/tickers Get NFT collection tickers #

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-nfts-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 NF Ts API
  version: 3.0.1
  contact:
    name: CoinGecko Support
    url: https://support.coingecko.com
  termsOfService: https://www.coingecko.com/en/terms
  description: 'Operations tagged NFTs across 2 of this provider''s published API definitions: coingecko-crypto-market-data-api-openapi.yml, coingecko-pro-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
tags:
- name: NFTs
  description: NFT collection data including floor prices and market information.
paths:
  /nfts/list:
    get:
      operationId: getNFTsList
      summary: List supported NFT collections
      description: Get the list of all supported NFT collection IDs, contract addresses, and names. Use this to obtain NFT IDs for use in other endpoints.
      tags:
      - NFTs
      parameters:
      - name: order
        in: query
        description: Sort order for results
        schema:
          type: string
      - 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/NFTListItem'
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /nfts/{id}:
    get:
      operationId: getNFTById
      summary: Get NFT collection data by ID
      description: Get comprehensive data for a specific NFT collection including floor price, market cap, volume, and other collection metrics.
      tags:
      - NFTs
      parameters:
      - name: id
        in: path
        required: true
        description: The NFT collection ID
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NFTData'
        '404':
          description: NFT collection not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /nfts/{asset_platform_id}/contract/{contract_address}:
    get:
      operationId: getNFTByContractAddress
      summary: Get NFT collection data by contract address
      description: Get comprehensive data for a specific NFT collection by querying the contract address on a specific asset platform.
      tags:
      - NFTs
      parameters:
      - name: asset_platform_id
        in: path
        required: true
        description: The asset platform ID (e.g., ethereum)
        schema:
          type: string
      - name: contract_address
        in: path
        required: true
        description: The NFT contract address
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NFTData'
        '404':
          description: NFT collection not found
      security:
      - demoApiKeyHeader: []
      - demoApiKeyQuery: []
    servers:
    - url: https://api.coingecko.com/api/v3
      description: CoinGecko Demo API Server
  /nfts/markets:
    get:
      operationId: getNFTsMarkets
      summary: List NFTs with market data
      description: Get the list of all supported NFT collections with floor price, market cap, volume, and market-related data. This endpoint is exclusive to paid plan subscribers.
      tags:
      - NFTs
      parameters:
      - name: order
        in: query
        description: Sort order for results
        schema:
          type: string
          enum:
          - h24_volume_usd_asc
          - h24_volume_usd_desc
          - h24_volume_native_asc
          - h24_volume_native_desc
          - floor_price_native_asc
          - floor_price_native_desc
          - market_cap_native_asc
          - market_cap_native_desc
          - market_cap_usd_asc
          - market_cap_usd_desc
      - 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:
                  type: object
                  properties:
                    id:
                      type: string
                      description: NFT collection identifier
                    contract_address:
                      type: string
                      description: Contract address
                    asset_platform_id:
                      type: string
                      description: Asset platform identifier
                    name:
                      type: string
                      description: Collection name
                    image:
                      type: object
                      properties:
                        small:
                          type: string
                          format: uri
                    description:
                      type: string
                      description: Collection description
                    native_currency:
                      type: string
                      description: Native currency
                    floor_price:
                      type: object
                      properties:
                        native_currency:
                          type: number
                        usd:
                          type: number
                    market_cap:
                      type: object
                      properties:
                        native_currency:
                          type: number
                        usd:
                          type: number
                    volume_24h:
                      type: object
                      properties:
                        native_currency:
                          type: number
                        usd:
                          type: number
                    floor_price_24h_percentage_change:
                      type: object
                      properties:
                        native_currency:
                          type: number
                        usd:
                          type: number
                    number_of_unique_addresses:
                      type: integer
                      description: Number of unique holder addresses
                    total_supply:
                      type: number
                      description: Total supply of NFTs
        '401':
          description: Unauthorized - invalid or missing Pro API key
        '403':
          description: Forbidden - endpoint not available on current plan
      security:
      - proApiKeyHeader: []
      - proApiKeyQuery: []
    servers:
    - url: https://pro-api.coingecko.com/api/v3
      description: CoinGecko Pro API Server
  /nfts/{id}/market_chart:
    get:
      operationId: getNFTMarketChart
      summary: Get NFT collection market chart
      description: Get historical market chart data for a specific NFT collection including floor price, market cap, and volume data. This endpoint is exclusive to paid plan subscribers.
      tags:
      - NFTs
      parameters:
      - name: id
        in: path
        required: true
        description: The NFT collection ID
        schema:
          type: string
      - name: days
        in: query
        required: true
        description: Number of days of historical data
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  floor_price_usd:
                    type: array
                    description: Floor price data points
                    items:
                      type: array
                      items:
                        type: number
                  floor_price_native:
                    type: array
                    description: Floor price in native currency data points
                    items:
                      type: array
                      items:
                        type: number
                  market_cap_usd:
                    type: array
                    description: Market cap data points
                    items:
                      type: array
                      items:
                        type: number
                  h24_volume_usd:
                    type: array
                    description: 24h volume data points
                    items:
                      type: array
                      items:
                        type: number
                  h24_volume_native:
                    type: array
                    description: 24h volume in native currency data points
                    items:
                      type: array
                      items:
                        type: number
        '401':
          description: Unauthorized - invalid or missing Pro API key
        '404':
          description: NFT collection not found
      security:
      - proApiKeyHeader: []
      - proApiKeyQuery: []
    servers:
    - url: https://pro-api.coingecko.com/api/v3
      description: CoinGecko Pro API Server
  /nfts/{asset_platform_id}/contract/{contract_address}/market_chart:
    get:
      operationId: getNFTContractMarketChart
      summary: Get NFT market chart by contract address
      description: Get historical market chart data for a specific NFT collection by contract address. This endpoint is exclusive to paid plan subscribers.
      tags:
      - NFTs
      parameters:
      - name: asset_platform_id
        in: path
        required: true
        description: The asset platform ID
        schema:
          type: string
      - name: contract_address
        in: path
        required: true
        description: The NFT contract address
        schema:
          type: string
      - name: days
        in: query
        required: true
        description: Number of days of historical data
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  floor_price_usd:
                    type: array
                    items:
                      type: array
                      items:
                        type: number
                  floor_price_native:
                    type: array
                    items:
                      type: array
                      items:
                        type: number
                  market_cap_usd:
                    type: array
                    items:
                      type: array
                      items:
                        type: number
                  h24_volume_usd:
                    type: array
                    items:
                      type: array
                      items:
                        type: number
                  h24_volume_native:
                    type: array
                    items:
                      type: array
                      items:
                        type: number
        '401':
          description: Unauthorized - invalid or missing Pro API key
        '404':
          description: NFT collection not found
      security:
      - proApiKeyHeader: []
      - proApiKeyQuery: []
    servers:
    - url: https://pro-api.coingecko.com/api/v3
      description: CoinGecko Pro API Server
  /nfts/{id}/tickers:
    get:
      operationId: getNFTTickers
      summary: Get NFT collection tickers
      description: Get the latest floor price and 24h volume tickers for a specific NFT collection across different marketplaces. This endpoint is exclusive to paid plan subscribers.
      tags:
      - NFTs
      parameters:
      - name: id
        in: path
        required: true
        description: The NFT collection ID
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  tickers:
                    type: array
                    items:
                      type: object
                      properties:
                        floor_price_in_native_currency:
                          type: number
                          description: Floor price in native currency
                        h24_volume_in_native_currency:
                          type: number
                          description: 24h volume in native currency
                        native_currency:
                          type: string
                          description: Native currency symbol
                        native_currency_symbol:
                          type: string
                          description: Native currency display symbol
                        updated_at:
                          type: string
                          format: date-time
                          description: Last update timestamp
                        nft_marketplace_id:
                          type: string
                          description: NFT marketplace identifier
        '401':
          description: Unauthorized - invalid or missing Pro API key
        '404':
          description: NFT collection not found
      security:
      - proApiKeyHeader: []
      - proApiKeyQuery: []
    servers:
    - url: https://pro-api.coingecko.com/api/v3
      description: CoinGecko Pro API Server
components:
  schemas:
    NFTListItem:
      type: object
      properties:
        id:
          type: string
          description: NFT collection identifier
        contract_address:
          type: string
          description: NFT contract address
        name:
          type: string
          description: NFT collection name
        asset_platform_id:
          type: string
          description: Asset platform identifier
        symbol:
          type: string
          description: NFT collection symbol
    NFTData:
      type: object
      properties:
        id:
          type: string
          description: NFT collection identifier
        contract_address:
          type: string
          description: NFT contract address
        asset_platform_id:
          type: string
          description: Asset platform identifier
        name:
          type: string
          description: NFT collection display name
        symbol:
          type: string
          description: NFT collection symbol
        image:
          type: object
          properties:
            small:
              type: string
              format: uri
              description: Small image URL
        description:
          type: string
          description: NFT collection description
        native_currency:
          type: string
          description: Native currency for the collection
        native_currency_symbol:
          type: string
          description: Native currency symbol
        floor_price:
          type: object
          description: Floor price in various currencies
          properties:
            native_currency:
              type: number
            usd:
              type: number
        market_cap:
          type: object
          description: Market cap in various currencies
          properties:
            native_currency:
              type: number
            usd:
              type: number
        volume_24h:
          type: object
          description: 24-hour volume in various currencies
          properties:
            native_currency:
              type: number
            usd:
              type: number
        floor_price_in_usd_24h_percentage_change:
          type: number
          description: 24-hour floor price change percentage in USD
        number_of_unique_addresses:
          type: integer
          description: Number of unique holder addresses
        number_of_unique_addresses_24h_percentage_change:
          type: number
          description: 24-hour change in unique addresses
        total_supply:
          type: number
          description: Total supply of NFTs in the collection
  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. Obtain a paid key from the CoinGecko developer dashboard.
    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-pro-api-openapi.yml