Please note that this RPC method requires the Metaplex Digital Asset Standard (DAS) API enabled on your Quicknode endpoint.

Solana Kit includes the ability to customize RPC methods and transports, allowing you to seamlessly integrate Quicknode add-ons into your applications. For more information on how to use Quicknode 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

groupKey

string

REQUIRED

The key of the group (e.g., "collection")

groupValue

string

REQUIRED

The value of the group

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

sortBy

object

Sorting Criteria.

sortBy

string

The criteria to sort by - can be one of "created", "updated", "recentAction", "none"

sortDirection

string

Can be one of "asc", "desc"

limit

integer

The maximum number of assets to retrieve

cursor

string

The cursor from which to continue returning paginated results

page

integer

The index of the page to retrieve. The page parameter starts at 1

before

string

Retrieve assets before the specified id

after

string

Retrieve assets after the specified id

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

page

integer

The page number of the results

cursor

string

The cursor used for pagination. If no page number is included with request, a pagination cursor will be returned in the reponse if there are additional results. Returns null if no additional results.

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

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc": "2.0","id": 1,"method": "getAssetsByGroup","params": {"groupKey": "collection", "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p", "limit": 10}}'

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc": "2.0","id": 1,"method": "getAssetsByGroup","params": {"groupKey": "collection", "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p", "limit": 10}}'

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getAssetsByGroup",
16
  "params": {
17
    "groupKey": "collection", 
18
    "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
19
    "limit": 10
20
  }
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getAssetsByGroup",
16
  "params": {
17
    "groupKey": "collection", 
18
    "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
19
    "limit": 10
20
  }
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getAssetsByGroup",
16
        "params": {
17
            "groupKey": "collection", 
18
            "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
19
            "limit": 10
20
        }
21
    }"#;
22
    let response = client
23
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
24
        .headers(headers)
25
        .body(json_data)
26
        .send()
27
        .await?; 
28

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

32
    Ok(())
33
}

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getAssetsByGroup",
16
        "params": {
17
            "groupKey": "collection", 
18
            "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
19
            "limit": 10
20
        }
21
    }"#;
22
    let response = client
23
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
24
        .headers(headers)
25
        .body(json_data)
26
        .send()
27
        .await?; 
28

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

32
    Ok(())
33
}

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getAssetsByGroup',
7
  {
8
  "groupKey": "collection",
9
  "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
10
  "limit": 10
11
},
12
  undefined,
13
  'https://docs-demo.solana-mainnet.quiknode.pro/'
14
)
15

16
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getAssetsByGroup',
7
  {
8
  "groupKey": "collection",
9
  "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
10
  "limit": 10
11
},
12
  undefined,
13
  'https://docs-demo.solana-mainnet.quiknode.pro/'
14
)
15

16
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getAssetsByGroup",
8
        {
9
            "groupKey": "collection",
10
            "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
11
            "limit": 10
12
        },
13
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
14
    )
15
    print(result)
16

17
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getAssetsByGroup",
8
        {
9
            "groupKey": "collection",
10
            "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
11
            "limit": 10
12
        },
13
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
14
    )
15
    print(result)
16

17
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getAssetsByGroup",
7
  params: {
8
    "groupKey" => "collection",
9
    "groupValue" => "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
10
    "limit" => 10
11
  },
12
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
13
)
14

15
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getAssetsByGroup",
7
  params: {
8
    "groupKey" => "collection",
9
    "groupValue" => "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
10
    "limit" => 10
11
  },
12
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
13
)
14

15
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getAssetsByGroup",
10
            Some(serde_json::json!({
11
    "groupKey": "collection",
12
    "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
13
    "limit": 10
14
})),
15
            None,
16
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getAssetsByGroup",
10
            Some(serde_json::json!({
11
    "groupKey": "collection",
12
    "groupValue": "J2ZfLdQsaZ3GCmbucJef3cPnPwGcgjDW1SSYtMdq3L9p",
13
    "limit": 10
14
})),
15
            None,
16
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "total": 1,
5
    "limit": 1,
6
    "page": 1,
7
    "items": [
8
      {
9
        "interface": "ProgrammableNFT",
10
        "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",
11
        "authorities": [
12
          {
13
            "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
14
            "scopes": [
15
              "full"
16
            ]
17
          }
18
        ],
19
        "compression": {
20
          "eligible": false,
21
          "compressed": false,
22
          "data_hash": "",
23
          "creator_hash": "",
24
          "asset_hash": "",
25
          "tree": "",
26
          "seq": 0,
27
          "leaf_id": 0
28
        },
29
        "grouping": [
30
          {
31
            "group_key": "collection",
32
            "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"
33
          }
34
        ],
35
        "royalty": {
36
          "royalty_model": "creators",
37
          "target": null,
38
          "percent": 0.042,
39
          "basis_points": 420,
40
          "primary_sale_happened": true,
41
          "locked": false
42
        },
43
        "creators": [
44
          {
45
            "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",
46
            "share": 0,
47
            "verified": true
48
          }
49
        ],
50
        "ownership": {
51
          "frozen": true,
52
          "delegated": false,
53
          "delegate": null,
54
          "ownership_model": "single",
55
          "owner": "3F21SJs4FMpsakrxmd8GjgfQZG6BN6MVsvXcm5Yc6Jcf"
56
        },
57
        "supply": {
58
          "print_max_supply": 0,
59
          "print_current_supply": 0,
60
          "edition_nonce": 254
61
        },
62
        "mutable": true,
63
        "burnt": false
64
      }
65
    ]
66
  }
67
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "total": 1,
5
    "limit": 1,
6
    "page": 1,
7
    "items": [
8
      {
9
        "interface": "ProgrammableNFT",
10
        "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",
11
        "authorities": [
12
          {
13
            "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
14
            "scopes": [
15
              "full"
16
            ]
17
          }
18
        ],
19
        "compression": {
20
          "eligible": false,
21
          "compressed": false,
22
          "data_hash": "",
23
          "creator_hash": "",
24
          "asset_hash": "",
25
          "tree": "",
26
          "seq": 0,
27
          "leaf_id": 0
28
        },
29
        "grouping": [
30
          {
31
            "group_key": "collection",
32
            "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"
33
          }
34
        ],
35
        "royalty": {
36
          "royalty_model": "creators",
37
          "target": null,
38
          "percent": 0.042,
39
          "basis_points": 420,
40
          "primary_sale_happened": true,
41
          "locked": false
42
        },
43
        "creators": [
44
          {
45
            "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",
46
            "share": 0,
47
            "verified": true
48
          }
49
        ],
50
        "ownership": {
51
          "frozen": true,
52
          "delegated": false,
53
          "delegate": null,
54
          "ownership_model": "single",
55
          "owner": "3F21SJs4FMpsakrxmd8GjgfQZG6BN6MVsvXcm5Yc6Jcf"
56
        },
57
        "supply": {
58
          "print_max_supply": 0,
59
          "print_current_supply": 0,
60
          "edition_nonce": 254
61
        },
62
        "mutable": true,
63
        "burnt": false
64
      }
65
    ]
66
  }
67
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free