GET
/
nfts
/
{asset_platform_id}
/
contract
/
{contract_address}
NFTs Collection Data by Contract Address
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/nfts/{asset_platform_id}/contract/{contract_address} \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "id": "pudgy-penguins",
  "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  "asset_platform_id": "ethereum",
  "name": "Pudgy Penguins",
  "symbol": "PPG",
  "image": {
    "small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323",
    "small_2x": "https://coin-images.coingecko.com/nft_contracts/images/38/small_2x/pudgy.jpg?1730778323"
  },
  "banner_image": "https://coin-images.coingecko.com/nft_contracts/images/20/bored-ape-yacht-club-banner.png?1708416120",
  "description": "Pudgy Penguins is a collection of 8,888 unique NFTs featuring cute cartoon penguins, which are generated from a collection of 150 different hand-drawn traits.",
  "native_currency": "ethereum",
  "native_currency_symbol": "ETH",
  "market_cap_rank": 3,
  "floor_price": {
    "native_currency": 12.5,
    "usd": 42317
  },
  "market_cap": {
    "native_currency": 111100,
    "usd": 376114941
  },
  "volume_24h": {
    "native_currency": 429.88,
    "usd": 1455314
  },
  "floor_price_in_usd_24h_percentage_change": 1.07067,
  "floor_price_24h_percentage_change": {
    "usd": 1.07067060717791,
    "native_currency": 1.21457489878543
  },
  "market_cap_24h_percentage_change": {
    "usd": 1.07067060717767,
    "native_currency": -0.404858299595142
  },
  "volume_24h_percentage_change": {
    "usd": -3.19833776698741,
    "native_currency": -1.80185531390094
  },
  "number_of_unique_addresses": 4752,
  "number_of_unique_addresses_24h_percentage_change": 0.08425,
  "volume_in_usd_24h_percentage_change": -3.19834,
  "total_supply": 8888,
  "one_day_sales": 36,
  "one_day_sales_24h_percentage_change": -2.7027027027027,
  "one_day_average_sale_price": 11.9411943888889,
  "one_day_average_sale_price_24h_percentage_change": 0.925870927379588,
  "links": {
    "homepage": "https://www.pudgypenguins.com/",
    "twitter": "https://twitter.com/pudgypenguins",
    "discord": "https://discord.gg/pudgypenguins"
  },
  "floor_price_7d_percentage_change": {
    "usd": -18.0014948262365,
    "native_currency": -13.7931034482759
  },
  "floor_price_14d_percentage_change": {
    "usd": -8.63235339431041,
    "native_currency": -8.61905110022663
  },
  "floor_price_30d_percentage_change": {
    "usd": -14.3765649314409,
    "native_currency": -0.777901254167328
  },
  "floor_price_60d_percentage_change": {
    "usd": 15.2779758703282,
    "native_currency": -18.0327868852459
  },
  "floor_price_1y_percentage_change": {
    "usd": 429.5685372855,
    "native_currency": 196.208530805687
  },
  "explorers": [
    {
      "name": "Etherscan",
      "link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    },
    {
      "name": "Ethplorer",
      "link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    }
  ],
  "user_favorites_count": 3660,
  "ath": {
    "native_currency": 22.9,
    "usd": 67535
  },
  "ath_change_percentage": {
    "native_currency": -59.825327510917,
    "usd": -64.3396788440525
  },
  "ath_date": {
    "native_currency": "2024-02-17T09:25:05.056Z",
    "usd": "2024-02-29T11:45:08.150Z"
  }
}

Tips

  • You may also obtain the asset platform ID and contract address through /nfts/list endpoint.

Note

  • Solana NFT & Art Blocks are not supported for this endpoint, please use /nfts/{id} endpoint instead.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Authorizations

x-cg-pro-api-key
string
header
required

Path Parameters

asset_platform_id
string
default:ethereum
required

asset platform ID *refers to /asset_platforms

Example:

"ethereum"

contract_address
string
default:0xBd3531dA5CF5857e7CfAA92426877b022e612cf8
required

the contract address of token

Example:

"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"

Response

200 - application/json

Get NFTs data

id
string

NFT collection ID

contract_address
string

NFT collection contract address

asset_platform_id
string

NFT collection asset platform ID

name
string

NFT collection name

symbol
string

NFT collection symbol

image
object

NFT collection image url

banner_image
object

NFT collection banner image url

description
string

NFT collection description

native_currency
string

NFT collection native currency

native_currency_symbol
string

NFT collection native currency symbol

market_cap_rank
number

coin market cap rank

floor_price
object

NFT collection floor price

market_cap
object

NFT collection market cap

volume_24h
object

NFT collection volume in 24 hours

floor_price_in_usd_24h_percentage_change
number

NFT collection floor price in usd 24 hours percentage change

floor_price_24h_percentage_change
object
market_cap_24h_percentage_change
object

NFT collection market cap 24 hours percentage change

volume_24h_percentage_change
object

NFT collection volume in 24 hours percentage change

number_of_unique_addresses
number

number of unique address owning the NFTs

number_of_unique_addresses_24h_percentage_change
number

number of unique address owning the NFTs 24 hours percentage change

volume_in_usd_24h_percentage_change
number

NFT collection volume in usd 24 hours percentage change

total_supply
number

NFT collection total supply

one_day_sales
number

NFT collection one day sales

one_day_sales_24h_percentage_change
number

NFT collection one day sales 24 hours percentage change

one_day_average_sale_price
number

NFT collection one day average sale price

one_day_average_sale_price_24h_percentage_change
number

NFT collection one day average sale price 24 hours percentage change

NFT collection links

floor_price_7d_percentage_change
object

NFT collection floor price 7 days percentage change

floor_price_14d_percentage_change
object

NFT collection floor price 14 days percentage change

floor_price_30d_percentage_change
object

NFT collection floor price 30 days percentage change

floor_price_60d_percentage_change
object

NFT collection floor price 60 days percentage change

floor_price_1y_percentage_change
object

NFT collection floor price 1 year percentage change

explorers
object[]

NFT collection block explorers links

user_favorites_count
number

NFT collection user favorites count

ath
object

NFT collection all time highs

ath_change_percentage
object

NFT collection all time highs change percentage

ath_date
object

NFT collection all time highs date