Search NFTs

get https://deep-index.moralis.io/api/v2/nft/search

Get NFTs that match a given metadata search query.

Query Params

chain

string

Defaults to eth

The chain to query

format

string

Defaults to decimal

The format of the token ID

string

required

length between 3 and 256

The search string

filter

string

Defaults to global

What fields the search should match on. To look into the entire metadata set the value to 'global'. To have a better response time you can look into a specific field like name

from_block

integer

≥ 0

The minimum block number from which to start the search

Provide the param 'from_block' or 'from_date'
If 'from_date' and 'from_block' are provided, 'from_block' will be used.

to_block

integer

≥ 0

The maximum block number from which to end the search

Provide the param 'to_block' or 'to_date'
If 'to_date' and 'to_block' are provided, 'to_block' will be used.

from_date

string

The date from which to start the search (any format that is accepted by momentjs)

Provide the param 'from_block' or 'from_date'
If 'from_date' and 'from_block' are provided, 'from_block' will be used.

to_date

string

Get search results up until this date (any format that is accepted by momentjs)

Provide the param 'to_block' or 'to_date'
If 'to_date' and 'to_block' are provided, 'to_block' will be used.

addresses

array of strings

length ≤ 10

The addresses to get metadata for

addresses

cursor

string

The cursor returned in the previous response (used for getting the next page).

limit

integer

≥ 0

The desired page size of the result.

Response

Language

Credentials

Header

Request


xxxxxxxxxx
26
1
import Moralis  from 'moralis';
2
import { EvmChain } from '@moralisweb3/evm-utils';
3
4
try {
5
    const chain = EvmChain.ETHEREUM;
6
7
    const q = 'Pancake';
8
9
    const filter = 'name';
10
11
    await Moralis.start({
12
        apiKey: 'YOUR_API_KEY',
13
        // ...and any other configuration
14
    });
15
16
    const response = await Moralis.EvmApi.nft.searchNFTs({
17
        q,
18
        filter,
19
        chain,
20
    });
21
22
    console.log(response?.result);
23
} catch (e) {
24
    console.error(e);
25
}
26

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Returns the matching NFTs