NFTs Collection Data by Contract Address

curl --request GET \
  --url https://api.coingecko.com/api/v3/nfts/{asset_platform_id}/contract/{contract_address} \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "id": "pudgy-penguins",
  "web_slug": "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/38/pudgy-penguins-banner.jpg?1730778702",
  "description": "<h3>What Is the Pudgy Penguins NFT Collection?</h3>\n\n<p>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": 4.67,
    "usd": 9708.85
  },
  "market_cap": {
    "native_currency": 41507,
    "usd": 86292262
  },
  "volume_24h": {
    "native_currency": 28.01,
    "usd": 58232
  },
  "floor_price_in_usd_24h_percentage_change": -1.78233,
  "floor_price_24h_percentage_change": {
    "usd": -1.782332967792004,
    "native_currency": -0.6361858762952403
  },
  "market_cap_24h_percentage_change": {
    "usd": -1.782332967792065,
    "native_currency": -0.6361858762952404
  },
  "volume_24h_percentage_change": {
    "usd": -41.588610680147845,
    "native_currency": -40.90698133583369
  },
  "number_of_unique_addresses": 5174,
  "number_of_unique_addresses_24h_percentage_change": -0.01932,
  "volume_in_usd_24h_percentage_change": -41.58861,
  "total_supply": 8888,
  "one_day_sales": 6,
  "one_day_sales_24h_percentage_change": -40,
  "one_day_average_sale_price": 4.668316666666667,
  "one_day_average_sale_price_24h_percentage_change": -1.511635559722812,
  "links": {
    "homepage": "https://www.pudgypenguins.com/",
    "twitter": "https://twitter.com/pudgypenguins",
    "discord": "https://discord.gg/pudgypenguins"
  },
  "floor_price_7d_percentage_change": {
    "usd": -2.6085983246414655,
    "native_currency": -1.1974800093036855
  },
  "floor_price_14d_percentage_change": {
    "usd": -24.816051386825123,
    "native_currency": -16.157991023339317
  },
  "floor_price_30d_percentage_change": {
    "usd": -20.72768500482924,
    "native_currency": -12.366254928188072
  },
  "floor_price_60d_percentage_change": {
    "usd": 15.176366939745344,
    "native_currency": 13.07508549033547
  },
  "floor_price_1y_percentage_change": {
    "usd": -60.37112564100154,
    "native_currency": -51.85567113402062
  },
  "explorers": [
    {
      "name": "Etherscan",
      "link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    },
    {
      "name": "Ethplorer",
      "link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    }
  ],
  "user_favorites_count": 10135,
  "ath": {
    "native_currency": 36.33,
    "usd": 145728
  },
  "ath_change_percentage": {
    "native_currency": -87.1456099642169,
    "usd": -93.3388047739623
  },
  "ath_date": {
    "native_currency": "2024-12-17T07:50:05.897Z",
    "usd": "2024-12-17T08:35:07.390Z"
  }
}

GET

nfts

{asset_platform_id}

contract

{contract_address}

NFTs Collection Data by Contract Address

curl --request GET \
  --url https://api.coingecko.com/api/v3/nfts/{asset_platform_id}/contract/{contract_address} \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "id": "pudgy-penguins",
  "web_slug": "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/38/pudgy-penguins-banner.jpg?1730778702",
  "description": "<h3>What Is the Pudgy Penguins NFT Collection?</h3>\n\n<p>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": 4.67,
    "usd": 9708.85
  },
  "market_cap": {
    "native_currency": 41507,
    "usd": 86292262
  },
  "volume_24h": {
    "native_currency": 28.01,
    "usd": 58232
  },
  "floor_price_in_usd_24h_percentage_change": -1.78233,
  "floor_price_24h_percentage_change": {
    "usd": -1.782332967792004,
    "native_currency": -0.6361858762952403
  },
  "market_cap_24h_percentage_change": {
    "usd": -1.782332967792065,
    "native_currency": -0.6361858762952404
  },
  "volume_24h_percentage_change": {
    "usd": -41.588610680147845,
    "native_currency": -40.90698133583369
  },
  "number_of_unique_addresses": 5174,
  "number_of_unique_addresses_24h_percentage_change": -0.01932,
  "volume_in_usd_24h_percentage_change": -41.58861,
  "total_supply": 8888,
  "one_day_sales": 6,
  "one_day_sales_24h_percentage_change": -40,
  "one_day_average_sale_price": 4.668316666666667,
  "one_day_average_sale_price_24h_percentage_change": -1.511635559722812,
  "links": {
    "homepage": "https://www.pudgypenguins.com/",
    "twitter": "https://twitter.com/pudgypenguins",
    "discord": "https://discord.gg/pudgypenguins"
  },
  "floor_price_7d_percentage_change": {
    "usd": -2.6085983246414655,
    "native_currency": -1.1974800093036855
  },
  "floor_price_14d_percentage_change": {
    "usd": -24.816051386825123,
    "native_currency": -16.157991023339317
  },
  "floor_price_30d_percentage_change": {
    "usd": -20.72768500482924,
    "native_currency": -12.366254928188072
  },
  "floor_price_60d_percentage_change": {
    "usd": 15.176366939745344,
    "native_currency": 13.07508549033547
  },
  "floor_price_1y_percentage_change": {
    "usd": -60.37112564100154,
    "native_currency": -51.85567113402062
  },
  "explorers": [
    {
      "name": "Etherscan",
      "link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    },
    {
      "name": "Ethplorer",
      "link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
    }
  ],
  "user_favorites_count": 10135,
  "ath": {
    "native_currency": 36.33,
    "usd": 145728
  },
  "ath_change_percentage": {
    "native_currency": -87.1456099642169,
    "usd": -93.3388047739623
  },
  "ath_date": {
    "native_currency": "2024-12-17T07:50:05.897Z",
    "usd": "2024-12-17T08:35:07.390Z"
  }
}

