Supported Filters
Minter
Query wallets that minted a specific NFT.
Holder
Query wallets that hold a specific NFT or Token.
Seller
Query wallets that sold a specific NFT.
Buyer
Query wallets that sold a specific NFT.
Examples
Single Filter
Query all wallets that minted Bored Apes:
{
"operator": "AND",
"filters": [
{
"type": "minter",
"chain": "ethereum",
"contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"minAmount": "1"
}
]
}
Query wallets that hold at least 3 Bored Apes with golden Fur:
{
"operator": "AND",
"filters": [
{
"type": "holder",
"chain": "ethereum",
"contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"minAmount": "3",
"traits": [
{
"Fur": "Solid Gold"
}
]
}
]
}
Combined Filters
Query wallets that minted at least one Bored Ape and one Mutant Ape:
{
"operator": "AND",
"filters": [
{
"type": "minter",
"chain": "ethereum",
"contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"minAmount": "1"
},
{
"type": "minter",
"chain": "ethereum",
"contractAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
"minAmount": "1"
}
]
}
Retrieve all wallets that minted at least one Bored Ape or 3 Clonex:
{
"operator": "OR",
"filters": [
{
"type": "minter",
"chain": "ethereum",
"contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"minAmount": "1"
},
{
"type": "minter",
"chain": "ethereum",
"contractAddress": "0xc1a12e1404485c85479bef9414b83a99ca4cd478",
"minAmount": "3"
}
]
}