> ## 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
> Получение всех NFT и сжатых NFT Solana из определенной коллекции или группы с гибкими ключами группировки и поддержкой пагинации
## Параметры запроса
Тип классификации группы Solana, по которому выполняется поиск (например, 'collection', 'community', 'creator' и т. д.).
Адрес коллекции Solana или идентификатор группы, для которой необходимо получить все соответствующие NFT.
Номер страницы для пагинации результатов коллекции Solana.
Максимальное количество NFT Solana из этой коллекции, возвращаемое за один запрос.
Параметры сортировки ответа.
Критерий сортировки полученных NFT Solana в коллекции.
* `created`
* `recent_action`
* `updated`
* `none`
Направление сортировки полученных NFT Solana в коллекции.
* `asc`
* `desc`
Курсор для постраничного перехода назад по активам.
Курсор для постраничного перехода вперед по активам.
Параметры отображения ответа.
Отображает сведения о группировке для непроверенных коллекций вместо их пропуска.
Отображает метаданные коллекции.
Показывает общее количество активов, соответствующих запросу. Это замедлит выполнение запроса.
## OpenAPI
````yaml ru/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: API для просмотра коллекций NFT в Solana
version: 1.0.0
description: >
Расширенный API стандарта цифровых активов Solana (DAS) для просмотра полных
коллекций NFT и групп токенов
в блокчейне Solana. Этот специализированный API для просмотра коллекций
позволяет приложениям получать все
цифровые активы из определенных коллекций, сообществ или групп благодаря
широким возможностям фильтрации и сортировки.
Он идеально подходит для маркетплейсов NFT, портфельных приложений и
аналитических платформ, которым нужно
отображать полные коллекции с единообразным форматированием как
традиционных, так и сжатых NFT.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Конечная точка RPC основной сети
- url: https://devnet.helius-rpc.com
description: Конечная точка RPC тестовой сети Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Получает все цифровые активы Solana, принадлежащие определенной
коллекции или группе.
Этот мощный API для просмотра коллекций возвращает полный список NFT с
одинаковым
обозначением группы (например, коллекции, сообщества или другой группы),
а также исчерпывающие
метаданные и сведения о владельцах каждого актива. Он необходим
маркетплейсам NFT для отображения
коллекций, портфельным приложениям для показа сгруппированных активов и
аналитическим платформам для отслеживания
показателей всей коллекции в экосистеме Solana.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Версия протокола JSON-RPC.
default: '2.0'
id:
type: string
description: Идентификатор запроса.
default: '1'
method:
type: string
enum:
- getAssetsByGroup
description: Название вызываемого метода DAS.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
Тип классификации группы Solana, по которому выполняется
поиск (например, 'collection', 'community', 'creator' и
т. д.).
example: collection
groupValue:
type: string
description: >-
Адрес коллекции Solana или идентификатор группы, для
которой нужно получить все соответствующие NFT.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
Номер страницы для постраничного просмотра результатов
по коллекции Solana.
example: 1
limit:
type: integer
description: >-
Максимальное количество NFT Solana из этой коллекции,
возвращаемое за один запрос.
example: 100
sortBy:
type: object
description: Параметры сортировки ответа.
properties:
sortBy:
type: string
description: >-
Критерий сортировки полученных NFT Solana из
коллекции.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
Направление сортировки полученных NFT Solana из
коллекции.
enum:
- asc
- desc
before:
type: string
description: >-
Курсор для постраничного просмотра активов в обратном
направлении.
example: string
after:
type: string
description: >-
Курсор для постраничного просмотра активов в прямом
направлении.
example: string
options:
type: object
description: Параметры отображения ответа.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Отображает сведения о группировке для непроверенных
коллекций вместо их пропуска.
default: false
showCollectionMetadata:
type: boolean
description: Отображает метаданные коллекции.
default: false
showGrandTotal:
type: boolean
description: >-
Показывает общее количество активов, соответствующих
запросу. Это замедляет выполнение запроса.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Успешный ответ
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Гарантируется, что проиндексированы все данные до
этого слота включительно.
example: 365750752
total:
type: integer
description: >-
Общее количество NFT Solana, найденных в этой
коллекции или группе.
example: 1
limit:
type: integer
description: Запрошенное максимальное количество активов.
example: 1
page:
type: integer
description: Текущая страница результатов.
example: 1
items:
type: array
description: >-
Массив NFT Solana, принадлежащих этой коллекции или
группе.
items:
type: object
properties:
interface:
type: string
description: >-
Интерфейс стандарта токена Solana для NFT в этой
коллекции.
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: >-
Указывает, есть ли у этого актива идентификатор
агента (внешний плагин MPL Core AgentIdentity).
Если значение равно false, поле не включается.
agent_token:
type: string
description: >-
Адрес выпуска токена агента из программы Agent
Registry в кодировке Base58. Если токен не
зарегистрирован, поле не включается.
asset_signer:
type: string
description: >-
PDA подписанта актива для MPL Core в кодировке
Base58. Если неприменимо, поле не включается.
plugins:
type: object
description: >-
Плагины MPL Core, включая необязательное
членство в `groups` согласно MIP-11.
additionalProperties: true
id:
type: string
description: >-
Уникальный адрес выпуска этого NFT Solana в
коллекции.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
Полномочия на обновление этого NFT Solana в
коллекции.
compression:
type: object
description: >-
Состояние сжатия этого NFT Solana, указывающее,
использует ли он технологию сжатия состояния.
grouping:
type: array
description: Связи этого NFT Solana с коллекциями и группами.
royalty:
type: object
description: >-
Конфигурация роялти для этого NFT Solana при
продаже на маркетплейсах.
creators:
type: array
description: >-
Адреса проверенных создателей, связанные с этим
NFT Solana в коллекции.
ownership:
type: object
description: >-
Текущие сведения о владельце этого NFT Solana в
коллекции.
supply:
type: object
description: >-
Сведения о предложении этого NFT Solana, если
это основное издание с копиями.
mutable:
type: boolean
description: >-
Указывает, может ли уполномоченная сторона
обновлять метаданные этого NFT Solana.
example: true
burnt:
type: boolean
description: >-
Указывает, был ли этот NFT Solana сожжен или
уничтожен.
example: false
'400':
description: >-
Некорректный запрос. Сервер не смог распознать запрос из-за
недопустимого синтаксиса.
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: Недопустимые параметры запроса.
id:
type: string
example: '1'
'401':
description: >-
Не авторизовано. Клиент должен пройти аутентификацию, чтобы получить
запрошенный ответ.
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: >-
Ошибка аутентификации. Ключ API отсутствует или
недействителен.
id:
type: string
example: '1'
'403':
description: Доступ запрещен. У клиента нет прав доступа к содержимому.
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: У вас нет разрешения на доступ к этому ресурсу.
id:
type: string
example: '1'
'404':
description: Не найдено. Сервер не может найти запрошенный ресурс.
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: Для указанной группы активы не найдены.
id:
type: string
example: '1'
'429':
description: >-
Слишком много запросов. Пользователь отправил слишком много запросов
за определенный период времени.
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: >-
Превышен лимит частоты запросов. Повторите попытку
позже.
id:
type: string
example: '1'
'500':
description: >-
Внутренняя ошибка сервера. Сервер столкнулся с ситуацией, которую не
может обработать.
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: На сервере произошла непредвиденная ошибка.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Ваш ключ API Helius. Его можно бесплатно получить на [панели
управления](https://dashboard.helius.dev/api-keys).
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.