Total number of NFTs in a given NFT collection.

The name of the contract, i.e. "Bored Ape Yacht Club."

Number of distinct token IDs held by the owner. For non-fungible tokens this will be equal to the totalBalance, but it may be lower if the user holds some fungible ERC1155 tokens.

Please refer to the totalBalance and numDistinctTokensOwned fields instead.

One of the tokens from this contract held by the owner.

The NFT standard used by the contract, i.e. ERC721 or ERC1155.

Sum of NFT balances across all token IDs held by the owner. For non-fungible tokens this will be equal to the numDistinctTokensOwned, but it may be higher if the user holds some fungible ERC1155 tokens.

Contract address for the queried NFT collection

An offset used for pagination. Can be passed back as the "startToken" of a subsequent request to get the next page of results. Absent if there are no more results.

List of objects that represent NFTs stored under the queried contract address.

The canonical head block hash of when your request was received

Total number of NFTs owned by the given address.

Public gateway uri for the raw uri above.

Uri representing the location of the NFTMetadata's original metadata blob. This is a backup for you to parse when the metadata field is not automatically populated.

Contract address for the NFT collection (ERC721 and ERC1155 supported).

Source of the data (currently, Center.app's proprietary algorithm)'

Link to the collection on the given marketplace.

Returns an error if there was an error fetching floor prices from the given marketplace.

The floor price of the collection on the given marketplace.

The currency in which the floor price is denominated. Typically, denominated in ETH

UTC timestamp of when the floor price was retrieved from the marketplace.

Traits/attributes/characteristics for each NFTMetadata asset.

Human-readable description of the NFTMetadata asset.

The image URL that appears alongside the asset image on NFTMetadata platforms.

URL to the NFTMetadata asset image. Can be standard URLs pointing to images on conventional servers, IPFS, or Arweave. Most types of images (SVGs, PNGs, JPEGs, etc.) are supported by NFTMetadata marketplaces.

This field is deprecated. Use 'collectionName' instead.

This field is deprecated. Use 'smallPreviewImageUrl' instead.

This field is deprecated. Use 'tokenID' instead.

Whether the collection is flagged as spam or not

Reasons why the collection is flagged as spam. Empty if the collection is not a spam

Address for the ERC20 Token (null for native currency)

True if the currency is native, false otherwise

Rarity rank of asset across all assets in the same collection. Lower value is better.

Normalized score of an asset. Larger value is better.

Floating point value from 0 to 1 representing the prevalence of this value for this trait type.

Name of the trait category, i.e. Hat, Color, Face, etc.

Value for the trait, i.e. White Cap, Blue, Angry, etc.

API key associated with your account, you can access your API keys after logging in at https://center.dev/dashboard

X-API-Key

Center.dev API server

Returns Center contact information, example requests, and other helpful resources (e.g., links to tutorials)

Computes the rarity of each attribute of an NFT.

apiKey

network

Contract address for the NFTMetadata collection (ERC721 and ERC1155 supported).

contractAddress

The ID of the token. Can be in hex or decimal format.

tokenId

Queries NFT high-level collection/contract level information.

Gets all NFT contracts held by an owner address.

Address for NFT owner (can be in ENS format!).

owner

key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results.

pageKey

Returns the floor prices of a NFT collection by marketplace.

Gets the metadata associated with a given NFT.

No set timeout by default - When metadata is requested, this parameter is the timeout (in milliseconds) for the website hosting the metadata to respond. If you want to only access the cache and not live fetch any metadata for cache misses then set this value to 0.

tokenUriTimeoutInMs

Gets all NFTs currently owned by a given address.

Array of contract addresses to filter the responses with. Max limit 100 contracts.

contractAddresses[]

filters[]

Address for NFTMetadata owner (can be in ENS format!).

Number of NFTs to be returned per page. Defaults to 100. Max is 100.

pageSize

if set to true, returns NFTMetadata metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to false.

withMetadata

Sets the total number of NFTs returned in the response. Defaults to 100.

limit

A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel.

startToken

Gets all owners for a given NFT contract.

Checks whether a wallet holds a NFT in a given collection.

Wallet address to check for collection ownership.

wallet

Triggers metadata refresh for an entire NFT collection and refreshes stale metadata after a collection reveal/collection changes.

Search for a keyword across metadata of all ERC-721 and ERC-1155 smart contracts

The search string that you want to search for in contract metadata

query

Generate a summary of attribute prevalence for an NFT collection.

Returns blockchain networks currently accessible through this API

Returns all assets owned by a particular account address

address

Optional collection address (or comma-separated list of collection addresses)

collection

excludeCollection

offset

Returns key data (e.g., metadata, preview image, collection name) on multiple assets with single call

If true, any missing data will be fetched from the blockchain node, this can be slow and should not be used for performance-sensitive cases

fallbackToChain

Returns an ongoing list of updates (transfers, burns, mints)

Subscribe to notification stream via Web Socket

Searches for an NFT asset or collection based on an input query

Desired result type, valid options are asset, collection, or all

type

collection address (or comma-separated list of collection addresses)

fromAddress

toAddress

tokenID

Returns key data (e.g., name, preview image, symbol, creator) for a collection

If true then refresh the asset's metadata and media

refresh

collection not found on this network but available on another network

Returns owners who own an asset in given collection

Optional owner/holder address to filter assets

Returns all assets within a collection with particular attributes

Search assets within a collection by traits

Returns order data (from supported marketplaces) for all assets in a specified collection

The marketplace can be filtered by selecting one of the following options: opensea, looksrare, or x2y2. If no selection is made, the API will return a combined result

marketplace

The order type for the optional parameter can either be BID or ASK. If left blank, the API will provide a consolidated result

orderType

Get listings / offers for all NFTs in a collection

Returns list of traits of assets in collection

Returns all attribute values for a particular trait within a collection

trait

Get distribution of attributes for a particular trait

Returns key data (e.g., metadata, preview image, collection name) for given asset

network ID is invalid or asset does not have associated metadata

Failed to fetch data from the external site before timeout

Returns order data (from supported marketplaces) for a specified asset

If false, the response will exclude collection offers

includeCollectionOffers

The order type for the optional parameter can either be BID or ASK. If left blank, the API will provide a consolidated result.

Get listings / offers for a particular NFT

Returns rarity (ranking and score) of an asset in a given collection

preset

Shows all chains that are currently supported by the Center API and which capabilities are available on each chain

Show information about a blockchain network

sortBy

trader

subject

Returns key data (e.g., metadata, preview image, collection name) for given set of NFTs

Timeout in milliseconds. Assets that have not been retrieved within this time period will not be returned. Defaults to 10s

timeout

Search for NFT collections and / or specific NFTs by name, symbol or address

Search query. This can be a collection name, a collection address or a collection symbol.

contractType

Desired result type — can be asset or collection

Returns collection trading volume for specific collection

Starting block for custom volume interval

fromBlock

toBlock

Starting Unix timestamp for custom volume interval

fromTimestamp

Ending Unix timestamp for custom volume interval

toTimestamp

Contract Address

Returns floor price for specific collection

Returns market capitalization for specific collection

Returns key data (e.g., metadata, verification, preview image) for given NFT collection

Returns account addresses for all owners who own an asset in specified collection

Lists all media associated with a specified NFT, including images, animations, audio and video. This can be used to identify which NFT media exists before calling the Render NFT endpoint.

Returns key data (e.g., metadata, preview image, collection name) for given NFT

Timeout in milliseconds. Error will be returned if metadata has not been retrieved within this time period. Defaults to 10s

Renders any media for an NFT in desired format

The path to the desired media file. This is an optional parameter, and should be used to specify the desired media if multiple files exist. Default media file (often still image) will be rendered if no path is provided. Valid paths for an NFT can be found by querying the List NFT Media endpoint or metadata endpoints.

mediaPath

This is used to describe how you would like the media rendered. This should be provided in the form “size.format”, where size can be a preset (small, medium, original) or dimensions in pixels (e.g., 200x200, 750x750) and format can be png, jpg or gif. Format is optional.

Playground