> ## 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.
# getAsset
> Récupérer des informations détaillées pour un seul NFT Solana, NFT compressé ou jeton, y compris les métadonnées, la propriété, les données de prix et les attributs on-chain
## Mise en cache des données de prix
Les données de prix retournées par getAsset sont mises en cache et peuvent ne pas être fraîches. Les informations de prix ont un cache de 600 secondes, ce qui signifie que les données peuvent avoir jusqu'à 600 secondes.
Les données de prix sont disponibles pour les 10k principaux jetons par volume sur 24h et peuvent être trouvées dans la section `token_info.price_info` de la réponse. Pour les applications nécessitant des prix en temps réel, envisagez de mettre en œuvre une validation supplémentaire.
## Agents MPL Core et groupes MIP-11
Lorsque présent, la réponse peut inclure `is_agent`, `agent_token`, `asset_signer`, `interface` des valeurs telles que `MplCoreGroup`, et un objet `plugins.groups` pour l'adhésion à MIP-11. Les mêmes champs optionnels sont retournés par `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority`, et `searchAssets`. Voir le [guide de recherche d'asset](/docs/fr/das/search) pour les filtres `searchAssets`.
## Paramètres de requête
L'identifiant unique du NFT Solana ou de l'actif numérique à récupérer. Il s'agit généralement de l'adresse de frappe du NFT ou du jeton.
Options d'affichage et de formatage pour la réponse des données de l'actif.
Affiche les informations de regroupement pour les collections non vérifiées au lieu de les ignorer.
Affiche les métadonnées de la collection.
Affiche les jetons fongibles détenus par le propriétaire.
## OpenAPI
````yaml fr/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: API Solana Digital Asset Standard (DAS)
version: 1.0.0
description: >
L'API Solana Digital Asset Standard (DAS) offre un accès standardisé et
complet aux NFT et actifs numériques de la blockchain Solana.
Cet ensemble puissant d'API permet aux développeurs de récupérer des
informations détaillées sur tout actif numérique de Solana,
comprenant à la fois les NFT traditionnels et compressés, avec un formatage
de données cohérent quel que soit le standard du jeton.
Notez que chaque réponse DAS réussie inclut un champ `last_indexed_slot`
indiquant le slot le plus récent pour lequel l'index DAS est garanti d'être
complet. Toutes les données on-chain **jusqu'à et y compris** ce slot ont
été indexées. Les données au-delà de ce slot peuvent également avoir déjà
été indexées,
bien que cela ne soit pas garanti.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
Récupérer des données complètes pour tout NFT ou actif numérique Solana
grâce à son identifiant unique.
Cet endpoint fournit une métadonnée on-chain et off-chain complète, des
détails de propriété, des informations sur les redevances,
des données de collection et l'état de compression pour tout actif
numérique Solana. La méthode getAsset prend en charge tous les standards
de jetons
incluant les NFT compressés (cNFT), les NFT programmables (pNFT) et les
jetons SPL traditionnels.
Utilisez cet endpoint pour :
- Récupérer des métadonnées complètes pour les listes de marché NFT
- Obtenir des informations de propriété d'actifs pour les intégrations
de portefeuille
- Accéder aux données de redevance et du créateur pour l'application des
redevances
- Vérifier l'état de compression pour identifier les NFT compressés à
coût réduit
- Voir le regroupement de collection pour l'analyse de collection NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: The JSON-RPC protocol version.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: A unique identifier for the request.
example: '1'
default: '1'
method:
type: string
description: The name of the RPC method to invoke.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
The unique identifier of the Solana NFT or digital asset
to retrieve. This is typically the mint address of the
NFT or token.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Display and formatting options for the asset data
response.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Displays grouping information for unverified
collections instead of skipping them.
showCollectionMetadata:
type: boolean
default: false
description: Displays metadata for the collection.
showFungible:
type: boolean
description: Displays fungible tokens held by the owner.
default: false
responses:
'200':
description: Réponse réussie
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The version of the JSON-RPC protocol.
id:
type: string
description: The ID used to identify the request.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
All data up to and including this slot is guaranteed
to have been indexed.
interface:
type: string
description: >-
The interface type of the Solana digital asset,
indicating its token standard and implementation.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Whether this asset has an Agent Identity. Only true
for MPL Core assets that use the AgentIdentity
external plugin adapter. Defaults to false and is
omitted from the response when false.
agent_token:
type: string
description: >-
Base58-encoded mint address of the agent token from
the Agent Registry program. Omitted when the asset has
no corresponding registry entry.
asset_signer:
type: string
description: >-
Base58-encoded PDA used for signing on behalf of the
asset; deterministically derived from the asset ID for
MPL Core assets. Omitted when not applicable.
id:
type: string
description: The unique identifier of the asset.
content:
type: object
description: >-
Content information of the Solana digital asset,
including metadata, files, and links.
properties:
$schema:
type: string
description: The schema URL for the asset metadata.
json_uri:
type: string
description: >-
URI pointing to the JSON metadata for the Solana
NFT, typically hosted on Arweave or other
decentralized storage.
files:
type: array
description: Array of files associated with the asset.
items:
type: object
metadata:
type: object
description: >-
Complete metadata information about the Solana
digital asset, including name, symbol, attributes,
and token standard.
properties:
name:
type: string
description: The name of the asset.
symbol:
type: string
description: The symbol of the asset.
attributes:
type: array
description: Array of trait attributes.
items:
type: object
properties:
value:
type: string
description: The value of the trait.
trait_type:
type: string
description: The type of the trait.
description:
type: string
description: Description of the asset.
token_standard:
type: string
description: Token standard used.
links:
type: object
description: External links related to the asset.
authorities:
type: array
description: List of authorities associated with the asset.
items:
type: object
properties:
address:
type: string
description: The authority's address.
scopes:
type: array
description: The scopes of authority.
items:
type: string
compression:
type: object
description: >-
Compression details of the Solana digital asset,
indicating if it's a compressed NFT with state proof
validation.
properties:
eligible:
type: boolean
description: Whether the asset is eligible for compression.
compressed:
type: boolean
description: >-
Whether the asset is currently compressed using
Solana's state compression technology, which
reduces storage costs.
data_hash:
type: string
description: Hash of the asset data.
creator_hash:
type: string
description: Hash of the creator data.
asset_hash:
type: string
description: Hash of the entire asset.
tree:
type: string
description: Merkle tree address.
seq:
type: integer
description: Sequence number.
leaf_id:
type: integer
description: Leaf identifier in the merkle tree.
grouping:
type: array
description: Grouping information for the asset.
items:
type: object
properties:
group_key:
type: string
description: The key identifying the group.
group_value:
type: string
description: The value associated with the group.
royalty:
type: object
description: >-
Royalty information for the Solana digital asset, used
for marketplace fee calculations and creator payments.
properties:
royalty_model:
type: string
description: The model used for royalties.
target:
type:
- string
- 'null'
description: The target address for royalties.
percent:
type: number
description: Royalty percentage.
basis_points:
type: integer
description: Royalty basis points.
primary_sale_happened:
type: boolean
description: Whether the primary sale has occurred.
locked:
type: boolean
description: Whether the royalty is locked.
creators:
type: array
description: List of creators of the asset.
items:
type: object
properties:
address:
type: string
description: The creator's address.
share:
type: integer
description: The creator's share percentage.
verified:
type: boolean
description: Whether the creator is verified.
ownership:
type: object
description: >-
Ownership details of the Solana digital asset,
including current owner, delegation status, and
freezing information.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Whether the asset is frozen.
delegated:
type: boolean
description: Whether the asset is delegated.
delegate:
type:
- string
- 'null'
description: The delegate's address if delegated.
ownership_model:
type: string
description: The model of ownership.
owner:
type: string
description: The owner's address.
supply:
type:
- object
- 'null'
description: Supply information for the asset.
properties:
print_max_supply:
type: integer
description: Maximum supply that can be printed.
print_current_supply:
type: integer
description: Current printed supply.
edition_nonce:
type: integer
description: Edition nonce.
mutable:
type: boolean
description: Whether the asset is mutable.
burnt:
type: boolean
description: Whether the asset has been burnt.
token_info:
type: object
description: Token-specific information.
properties:
supply:
type: integer
description: Total token supply.
decimals:
type: integer
description: Number of decimals.
token_program:
type: string
description: Token program ID.
mint_authority:
type: string
description: Mint authority address.
freeze_authority:
type: string
description: Freeze authority address.
plugins:
type: object
description: >-
MPL Core plugin payload. May include a `groups` plugin
(MIP-11) on assets and collections.
additionalProperties: true
properties:
groups:
type: object
description: MIP-11 Groups plugin with membership metadata.
properties:
authority:
type: object
description: >-
Plugin authority (for example,
UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Group memberships for this asset or
collection.
items:
type: object
properties:
group_address:
type: string
description: >-
Base58 address of the MPL Core group
account.
member_number:
type: integer
description: Member number within the group.
examples:
success:
value:
jsonrpc: '2.0'
id: test
result:
last_indexed_slot: 365749093
interface: ProgrammableNFT
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
content:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
mime: image/png
- uri: >-
https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
mime: image/png
metadata:
attributes:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
- value: Royal
trait_type: Expression
- value: Mad Crown
trait_type: Hat
- value: Madness
trait_type: Eyes
- value: Mad Armor
trait_type: Clothing
- value: Royal Rug
trait_type: Background
description: Fock it.
name: 'Mad Lads #8420'
symbol: MAD
token_standard: ProgrammableNonFungible
links:
image: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
external_url: https://madlads.com
authorities:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
mutable: true
burnt: false
token_info:
supply: 1
decimals: 0
token_program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
mint_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
freeze_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
'400':
description: >-
Requête incorrecte. Le serveur n'a pas pu comprendre la requête en
raison d'une syntaxe invalide.
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: >-
Non autorisé. Le client doit s'authentifier pour obtenir la réponse
demandée.
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: Interdit. Le client n'a pas les droits d'accès au contenu.
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: Non trouvé. Le serveur ne peut pas trouver la ressource demandée.
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: The requested asset was not found.
id:
type: string
example: '1'
'429':
description: >-
Trop de requêtes. L'utilisateur a envoyé trop de requêtes dans un
certain laps de temps.
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: >-
Erreur interne du serveur. Le serveur a rencontré une situation
qu'il ne sait pas gérer.
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: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement dans le
[dashboard](https://dashboard.helius.dev/api-keys).
````