Skip to main content
GET
/
nft
/
collection
/
{collectionAddress}
Get detailed information about an NFT collection using collectionAddress.
curl --request GET \
  --url https://openapiv1.coinstats.app/nft/collection/{collectionAddress} \
  --header 'X-API-KEY: <api-key>'
{
  "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "bannerImg": "https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/banner/lg.webp",
  "blockchain": "ethereum",
  "description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain.",
  "img": "https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/main/lg.webp",
  "name": "Bored Ape Yacht Club",
  "relevantUrls": [
    {
      "name": "Etherscan",
      "url": "https://etherscan.io/address/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
    }
  ],
  "slug": "bored-ape-yacht-club",
  "slugCs": "bored_ape_yacht_club",
  "source": "opensea",
  "verified": true,
  "rank": 1,
  "rankAll": 5,
  "averagePrice": 14.5,
  "count": 10000,
  "floorPriceMc": 12.8,
  "floorPriceUsd": 25600,
  "mainCurrencyId": "ethereum",
  "marketcapMc": 128000,
  "marketcapUsd": 256000000,
  "oneDayAveragePrice": 13.2,
  "oneDaySales": 15,
  "ownersCount": 4309,
  "sevenDayAveragePrice": 12.85,
  "sevenDaySales": 87,
  "thirtyDayAveragePrice": 13.45,
  "thirtyDaySales": 342,
  "thirtyDayVolume": 4598.5,
  "totalSales": 85432,
  "totalSupply": 10000,
  "totalVolume": 125000,
  "volumeMc24h": 245.8,
  "volumeMc7d": 1685.3,
  "volumeUsd24h": 491600,
  "volumeUsd7d": 3370600,
  "floorPriceChange24h": 5.2,
  "floorPriceChange7d": -12.5,
  "marketcapChange24h": 8.3,
  "marketcapChange7d": -7.1,
  "volumeChange24h": 125.4,
  "volumeChange7d": 45.8,
  "ownersCountChange24h": 12,
  "ownersCountChange7d": 87,
  "salesInProfit": 78,
  "salesInProfitChange24h": 5,
  "salesInProfitChange7d": 23,
  "oneDayChange": 3.8,
  "transactionsUpdateDate": "2024-01-15T14:30:25.123Z",
  "sevenDayChange": 15.2,
  "thirtyDayChange": -8.5,
  "listedCount": 489,
  "show": true,
  "creatorFee": 250,
  "volume": 12845.7,
  "createdDate": "2021-04-30T12:00:00.000Z"
}
3 credits per request

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Path Parameters

​
collectionAddress
string
required

The address of the NFT collection

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

Response

Get Nft collection

​
address
string
required

The contract address of the NFT collection

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

​
description
string
required

Detailed description of the NFT collection

Example:

"The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain."

​
name
string
required

Name of the NFT collection

Example:

"Bored Ape Yacht Club"

​
bannerImg
string

URL of the collection banner image

Example:

"https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/banner/lg.webp"

​
blockchain
string

The blockchain network where the NFT collection exists

Example:

"ethereum"

​
img
string

URL of the collection profile image/logo

Example:

"https://static.coinstats.app/nft/collection/6490c15716994ae311b3dc0639e74f8f/main/lg.webp"

​
relevantUrls
object[]

Array of relevant URLs for the collection (website, social media, etc.)

​
slug
string

URL-friendly slug identifier for the collection

Example:

"bored-ape-yacht-club"

​
slugCs
string

CoinStats-specific slug identifier for the collection

Example:

"bored_ape_yacht_club"

​
source
string

Data source where the collection information originates from

Example:

"opensea"

​
verified
boolean

Whether the collection is verified by the marketplace or platform

Example:

true

​
rank
number

Ranking position of the collection within its category

Example:

1

​
rankAll
number

Overall ranking position across all NFT collections

Example:

5

​
averagePrice
number

Average price of NFTs in this collection in main currency

Example:

