searchAssets
Returns the list of assets based on the specified search criteria. This method uses 160 credits from your daily balance.
Parameters
negate: (boolean) [optional] - Indicates whether the search criteria should be inverted.conditionType: (string) [optional] - Indicates whether to retrieve all or any asset that matches the search criteria. Valid options are:all,any.interface: (string) [optional] - The interface of the asset. Valid options are:V1_NFT,V1_PRINT,LEGACY_NFT,V2_NFT,FungibleAsset,Custom,Identity,Executable.ownerAddress: (string) [optional] - Thebase58encoded public key of the owner.ownerType: (string) [optional] - The type of ownership. Valid options are:single,token.creatorAddress: (string) [optional] - Thebase58encoded public key of the creator.creatorVerified: (boolean) [optional] - Indicates whether the creator must be verified.authorityAddress: (string) [optional] - Thebase58encoded public key of the authority.grouping: (array) [optional] - A group (key, value) pair.delegateAddress: (string) [optional] - Thebase58encoded public key of the delegate.frozen: (boolean) [optional] - Indicates whether the asset is frozen.supply: (number) [optional] - The supply of the asset.supplyMint: (string) [optional] - Thebase58encoded public key of the supply mint.compressed: (boolean) [optional] - Indicates whether the asset is compressed.compressible: (boolean) [optional] - Indicates whether the asset is compressible.royaltyTargetType: (string) [optional] - The type of royalty. Valid options are:creators,fanout,single.royaltyTarget: (string) [optional] - The target address for royalties.royaltyAmount: (number) [optional] - The royalties amount.burnt: (boolean) [optional] - Indicates whether the asset is burnt.sortBy: (object) [optional] - Sorting criteria for the results:sortBy- The field to sort by. Valid options are:created,updated,recent_action,id,none.sortDirection- The sort direction. Valid options are:asc,desc.
limit: (number) [optional] - The maximum number of assets to retrieve.page: (number) [optional] - The index of the page to retrieve.before: (string) [optional] - Retrieve assets before the specified ID.after: (string) [optional] - Retrieve assets after the specified ID.jsonUri: (string) [optional] - The value for the JSON URI.
Returns
result - An object containing the following fields:
total- The total number of assets matching the query.limit- The maximum number of assets returned in this response.items- An array of asset objects. Each asset object contains:interface- The interface type of the asset. Valid options are:V1_NFT,V1_PRINT,LEGACY_NFT,V2_NFT,FungibleAsset,FungibleToken,Custom,Identity,Executable,ProgrammableNFT.id- The ID of the asset.content- An object containing the metadata and content information:$schema- The schema URI.json_uri- The URI pointing to the asset's JSON metadata.files- List of associated files withuri,mime, and optionalcontexts.metadata- An object containing the metadata information:name- The name of the asset.symbol- The symbol of the asset.description- A description of the asset.attributes- List of attributes withtrait_typeandvalue.token_standard- The token standard of the asset.
ownership- An object containing the ownership details:owner- The owner's public key.frozen- Whether the asset is frozen.delegated- Whether the asset is delegated.delegate- The delegate's public key.ownership_model- The ownership model, for examplesingleortoken.
compression- An object containing the asset compression details:eligible- Whether the asset is eligible for compression.compressed- Whether the asset is compressed.data_hash- The data hash of the asset.creator_hash- The creator hash of the asset.asset_hash- The asset hash.tree- The Merkle tree ID.seq- The sequence number.leaf_id- The leaf ID.
royalty- An object containing the royalty details:royalty_model- The royalty model (creators,fanout, orsingle).target- The target address for royalties.percent- The royalty percentage.basis_points- The royalty in basis points.primary_sale_happened- Whether the primary sale has occurred.locked- Whether the royalty is locked.
creators- List of creators:address- The creator's public key.share- The creator's share percentage.verified- Whether the creator is verified.
grouping- Grouping details:group_key- The group key (for example,collection).group_value- The group value.
uses- An object containing the usage details:use_method- The usage method (burn,multiple, orsingle).remaining- The remaining uses.total- The total uses.
mutable- Whether the asset is mutable.burnt- Whether the asset is burnt.
Example
Replace <YOUR-API-KEY> with your API key.
Request
- curl
curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "searchAssets",
"params": [
false,
"all",
"V1_NFT",
"2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
"single",
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
{ "sortBy": "created", "sortDirection": "desc" },
50,
1,
null,
null,
null
]
}'
Response
- JSON
{
"jsonrpc": "2.0",
"result": {
"total": 50,
"limit": 50,
"page": 1,
"items": [
{
"interface": "V1_NFT",
"id": "2SiYEckvp5MHz63ybheoehgk7YYPGZksKcxyT7MsJvDS",
"content": {
"$schema": "https://schema.metaplex.com/nft1.0.json",
"json_uri": "https://ipfs.io/ipfs/QmUWytohB2ecUqbor12sm7ozDrVzgbwnCtqF66m9abMLWG",
"files": [],
"metadata": {
"name": "5000 TO 50000 #54",
"symbol": "",
"token_standard": "NonFungible"
},
"links": {}
},
"authorities": [
{
"address": "7GaUkgafjv7uxni4GuvBFp8b1qFVRyZAmwNHzjeFbmTt",
"scopes": [
"full"
]
}
],
"compression": {
"eligible": false,
"compressed": true,
"data_hash": "8uwkK3ydNdnGUbSGTfHjmw8uQ8HheerdEB1RmiL7xyvD",
"creator_hash": "9FiGqDmyw6peu9uZk3XekNC3S7KjaTV6oxC476gPCHLz",
"asset_hash": "9g5DrQ3ndkzLo2mfN74hqhzHG8suKyAetrgJZ4KG4xb8",
"tree": "2xZ7XN9wkUuMRj9RiCbBLXYMofAyHsrEKpWbA3xwxPfG",
"seq": 1038593,
"leaf_id": 1037754
},
"grouping": [
{
"group_key": "collection",
"group_value": "71zrEGzfv4oX3uhc96trWayxdF3xm2kD9WWWoiMZkHAR"
}
],
"royalty": {
"royalty_model": "creators",
"target": null,
"percent": 0.055,
"basis_points": 550,
"primary_sale_happened": false,
"locked": false
},
"creators": [
{
"address": "4AuVuuzh7NA8b8jCcJzARdUALum4MxG9tPYA7QxTPHqo",
"share": 100,
"verified": false
}
],
"ownership": {
"frozen": false,
"delegated": false,
"delegate": null,
"ownership_model": "single",
"owner": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW"
},
"supply": {
"print_max_supply": 0,
"print_current_supply": 0,
"edition_nonce": null
},
"mutable": true,
"burnt": false
},
...
]
},
"id": 1
}