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

New to the SDK? Install and authenticate the client first:
TypeScript | Python

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

Hide child attributes

image.small

string

image.small_2x

string

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

Hide child attributes

floor_price.native_currency

number

floor_price.usd

number

market_cap

object

required

NFT collection market cap

Hide child attributes

market_cap.native_currency

number

market_cap.usd

number

volume_24h

object

required

NFT collection volume in 24 hours

Hide child attributes

volume_24h.native_currency

number

volume_24h.usd

number

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

Hide child attributes

floor_price_24h_percentage_change.usd

number

floor_price_24h_percentage_change.native_currency

number

market_cap_24h_percentage_change

object

required

NFT collection market cap 24 hours percentage change

Hide child attributes

market_cap_24h_percentage_change.usd

number

market_cap_24h_percentage_change.native_currency

number

volume_24h_percentage_change

object

required

NFT collection volume in 24 hours percentage change

Hide child attributes

volume_24h_percentage_change.usd

number

volume_24h_percentage_change.native_currency

number

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

Hide child attributes

links.homepage

string

links.twitter

string

links.discord

string

floor_price_7d_percentage_change

object

required

NFT collection floor price 7 days percentage change

Hide child attributes

floor_price_7d_percentage_change.usd

number

floor_price_7d_percentage_change.native_currency

number

floor_price_14d_percentage_change

object

required

NFT collection floor price 14 days percentage change

Hide child attributes

floor_price_14d_percentage_change.usd

number

floor_price_14d_percentage_change.native_currency

number

floor_price_30d_percentage_change

object

required

NFT collection floor price 30 days percentage change

Hide child attributes

floor_price_30d_percentage_change.usd

number

floor_price_30d_percentage_change.native_currency

number

floor_price_60d_percentage_change

object

required

NFT collection floor price 60 days percentage change

Hide child attributes

floor_price_60d_percentage_change.usd

number

floor_price_60d_percentage_change.native_currency

number

floor_price_1y_percentage_change

object

required

NFT collection floor price 1 year percentage change

Hide child attributes

floor_price_1y_percentage_change.usd

number

floor_price_1y_percentage_change.native_currency

number

explorers

object[]

required

NFT collection block explorer links

Hide child attributes

explorers.name

string

explorers.link

string

user_favorites_count

integer

required

NFT collection user favorites count

ath

object

required

NFT collection all time highs

Hide child attributes

ath.native_currency

number

ath.usd

number

ath_change_percentage

object

required

NFT collection all time highs change percentage

Hide child attributes

ath_change_percentage.native_currency

number

ath_change_percentage.usd

number

ath_date

object

required

NFT collection all time highs date

Hide child attributes

ath_date.native_currency

string<date-time>

ath_date.usd

string<date-time>

CoinGecko API

Onchain API

NFTs Collection Data by Contract Address

SDK Examples

Authorizations

Path Parameters

Response

​SDK Examples

Authorizations

Path Parameters

Response

SDK Examples