> ## 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.
# searchAssets
> Busca y filtra NFT de Solana, NFT comprimidos y tokens mediante criterios flexibles, como propiedad, creadores, colecciones y atributos personalizados
## Parámetros de la solicitud
La dirección de la billetera de Solana cuyos activos digitales se recuperarán para filtrar los resultados de búsqueda.
Filtra por tipos específicos de tokens de Solana, incluidos NFT comprimidos (cNFT), NFT normales,
NFT programables (pNFT) o tokens SPL fungibles, para encontrar activos específicos.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
La página de resultados que se devolverá.
Criterio de dirección de autoridad para filtrar activos digitales de Solana según la autoridad del programa.
Es útil para encontrar activos controlados por protocolos o autoridades de actualización específicos.
La cantidad máxima de activos que se devolverá.
Las opciones de ordenamiento de la respuesta.
El criterio por el que se ordenarán los activos.
* `created`
* `recent_action`
* `updated`
* `none`
La dirección del ordenamiento.
* `asc`
* `desc`
Filtra NFT comprimidos de Solana (cNFT) que usan tecnología de compresión de estado
para reducir los costos de almacenamiento y mejorar la escalabilidad.
Filtra activos de Solana que pueden comprimirse, pero que aún no
se han comprimido en el formato de compresión de estado.
Criterio de delegado para la búsqueda de activos.
Criterio de dirección de la billetera del creador para encontrar NFT de Solana creados por artistas,
proyectos o creadores específicos, con fines de atribución y seguimiento de regalías.
Indica si un creador está verificado.
Arreglo de agrupación de colecciones para filtrar NFT de Solana según su pertenencia a una colección
(p. ej., \["collection", "\"]) y encontrar activos relacionados.
Dirección del árbol de Merkle para filtrar NFT comprimidos (cNFT) según el árbol de su colección.
Este parámetro es específico de Helius y no forma parte de la especificación oficial de DAS.
Criterio de suministro para la búsqueda de activos.
Criterio de mint de suministro para la búsqueda de activos.
Indica si un activo está congelado.
Indica si un activo está quemado.
Filtra activos que tengan una identidad de agente (plugin externo MPL Core AgentIdentity).
Filtra por la dirección base58 del mint del token del agente del programa Agent Registry.
Filtra por el PDA firmante del activo en base58 (MPL Core).
El tipo de interfaz del estándar de tokens de Solana para filtrar implementaciones específicas de NFT,
incluidos NFT programables, NFT heredados, tokens fungibles y activos, colecciones o grupos de MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Criterio del tipo de destinatario de las regalías.
Criterio del destinatario de las regalías.
Criterio del monto de las regalías.
Criterio del modelo de propiedad.
Un cursor para paginar hacia atrás.
Un cursor para paginar hacia adelante.
Opciones avanzadas de visualización para personalizar la respuesta de búsqueda de activos de Solana.
Muestra las colecciones no verificadas en lugar de omitirlas.
Muestra los metadatos de la colección.
Muestra la cantidad total de activos coincidentes (solicitud más lenta).
Muestra el saldo nativo (SOL) del propietario.
Muestra los activos con saldo cero.
## OpenAPI
````yaml es/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: API de descubrimiento y búsqueda de NFT de Solana
version: 1.0.0
description: >
API avanzada del estándar de activos digitales (DAS) de Solana para buscar y
descubrir NFT, tokens y otros activos digitales en todo el ecosistema de
Solana, con potentes capacidades de filtrado.
Esta completa API de búsqueda proporciona la base para mercados de NFT,
aplicaciones de portafolio y plataformas de análisis
que necesitan descubrir y filtrar activos digitales según varios criterios,
como colecciones, creadores, estado de compresión
y propiedad, con compatibilidad tanto para NFT tradicionales como
comprimidos en todo el ecosistema de Solana.
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: searchAssets
description: >
Busca y descubre activos digitales de Solana con opciones completas de
filtrado.
Esta potente API de descubrimiento permite que las aplicaciones
encuentren NFT, NFT comprimidos, tokens fungibles
y otros activos digitales mediante varios criterios, como propiedad,
creadores, colecciones,
estado de compresión y atributos de metadatos. Es ideal para mercados,
rastreadores
de portafolios y plataformas de análisis que necesitan capacidades
avanzadas de descubrimiento de activos
en todo el ecosistema de Solana.
Capacidades principales:
- Búsqueda con múltiples criterios en todos los estándares de NFT de
Solana (tradicionales, comprimidos y programables)
- Filtrado por colección para proyectos y comunidades de NFT
- Consultas por creador y propiedad para atribución y análisis de
portafolios
- Filtrado por estado de compresión para identificar activos rentables
- Búsqueda de atributos de metadatos para el descubrimiento basado en
rasgos
- Compatibilidad completa con paginación para conjuntos grandes de
resultados
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:
- searchAssets
description: El nombre del método JSON-RPC que se invocará.
default: searchAssets
params:
type: object
description: Parámetros del método `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
La dirección de la billetera de Solana cuyos activos
digitales se recuperarán para filtrar los resultados de
búsqueda.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
Filtra tipos específicos de tokens de Solana, incluidos
NFT comprimidos (cNFT), NFT normales,
NFT programables (pNFT) o tokens SPL fungibles, para el
descubrimiento específico de activos.
example: all
page:
type: integer
description: La página de resultados que se devolverá.
example: 1
authorityAddress:
type: string
description: >
Los criterios de dirección de autoridad para filtrar
activos digitales de Solana según la autoridad del
programa,
útiles para encontrar activos controlados por protocolos
o autoridades de actualización específicos.
example: string
limit:
type: integer
description: El número máximo de activos que se devolverá.
example: 100
sortBy:
type: object
description: Las opciones de ordenación de la respuesta.
properties:
sortBy:
type: string
description: >-
Los criterios según los cuales se ordenarán los
activos.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: La dirección de ordenación.
enum:
- asc
- desc
compressed:
type: boolean
description: >
Filtra NFT comprimidos de Solana (cNFT) que usan
tecnología de compresión de estado
para reducir los costos de almacenamiento y mejorar la
escalabilidad.
example: true
compressible:
type: boolean
description: >
Filtra activos de Solana que pueden comprimirse, pero
que aún no
se han comprimido en el formato de compresión de estado.
example: false
delegate:
type: integer
description: Criterios de delegado para la búsqueda de activos.
creatorAddress:
type: string
description: >
Criterios de dirección de billetera del creador para
encontrar NFT de Solana creados por artistas,
proyectos o creadores específicos con fines de
atribución y seguimiento de regalías.
example: string
creatorVerified:
type: boolean
description: Indica si un creador está verificado.
example: true
grouping:
type: array
items:
type: string
description: >
Matriz de agrupación de colecciones para filtrar NFT de
Solana según su pertenencia a una colección
(p. ej., ["collection", ""]) y encontrar
activos relacionados.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Dirección del árbol de Merkle para filtrar NFT
comprimidos (cNFT) según su árbol de colección.
Este parámetro es específico de Helius y no forma parte
de la especificación oficial de DAS.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Criterios de suministro para la búsqueda de activos.
example: 0
supplyMint:
type: string
description: >-
Criterios de acuñación del suministro para la búsqueda
de activos.
frozen:
type: boolean
description: Indica si un activo está congelado.
example: false
burnt:
type: boolean
description: Indica si un activo se ha quemado.
example: false
isAgent:
type: boolean
description: >-
Filtra los activos que tienen una identidad de agente
(plugin externo AgentIdentity de MPL Core).
agentToken:
type: string
description: >-
Filtra por la dirección de acuñación en base58 del token
de agente del programa Agent Registry.
assetSigner:
type: string
description: >-
Filtra por el PDA del firmante del activo en base58 (MPL
Core).
interface:
type: string
description: >
El tipo de interfaz del estándar de tokens de Solana
para filtrar implementaciones específicas de NFT,
incluidos NFT programables, NFT heredados, tokens
fungibles y activos, colecciones o grupos de MPL Core
(MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Criterios del tipo de destinatario de las regalías.
example: creators
royaltyTarget:
type: integer
description: Criterios del destinatario de las regalías.
example: 0
royaltyAmount:
type: integer
description: Criterios del importe de las regalías.
example: 0
ownerType:
type: integer
description: Criterios del modelo de propiedad.
example: 1
before:
type: string
description: Un cursor para paginar hacia atrás.
example: string
after:
type: string
description: Un cursor para paginar hacia delante.
example: string
options:
type: object
description: >-
Opciones avanzadas de visualización para personalizar la
respuesta de búsqueda de activos de Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Muestra las colecciones no verificadas en lugar de
omitirlas.
showCollectionMetadata:
type: boolean
default: false
description: Muestra los metadatos de la colección.
showGrandTotal:
type: boolean
default: false
description: >-
Muestra el número total de activos coincidentes
(solicitud más lenta).
showNativeBalance:
type: boolean
default: false
description: Muestra el saldo nativo (SOL) del propietario.
showZeroBalance:
type: boolean
default: false
description: Muestra los activos con saldo cero.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Respuesta correcta
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Se garantiza que se han indexado todos los datos hasta
este slot inclusive.
example: 365750752
total:
type: integer
description: >-
El número total de NFT y activos digitales de Solana
que coinciden con los criterios de búsqueda.
example: 80
limit:
type: integer
description: El número máximo de activos solicitados.
example: 50
page:
type: integer
description: La página actual de resultados.
example: 1
items:
type: array
description: Una matriz de activos.
items:
type: object
properties:
interface:
type: string
description: >-
El tipo de implementación del estándar de tokens
de Solana del activo digital.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Indica si este activo tiene una identidad de
agente (plugin externo AgentIdentity de MPL
Core). Se omite cuando es falso.
agent_token:
type: string
description: >-
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 codificado en base58
para MPL Core. Se omite cuando no corresponde.
plugins:
type: object
description: >-
Plugins de MPL Core, incluida la pertenencia
opcional a `groups` de MIP-11.
additionalProperties: true
id:
type: string
description: >-
El identificador único de la dirección de
acuñación del activo digital de Solana.
ownership:
type: object
description: >-
Detalles de propiedad del activo digital de
Solana, incluidos el propietario y el modelo
actuales.
content:
type: object
description: >-
El contenido y los metadatos del activo digital
de Solana, incluidos URI, atributos y contenido
multimedia.
example:
total: 80
limit: 50
page: 1
items:
- interface: V1_NFT
id: SomeNftMintKey12345
ownership:
owner: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
ownership_model: single
content:
json_uri: https://example.com/metadata/12345.json
nativeBalance:
type: object
description: >-
El saldo nativo en SOL de la cuenta de billetera de Solana
en lamports y su valor en USD.
properties:
lamports:
type: integer
description: El número de lamports de la cuenta.
price_per_sol:
type: number
description: El precio actual de SOL.
total_price:
type: number
description: El valor total en SOL de esta cuenta.
'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 que coincidan con los
criterios de búsqueda.
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: Se produjo 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).
````