Get asset_platform_id and contract_address from NFTs List.

Solana NFTs and Art Blocks are not supported for this endpoint. Use NFTs Collection Data by ID instead.

SDK Examples

const response = await client.nfts.contract.getContractAddress('0xBd3531dA5CF5857e7CfAA92426877b022e612cf8', {
  asset_platform_id: 'ethereum',
});

console.log(JSON.stringify(response, null, 2));

response = client.nfts.contract.get_contract_address(
  "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  asset_platform_id="ethereum",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-demo-api-key

string

header

required

Learn how to set up your API key

Path Parameters

asset_platform_id

string

default:ethereum

required

Asset platform ID. *refers to /asset_platforms.

contract_address

string

default:0xBd3531dA5CF5857e7CfAA92426877b022e612cf8

required

Contract address of the NFT collection.

Response

200 - application/json

NFT collection data

string

required

NFT collection ID

web_slug

string

required

NFT collection web slug

contract_address

string

required

NFT collection contract address

asset_platform_id

string

required

NFT collection asset platform ID

name

string

required

NFT collection name

symbol

string

required

NFT collection symbol

image

object

required

NFT collection image URLs

Show child attributes

banner_image

string

required

NFT collection banner image URL

description

string

required

NFT collection description

native_currency

string

required

NFT collection native currency

native_currency_symbol

string

required

NFT collection native currency symbol

market_cap_rank

integer | null

required

NFT collection market cap rank

floor_price

object

required

NFT collection floor price

Show child attributes

market_cap

object

required

NFT collection market cap

Show child attributes

volume_24h

object

required

NFT collection volume in 24 hours

Show child attributes

floor_price_in_usd_24h_percentage_change

number

required

NFT collection floor price in USD 24 hours percentage change

floor_price_24h_percentage_change

object

required

NFT collection floor price 24 hours percentage change

Show child attributes

market_cap_24h_percentage_change

object

required

NFT collection market cap 24 hours percentage change

Show child attributes

volume_24h_percentage_change

object

required

NFT collection volume in 24 hours percentage change

Show child attributes

number_of_unique_addresses

number

required

Number of unique addresses owning the NFTs

number_of_unique_addresses_24h_percentage_change

number

required

Number of unique addresses 24 hours percentage change

volume_in_usd_24h_percentage_change

number

required

NFT collection volume in USD 24 hours percentage change

total_supply

number

required

NFT collection total supply

one_day_sales

number | null

required

NFT collection one day sales

one_day_sales_24h_percentage_change

number

required

NFT collection one day sales 24 hours percentage change

one_day_average_sale_price

number | null

required

NFT collection one day average sale price

one_day_average_sale_price_24h_percentage_change

number

required

NFT collection one day average sale price 24 hours percentage change

links

object

required

NFT collection links

Show child attributes

floor_price_7d_percentage_change

object

required

NFT collection floor price 7 days percentage change

Show child attributes

floor_price_14d_percentage_change

object

required

NFT collection floor price 14 days percentage change

Show child attributes

floor_price_30d_percentage_change

object

required

NFT collection floor price 30 days percentage change

Show child attributes

floor_price_60d_percentage_change

object

required

NFT collection floor price 60 days percentage change

Show child attributes

floor_price_1y_percentage_change

object

required

NFT collection floor price 1 year percentage change

Show child attributes

explorers

object[]

required

NFT collection block explorer links

Show child attributes

user_favorites_count

integer

required

NFT collection user favorites count

ath

object

required

NFT collection all time highs

Show child attributes

ath_change_percentage

object

required

NFT collection all time highs change percentage

Show child attributes

ath_date

object

required

NFT collection all time highs date

Show child attributes

NFTs Collection Data by ID Trending Search List

CoinGecko API

Onchain API

NFTs Collection Data by Contract Address

SDK Examples

Authorizations

Path Parameters

Response

​SDK Examples

Authorizations

Path Parameters

Response

SDK Examples