getAssets RPC Method

Please note that this RPC method requires the Solana DAS (Digital Asset Standard) API add-on enabled on your QuickNode endpoint.

Solana Kit includes the ability to customize RPC methods and transports, allowing you to seamlessly integrate QuickNode Marketplace add-ons into your applications. For more information on how to use QuickNode Marketplace add-ons with Solana Kit, check out these guides: How to Use QuickNode Add-ons using Solana Kit (Part 1) and How to Use QuickNode Add-ons using Solana Kit (Part 2)

Parameters

ids

array of strings

REQUIRED

The ids of the assets

options

object

Optional flags which can be used to return additional information about an asset

showFungible

boolean

Whether to return token_info object about an asset

showCollectionMetadata

boolean

Whether to return the collection metadata

Returns

assetList

object

The information about the list of assets:

total

integer

The number of assets returned

limit

integer

The limit specified in the request

items

array of objects

An array of objects containing information about the specified assets:

asset

object

The information about the specified asset:

interface

string

The asset interface. "V1_NFT", "V1_PRINT", "LEGACY_NFT", "V2_NFT", "FungibleAsset", "FungibleToken", "Custom", "Identity", "Executable", "ProgrammableNFT", "MplCoreAsset", "MplCoreCollection"

id

string

The asset id

content

object

An object containting the asset content:

$schema

string

The schema of the asset

json_uri

string

The json uri of the asset

files

array of objects

The files related to the asset

uri

string

The uri of the file

mime

string

The mime type of the file

quality

object

The quality of the file

contexts

array of strings

The contexts of the file

metadata

object

The metadata of the asset

name

string

The name of the asset

description

string

The description of the asset

symbol

string

The symbol of the asset

token_standard

string

The token standard of the asset

attributes

array of objects

The attributes of the asset

value

integer/string

The value of the attribute

trait_type

string

The type of attribute

links

object

Links related to the asset

external_url

string

The external url

image

string

The url of the image

authorities

array of objects

The list of authorities

address

string

The address of the authority

scopes

array of strings

The scopes of the authority - "full", "royalty", "metadata", "extension"

compression

object

The compression information for this asset

asset_hash

string

The asset hash of this asset

compressed

boolean

The compression status of this asset

creator_hash

string

The creator hash of this asset

data_hash

string

The data hash of this asset

eligible

boolean

Whether this asset is eligible

leaf_id

integer

The leaf id of this asset

seq

integer

The seq of this asset

tree

string

The tree associated with this asset

grouping

array of objects

The grouping information for this asset

group_key

string

The group key for this asset. "collection"

group_value

string

The group value for this asset

royalty

string

Royalty information about this asset

basis_points

integer

The royalty basis points

locked

boolean

The locked status of the royalty

percent

integer

The royalty percent

primary_sale_happened

boolean

The primary sale status

royalty_model

string

The royalty model for this asset. "creators", "fanout", "single"

target

string

The royalty target

creators

array of objects

The list of creators for this asset

address

string

The address of the creator

share

integer

The share of the creator

verified

boolean

Whether the creator is verified

ownership

object

The ownership information of the asset

delegate

string

The delegate of the asset

delegated

boolean

Whether the asset is delegated

frozen

boolean

Whether the asset is frozen

owner

string

The owner of the asset

ownership_model

string

The ownership model of the asset. "single","token"

uses

object

The uses information of the asset

remaining

integer

The remaining uses

total

integer

The total uses

use_method

string

The use method. "burn","multiple","single"

supply

object

The supply information of the asset

edition_nonce

integer

The edition nonce

print_current_supply

integer

The current supply

print_max_supply

integer

The max supply

mutable

boolean

Whether the asset's metadata is mutable

burnt

boolean

Whether the asset is burnt

mint_extensions

object

Mint extensions of the asset

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc": "2.0","id": 1,"method": "getAssets","params": {"ids": ["9ARngHhVaCtH5JFieRdSS5Y8cdZk2TMF4tfGSWFB9iSK", "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk"]}}'

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAssets",
  "params": {
    "ids": [
      "9ARngHhVaCtH5JFieRdSS5Y8cdZk2TMF4tfGSWFB9iSK", 
      "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk"
    ]
  }
})

response = https.request(request)
puts response.read_body

