> ## 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
> Recupera todos los NFT de Solana y los NFT comprimidos de una colección o grupo específicos, con claves de agrupación flexibles y compatibilidad con paginación
## Parámetros de la solicitud
El tipo de clasificación de grupo de Solana por el que se realizará la búsqueda (p. ej., 'collection', 'community', 'creator', etc.).
La dirección de la colección de Solana o el identificador de grupo para recuperar todos los NFT coincidentes.
El número de página para paginar los resultados de la colección de Solana.
La cantidad máxima de NFT de Solana que se devolverá por solicitud desde esta colección.
Las opciones de ordenación de la respuesta.
Los criterios según los cuales se ordenarán los NFT de Solana recuperados de la colección.
* `created`
* `recent_action`
* `updated`
* `none`
La dirección en la que se ordenarán los NFT de Solana recuperados de la colección.
* `asc`
* `desc`
El cursor para paginar hacia atrás por los activos.
El cursor para paginar hacia adelante por los activos.
Las opciones de visualización de la respuesta.
Muestra la información de agrupación de las colecciones no verificadas en lugar de omitirlas.
Muestra los metadatos de la colección.
Muestra la cantidad total de activos que coincidieron con la consulta. Esto hará que la solicitud sea más lenta.
## OpenAPI
````yaml es/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: API del explorador de colecciones NFT de Solana
version: 1.0.0
description: >
API avanzada del estándar de activos digitales (DAS) de Solana para explorar
colecciones completas de NFT y grupos de tokens
en la blockchain de Solana. Esta API especializada en la exploración de
colecciones permite que las aplicaciones recuperen todos los
activos digitales de colecciones, comunidades o grupos específicos, con
potentes funciones de filtrado y ordenamiento.
Es ideal para mercados de NFT, aplicaciones de portafolio y plataformas de
análisis que necesitan
mostrar colecciones completas con un formato uniforme tanto para NFT
tradicionales como comprimidos.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Recupera todos los activos digitales de Solana que pertenecen a una
colección o grupo específico.
Esta potente API de exploración de colecciones devuelve una lista
completa de los NFT que comparten la misma
designación de grupo (como una colección, comunidad u otro grupo), con
metadatos completos
y detalles de propiedad de cada activo. Es esencial para mercados de NFT
que muestran
colecciones, aplicaciones de portafolio que muestran activos agrupados y
plataformas de análisis que supervisan
métricas de colecciones completas en todo el ecosistema de Solana.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
default: '2.0'
id:
type: string
description: Un ID para identificar la solicitud.
default: '1'
method:
type: string
enum:
- getAssetsByGroup
description: El nombre del método DAS que se invocará.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
El tipo de clasificación de grupo de Solana por el que
se buscará (p. ej., 'collection', 'community',
'creator', etc.).
example: collection
groupValue:
type: string
description: >-
La dirección de la colección de Solana o el
identificador de grupo para recuperar todos los NFT
coincidentes.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
El número de página para paginar los resultados de la
colección de Solana.
example: 1
limit:
type: integer
description: >-
La cantidad máxima de NFT de Solana que se devolverá por
solicitud de esta colección.
example: 100
sortBy:
type: object
description: Las opciones de ordenamiento de la respuesta.
properties:
sortBy:
type: string
description: >-
El criterio por el que se ordenarán los NFT de
Solana recuperados de la colección.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
La dirección en la que se ordenarán los NFT de
Solana recuperados de la colección.
enum:
- asc
- desc
before:
type: string
description: El cursor para paginar hacia atrás por los activos.
example: string
after:
type: string
description: El cursor para paginar hacia adelante por los activos.
example: string
options:
type: object
description: Las opciones de visualización de la respuesta.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Muestra la información de agrupación de las
colecciones no verificadas en lugar de omitirlas.
default: false
showCollectionMetadata:
type: boolean
description: Muestra los metadatos de la colección.
default: false
showGrandTotal:
type: boolean
description: >-
Muestra la cantidad total de activos que
coincidieron con la consulta. Esto hará que la
solicitud sea más lenta.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Respuesta correcta
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Se garantiza que se indexaron todos los datos hasta
este slot, inclusive.
example: 365750752
total:
type: integer
description: >-
La cantidad total de NFT de Solana encontrados en esta
colección o grupo.
example: 1
limit:
type: integer
description: La cantidad máxima de activos solicitados.
example: 1
page:
type: integer
description: La página actual de resultados.
example: 1
items:
type: array
description: >-
Un arreglo de NFT de Solana que pertenecen a esta
colección o grupo.
items:
type: object
properties:
interface:
type: string
description: >-
La interfaz del estándar de tokens de Solana del
NFT en esta colección.
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: >-
Indica si este activo tiene una identidad de
agente (complemento externo AgentIdentity de MPL
Core). Se omite cuando es false.
agent_token:
type: string
description: >-
Dirección de acuñación del token de agente
codificada en Base58 del programa Agent
Registry. Se omite cuando no está registrado.
asset_signer:
type: string
description: >-
PDA del firmante del activo codificada en Base58
para MPL Core. Se omite cuando no corresponde.
plugins:
type: object
description: >-
Complementos de MPL Core, incluida la
pertenencia opcional a `groups` de MIP-11.
additionalProperties: true
id:
type: string
description: >-
La dirección de acuñación única de este NFT de
Solana en la colección.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
Las autoridades de actualización de este NFT de
Solana en la colección.
compression:
type: object
description: >-
El estado de compresión de este NFT de Solana,
que indica si utiliza tecnología de compresión
de estado.
grouping:
type: array
description: >-
Las asociaciones de colección y agrupación de
este NFT de Solana.
royalty:
type: object
description: >-
La configuración de regalías de este NFT de
Solana cuando se vende en mercados.
creators:
type: array
description: >-
Las direcciones verificadas de los creadores
asociadas con este NFT de Solana en la
colección.
ownership:
type: object
description: >-
Los detalles actuales de propiedad de este NFT
de Solana en la colección.
supply:
type: object
description: >-
La información de suministro de este NFT de
Solana si es una edición maestra con copias.
mutable:
type: boolean
description: >-
Indica si la autoridad puede actualizar los
metadatos de este NFT de Solana.
example: true
burnt:
type: boolean
description: >-
Indica si este NFT de Solana se quemó o
destruyó.
example: false
'400':
description: >-
Solicitud incorrecta. El servidor no pudo comprender la solicitud
debido a una sintaxis no válida.
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: Parámetros de solicitud no válidos.
id:
type: string
example: '1'
'401':
description: >-
No autorizado. El cliente debe autenticarse para obtener la
respuesta solicitada.
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: >-
Error de autenticación. Falta la clave de API o no es
válida.
id:
type: string
example: '1'
'403':
description: Prohibido. El cliente no tiene derechos de acceso al contenido.
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: No tienes permiso para acceder a este recurso.
id:
type: string
example: '1'
'404':
description: No encontrado. El servidor no puede encontrar el recurso solicitado.
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 se encontraron activos para el grupo especificado.
id:
type: string
example: '1'
'429':
description: >-
Demasiadas solicitudes. El usuario envió demasiadas solicitudes en
un periodo determinado.
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: >-
Se superó el límite de solicitudes. Inténtalo de nuevo
más tarde.
id:
type: string
example: '1'
'500':
description: >-
Error interno del servidor. El servidor encontró una situación que
no sabe cómo gestionar.
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: Ocurrió un error inesperado en el servidor.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````