> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getAssetsByGroup
> Retrieve all Solana NFTs and compressed NFTs in a specific collection or group with flexible grouping keys and pagination support
## Request Parameters
The Solana group classification type to search by (e.g., 'collection', 'community', 'creator', etc.).
The Solana collection address or group identifier to retrieve all matching NFTs for.
The page number for paginating through the Solana collection results.
The maximum number of Solana NFTs to return per request from this collection.
The sorting options for the response.
The criteria by which the retrieved Solana NFTs in the collection will be sorted.
* `created`
* `recent_action`
* `updated`
* `none`
The direction by which the retrieved Solana NFTs in the collection will be sorted.
* `asc`
* `desc`
The cursor for paginating backwards through the assets.
The cursor for paginating forwards through the assets.
The display options for the response.
Displays grouping information for unverified collections instead of skipping them.
Displays metadata for the collection.
Shows the total number of assets that matched the query. This will make the request slower.
## OpenAPI
````yaml openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Collection Explorer API
version: 1.0.0
description: >
Advanced Solana Digital Asset Standard (DAS) API for exploring complete NFT
collections and token groups
on the Solana blockchain. This specialized collection browsing API enables
applications to retrieve all
digital assets within specific collections, communities, or groupings with
powerful filtering and sorting
capabilities. Perfect for NFT marketplaces, portfolio applications, and
analytics platforms that need to
display complete collections with consistent formatting across both
traditional and compressed NFTs.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Mainnet RPC endpoint
- url: https://devnet.helius-rpc.com
description: Devnet RPC endpoint
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Retrieve all Solana digital assets belonging to a specific collection or
grouping.
This powerful collection browsing API returns a complete list of NFTs
that share the same
group designation (such as collection, community, or other grouping),
with comprehensive
metadata and ownership details for each asset. Essential for NFT
marketplaces displaying
collections, portfolio applications showing grouped assets, and
analytics platforms tracking
collection-wide metrics across the Solana ecosystem.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The version of the JSON-RPC protocol.
default: '2.0'
id:
type: string
description: An ID to identify the request.
default: '1'
method:
type: string
enum:
- getAssetsByGroup
description: The name of the DAS method to invoke.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
The Solana group classification type to search by (e.g.,
'collection', 'community', 'creator', etc.).
example: collection
groupValue:
type: string
description: >-
The Solana collection address or group identifier to
retrieve all matching NFTs for.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
The page number for paginating through the Solana
collection results.
example: 1
limit:
type: integer
description: >-
The maximum number of Solana NFTs to return per request
from this collection.
example: 100
sortBy:
type: object
description: The sorting options for the response.
properties:
sortBy:
type: string
description: >-
The criteria by which the retrieved Solana NFTs in
the collection will be sorted.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
The direction by which the retrieved Solana NFTs in
the collection will be sorted.
enum:
- asc
- desc
before:
type: string
description: The cursor for paginating backwards through the assets.
example: string
after:
type: string
description: The cursor for paginating forwards through the assets.
example: string
options:
type: object
description: The display options for the response.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Displays grouping information for unverified
collections instead of skipping them.
default: false
showCollectionMetadata:
type: boolean
description: Displays metadata for the collection.
default: false
showGrandTotal:
type: boolean
description: >-
Shows the total number of assets that matched the
query. This will make the request slower.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
All data up to and including this slot is guaranteed
to have been indexed.
example: 365750752
total:
type: integer
description: >-
The total number of Solana NFTs found in this
collection or group.
example: 1
limit:
type: integer
description: The maximum number of assets requested.
example: 1
page:
type: integer
description: The current page of results.
example: 1
items:
type: array
description: >-
An array of Solana NFTs belonging to this collection
or group.
items:
type: object
properties:
interface:
type: string
description: >-
The Solana token standard interface of the NFT
in this collection.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: ProgrammableNFT
is_agent:
type: boolean
description: >-
Whether this asset has an Agent Identity (MPL
Core AgentIdentity external plugin). Omitted
when false.
agent_token:
type: string
description: >-
Base58-encoded agent token mint from the Agent
Registry program. Omitted when not registered.
asset_signer:
type: string
description: >-
Base58-encoded asset-signer PDA for MPL Core.
Omitted when not applicable.
plugins:
type: object
description: >-
MPL Core plugins, including optional MIP-11
`groups` membership.
additionalProperties: true
id:
type: string
description: >-
The unique mint address of this Solana NFT in
the collection.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
The update authorities for this Solana NFT in
the collection.
compression:
type: object
description: >-
The compression status of this Solana NFT,
indicating if it uses state compression
technology.
grouping:
type: array
description: >-
The collection and grouping associations for
this Solana NFT.
royalty:
type: object
description: >-
The royalty configuration for this Solana NFT
when sold in marketplaces.
creators:
type: array
description: >-
The verified creator addresses associated with
this Solana NFT in the collection.
ownership:
type: object
description: >-
The current ownership details for this Solana
NFT in the collection.
supply:
type: object
description: >-
The supply information for this Solana NFT if
it's a master edition with prints.
mutable:
type: boolean
description: >-
Whether this Solana NFT's metadata can be
updated by the authority.
example: true
burnt:
type: boolean
description: >-
Whether this Solana NFT has been
burned/destroyed.
example: false
'400':
description: >-
Bad Request. The server could not understand the request due to
invalid syntax.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: Invalid request parameters.
id:
type: string
example: '1'
'401':
description: >-
Unauthorized. The client must authenticate itself to get the
requested response.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: Authentication failed. Missing or invalid API key.
id:
type: string
example: '1'
'403':
description: Forbidden. The client does not have access rights to the content.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: You do not have permission to access this resource.
id:
type: string
example: '1'
'404':
description: Not Found. The server can not find the requested resource.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: No assets found for the specified group.
id:
type: string
example: '1'
'429':
description: >-
Too Many Requests. The user has sent too many requests in a given
amount of time.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: Rate limit exceeded. Please try again later.
id:
type: string
example: '1'
'500':
description: >-
Internal Server Error. The server has encountered a situation it
doesn't know how to handle.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: An unexpected error occurred on the server.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Your Helius API key. You can get one for free in the
[dashboard](https://dashboard.helius.dev/api-keys).
````