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] - The base58 encoded public key of the owner.
• ownerType: (string) [optional] - The type of ownership. Valid options are: single, token.
• creatorAddress: (string) [optional] - The base58 encoded public key of the creator.
• creatorVerified: (boolean) [optional] - Indicates whether the creator must be verified.
• authorityAddress: (string) [optional] - The base58 encoded public key of the authority.
• grouping: (array) [optional] - A group (key, value) pair.
• delegateAddress: (string) [optional] - The base58 encoded 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] - The base58 encoded 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 with uri, mime, and optional contexts.
    • 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 with trait_type and value.
      • 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 example single or token.
  • 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, or single).
    • 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, or single).
    • 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
}