searchAssets
Search for assets using a complex set of filter criteria. ownerAddress is required.
A few less common filters are accepted by the underlying API but are not exposed in the Try It form because their values cannot be defaulted to a useful placeholder without zeroing the result set: name (substring match), jsonUri (exact match), royaltyAmount (basis-points integer match), supply (exact integer match), and grouping (strict 2-tuple of [groupKey, groupValue], e.g. ["collection", "<address>"]). Pass these directly when calling the API from your own client.
Path Parameters
docs-demoFor higher throughput, create your own API key
Request
The owner address to filter by. Required by the Alchemy DAS proxy on every call, including when other filters are also provided.
Filter by token type. Accepted values are fungible, nonFungible, regularNFT, compressedNFT, and all. The Alchemy DAS proxy treats tokenType and the legacy interface filter as mutually exclusive — prefer tokenType for new integrations.
Sorting criteria for assets.
100The maximum number of assets to retrieve.
1The index of the page to retrieve (1-indexed).
Retrieve assets before this cursor.
Retrieve assets after this cursor.
Cursor for pagination. Returned in the previous response.
falseInvert the search filter.
allHow multiple filters are combined. all requires every filter to match; any matches if at least one filter matches.
Defaults to "all".
The creator address to filter by.
Only include verified creators.
The authority address to filter by.
The delegate address to filter by.
Filter by frozen status.
Filter by burnt status.
Filter for compressed NFTs (cNFTs) that use state compression.
Filter for assets that are eligible for compression but have not yet been compressed.
Filter assets whose supply is tied to a specific mint.
Royalty target type to filter by.
The royalty target address (Pubkey) to filter by.
Optional response shaping flags. The server also accepts displayOptions as an alias of this field, but only one of options or displayOptions may be present per request.
Responses
200
Returns assets matching the specified search criteria.