use reqwest::header;
use reqwest::Client;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = Client::new();
    let json_data = r#"
    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "getAssets",
        "params": {
            "ids": [
                "9ARngHhVaCtH5JFieRdSS5Y8cdZk2TMF4tfGSWFB9iSK", 
                "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk"
            ]
        }
    }"#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}

Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "interface": "ProgrammableNFT",
      "id": "9ARngHhVaCtH5JFieRdSS5Y8cdZk2TMF4tfGSWFB9iSK",
      "content": {
        "$schema": "https://schema.metaplex.com/nft1.0.json",
        "json_uri": "https://arweave.net/w4RVczdWwyiWS8tXgDenLEL7iFDdu4bi2YVmGyQo_dE/1355.json",
        "files": [
          {
            "uri": "https://arweave.net/wGChHSDTXTP9oAtTaYh9s8j1MRE0IPmYtH5greqWwZ4",
            "mime": "image/png"
          }
        ],
        "metadata": {
          "attributes": [
            {
              "value": 2,
              "trait_type": "Attributes Count"
            },
            {
              "value": "Skeleton",
              "trait_type": "Type"
            },
            {
              "value": "Orange Jacket",
              "trait_type": "Clothes"
            },
            {
              "value": "None",
              "trait_type": "Ears"
            },
            {
              "value": "None",
              "trait_type": "Mouth"
            },
            {
              "value": "None",
              "trait_type": "Eyes"
            },
            {
              "value": "Crown",
              "trait_type": "Hat"
            }
          ],
          "description": "SMB is a collection of 5000 randomly generated 24x24 pixels NFTs on the Solana Blockchain. Each SolanaMonkey is unique and comes with different type and attributes varying in rarity.",
          "name": "SMB #1355",
          "symbol": "SMB",
          "token_standard": "ProgrammableNonFungible"
        },
        "links": {
          "image": "https://arweave.net/wGChHSDTXTP9oAtTaYh9s8j1MRE0IPmYtH5greqWwZ4",
          "external_url": "https://solanamonkey.business/"
        }
      },
      "authorities": [
        {
          "address": "mdaoxg4DVGptU4WSpzGyVpK3zqsgn7Qzx5XNgWTcEA2",
          "scopes": [
            "full"
          ]
        }
      ],
      "compression": {
        "eligible": false,
        "compressed": false,
        "data_hash": "",
        "creator_hash": "",
        "asset_hash": "",
        "tree": "",
        "seq": 0,
        "leaf_id": 0
      },
      "grouping": [
        {
          "group_key": "collection",
          "group_value": "SMBtHCCC6RYRutFEPb4gZqeBLUZbMNhRKaMKZZLHi7W"
        }
      ],
      "royalty": {
        "royalty_model": "creators",
        "target": null,
        "percent": 0,
        "basis_points": 0,
        "primary_sale_happened": true,
        "locked": false
      },
      "creators": [
        {
          "address": "mdaoxg4DVGptU4WSpzGyVpK3zqsgn7Qzx5XNgWTcEA2",
          "share": 0,
          "verified": true
        },
        {
          "address": "HAryckvjyViFQEmhmMoCtqqBMJnpXEYViamyDhZUJfnG",
          "share": 100,
          "verified": false
        },
        {
          "address": "9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F",
          "share": 0,
          "verified": false
        }
      ],
      "ownership": {
        "frozen": true,
        "delegated": false,
        "delegate": null,
        "ownership_model": "single",
        "owner": "A5s2T7DQzPSUXpGKPiFC5vEcJXUkuunv1SjpwkD1JG8e"
      },
      "supply": {
        "print_max_supply": 0,
        "print_current_supply": 0,
        "edition_nonce": 255
      },
      "mutable": false,
      "burnt": false
    },
    {
      "interface": "ProgrammableNFT",
      "id": "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk",
      "content": {
        "$schema": "https://schema.metaplex.com/nft1.0.json",
        "json_uri": "https://madlads.s3.us-west-2.amazonaws.com/json/8420.json",
        "files": [
          {
            "uri": "https://madlads.s3.us-west-2.amazonaws.com/images/8420.png",
            "mime": "image/png"
          },
          {
            "uri": "https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png",
            "mime": "image/png"
          }
        ],
        "metadata": {
          "attributes": [
            {
              "value": "Male",
              "trait_type": "Gender"
            },
            {
              "value": "King",
              "trait_type": "Type"
            },
            {
              "value": "Royal",
              "trait_type": "Expression"
            },
            {
              "value": "Mad Crown",
              "trait_type": "Hat"
            },
            {
              "value": "Madness",
              "trait_type": "Eyes"
            },
            {
              "value": "Mad Armor",
              "trait_type": "Clothing"
            },
            {
              "value": "Royal Rug",
              "trait_type": "Background"
            }
          ],
          "description": "Fock it.",
          "name": "Mad Lads #8420",
          "symbol": "MAD",
          "token_standard": "ProgrammableNonFungible"
        },
        "links": {
          "image": "https://madlads.s3.us-west-2.amazonaws.com/images/8420.png",
          "external_url": "https://madlads.com"
        }
      },
      "authorities": [
        {
          "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
          "scopes": [
            "full"
          ]
        }
      ],
      "compression": {
        "eligible": false,
        "compressed": false,
        "data_hash": "",
        "creator_hash": "",
        "asset_hash": "",
        "tree": "",
        "seq": 0,
        "leaf_id": 0
      },
      "grouping": [
        {
          "group_key": "collection",
          "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"
        }
      ],
      "royalty": {
        "royalty_model": "creators",
        "target": null,
        "percent": 0.042,
        "basis_points": 420,
        "primary_sale_happened": true,
        "locked": false
      },
      "creators": [
        {
          "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",
          "share": 0,
          "verified": true
        },
        {
          "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
          "share": 100,
          "verified": true
        }
      ],
      "ownership": {
        "frozen": true,
        "delegated": false,
        "delegate": null,
        "ownership_model": "single",
        "owner": "4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue"
      },
      "supply": {
        "print_max_supply": 0,
        "print_current_supply": 0,
        "edition_nonce": 254
      },
      "mutable": true,
      "burnt": false
    }
  ],
  "id": 1
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free