Manifold for Developers
Search…
⌃K
Links

NFT Information Retrieval

NFT Data APIs
NFT APIs allow you to read NFT metadata and ownership information. These API's include:
  • getNFT Get NFT metadata (both ERC721 and ERC1155) and current ownership information (for ERC721)
  • getNFTTsOfOwner Get NFTs of the current authenticated wallet
  • ownerHasNFT Check if the current authenticated wallet owns an NFT
More APIs will be added in the near future.

Supported Networks

  • Ethereum Mainnet
  • Goerli
  • Polygon
  • Rinkeby (deprecated)
  • Optimism/Arbitrum (under evaluation)

Filtering Data

Most APIs take in an array of filters and attribute filters, in the following format:
/**
* 1. Filter for specific tokens by passing in a tokenId
* 2. Filter for a set of tokens by passing in an array of tokenIds
* 3. Filter for a range of tokens by passing in the minTokenId and maxTokenId
* You can use either 1, 2 or 3, but not all of them together.
*/
interface Filter {
contractAddress: string;
tokenId?: string;
tokenIds?: Array<string>
minTokenId?: string;
maxTokenId?: string;
}
/**
* Filter tokens by attribute
*
* An empty attributes array is equivalent to saying
* just filter tokens for the contractAddress and allow
* any attribute.
*/
interface AttributeFilter {
contractAddress: string;
attributes: Array<Attribute>;
}
interface Attribute {
traitType?: string;
value: string;
}
Each filter is treated as an 'or' statement.

Example: Get BAYC and MAYC NFTs for the user:

client.getNFTsOfOwner({
filters: [
{
contractAddress: '0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d'
},
{
contractAddress: '0x60e4d786628fea6478f785a6d7e704777c86a7c6'
}
]
})

Example: Get Doodles with both 3D Glasses AND a Navy Sweater

client.getNFTs({
attributeFilters: [
{
contractAddress: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e',
attributes: [
{
traitType: 'body',
value: 'navy sweater'
},
{
traitType: 'face',
value: '3d glasses'
},
]
},
]
})

Example: Get Doodles with both 3D Glasses OR a Navy Sweater

client.getNFTs({
attributeFilters: [
{
contractAddress: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e',
attributes: [
{
traitType: 'face',
value: '3d glasses'
},
]
},
{
contractAddress: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e',
attributes: [
{
traitType: 'body',
value: 'navy sweater'
}
]
}
]
})

Example: Get Mad Dog Jones Thought as a System

client.getNFTs({
filters: [
{
contractAddress: '0x4ac3d17fd6c2db18ec619fe2d68d2c22b18378ff',
minTokenId: '11600030001',
maxTokenId: '11600030050',
},
]
})
Last modified 1mo ago