Supported Filters

Minter

Query wallets that minted a specific NFT.

const query = {
    "type": "minter",
    "chain": "ethereum",
    "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "minAmount": "1"
}

Holder

Query wallets that hold a specific NFT or Token.

const query = {
    "type": "holder",
    "chain": "ethereum",
    "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "minAmount": "1"
}

Seller

Query wallets that sold a specific NFT.

const query = {
    "type": "seller",
    "chain": "ethereum",
    "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "minAmount": "1"
}

Buyer

Query wallets that sold a specific NFT.

const query = {
    "type": "buyer",
    "chain": "ethereum",
    "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "minAmount": "1"
}

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"
        }
    ]
}