14.5

​
count
number

Total number of NFTs in the collection

Example:

10000

​
floorPriceMc
number

Floor price (lowest listed price) in main currency

Example:

12.8

​
floorPriceUsd
number

Floor price (lowest listed price) in USD

Example:

25600

​
mainCurrencyId
string

ID of the main currency used for pricing (usually the blockchain native token)

Example:

"ethereum"

​
marketcapMc
number

Total market capitalization in main currency

Example:

128000

​
marketcapUsd
number

Total market capitalization in USD

Example:

256000000

​
oneDayAveragePrice
number

Average price of NFTs sold in the last 24 hours in main currency

Example:

13.2

​
oneDaySales
number

Number of NFT sales in the last 24 hours

Example:

15

​
ownersCount
number

Total number of unique owners of NFTs in this collection

Example:

4309

​
sevenDayAveragePrice
number

Average price of NFTs sold in the last 7 days in main currency

Example:

12.85

​
sevenDaySales
number

Number of NFT sales in the last 7 days

Example:

87

​
thirtyDayAveragePrice
number

Average price of NFTs sold in the last 30 days in main currency

Example:

13.45

​
thirtyDaySales
number

Number of NFT sales in the last 30 days

Example:

342

​
thirtyDayVolume
number

Total trading volume in the last 30 days in main currency

Example:

4598.5

​
totalSales
number

Total number of sales across the collection lifetime

Example:

85432

​
totalSupply
number

Maximum number of NFTs that can exist in this collection

Example:

10000

​
totalVolume
number

Total trading volume across the collection lifetime in main currency

Example:

125000

​
volumeMc24h
number

Trading volume in the last 24 hours in main currency

Example:

245.8

​
volumeMc7d
number

Trading volume in the last 7 days in main currency

Example:

1685.3

​
volumeUsd24h
number

Trading volume in the last 24 hours in USD

Example:

491600

​
volumeUsd7d
number

Trading volume in the last 7 days in USD

Example:

3370600

​
floorPriceChange24h
number

Percentage change in floor price over the last 24 hours

Example:

5.2

​
floorPriceChange7d
number

Percentage change in floor price over the last 7 days

Example:

-12.5

​
marketcapChange24h
number

Percentage change in market capitalization over the last 24 hours

Example:

8.3

​
marketcapChange7d
number

Percentage change in market capitalization over the last 7 days

Example:

-7.1

​
volumeChange24h
number

Percentage change in trading volume over the last 24 hours

Example:

125.4

​
volumeChange7d
number

Percentage change in trading volume over the last 7 days

Example:

45.8

​
ownersCountChange24h
number

Change in number of unique owners over the last 24 hours

Example:

12

​
ownersCountChange7d
number

Change in number of unique owners over the last 7 days

Example:

87

​
salesInProfit
number

Number of sales that resulted in profit for the seller

Example:

78

​
salesInProfitChange24h
number

Change in profitable sales count over the last 24 hours

Example:

5

​
salesInProfitChange7d
number

Change in profitable sales count over the last 7 days

Example:

23

​
oneDayChange
number

Percentage change in collection metrics over the last day

Example:

3.8

​
transactionsUpdateDate
string<date-time>

Timestamp of the last transaction data update

Example:

"2024-01-15T14:30:25.123Z"

​
sevenDayChange
number

Percentage change in collection metrics over the last 7 days

Example:

15.2

​
thirtyDayChange
number

Percentage change in collection metrics over the last 30 days

Example:

-8.5

​
listedCount
number

Number of NFTs currently listed for sale

Example:

489

​
show
boolean

Whether the collection should be displayed in public listings

Example:

true

​
creatorFee
number

Creator royalty fee percentage (in basis points)

Example:

250

​
volume
number

Total trading volume for the collection in main currency

Example:

12845.7

​
createdDate
string<date-time>

Timestamp when the collection was first created

Example:

"2021-04-30T12:00:00.000Z"

⌘I