> ## 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
> Solana NFT, 압축 NFT 또는 토큰에 대한 메타데이터, 소유권, 가격 데이터 및 온체인 속성을 포함한 자세한 정보를 검색합니다.
## 가격 데이터 캐싱
getAsset에서 반환된 가격 데이터는 캐시되어 있으며 최신 상태가 아닐 수 있습니다. 가격 정보는 600초 캐시가 되어 있어 데이터는 최대 600초 전일 수 있습니다.
가격 데이터는 24시간 거래량 기준 상위 10,000개의 토큰에 대해 제공되며, 응답의 `token_info.price_info` 섹션에서 찾을 수 있습니다. 실시간 가격이 필요한 애플리케이션의 경우 추가 검증을 구현하는 것을 고려하세요.
## MPL 코어 에이전트 및 MIP-11 그룹
응답에 포함될 경우 `is_agent`, `agent_token`, `asset_signer`, `interface` 값과 같은 `MplCoreGroup`, MIP-11 멤버십에 대한 `plugins.groups` 객체가 포함될 수 있습니다. 동일한 선택적 필드는 `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority`, `searchAssets`에 의해 반환됩니다. [자산 검색 가이드](/docs/ko/das/search)를 통해 `searchAssets` 필터를 참조하세요.
## 요청 매개변수
검색할 Solana NFT 또는 디지털 자산의 고유 식별자입니다. 이는 일반적으로 NFT 또는 토큰의 민트 주소입니다.
자산 데이터 응답의 표시 및 형식 옵션입니다.
검증되지 않은 컬렉션에 대한 그룹화 정보를 표시하며 이를 건너뛰지 않습니다.
컬렉션에 대한 메타데이터를 표시합니다.
소유자가 보유한 대체 가능한 토큰을 표시합니다.
## OpenAPI
````yaml ko/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: Solana Digital Asset Standard (DAS) API
version: 1.0.0
description: >
Solana Digital Asset Standard (DAS) API는 Solana 블록체인 NFT 및 디지털 자산에 대한 포괄적이고
표준화된 접근을 제공합니다.
이 강력한 API 세트는 개발자가 Solana의 모든 디지털 자산에 대한 세부 정보를 검색할 수 있도록 하며,
토큰 표준에 관계없이 일관된 데이터 형식을 유지합니다.
참고로, 모든 성공적인 DAS 응답에는 DAS 색인이 보장되는
가장 최근 슬롯을 나타내는 `last_indexed_slot` 필드가 포함되어 있습니다. 이 슬롯까지의 모든 온체인 데이터가
색인화되었습니다. 이 슬롯 이후의 데이터도 이미 색인화되었을 수 있지만 보장되지는 않습니다.
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: getAsset
description: >
Solana NFT 또는 디지털 자산의 고유 식별자로 포괄적인 데이터를 검색합니다.
이 엔드포인트는 온체인 및 오프체인 메타데이터, 소유권 정보, 로열티 정보,
컬렉션 데이터, 압축 상태를 제공합니다. getAsset 메소드는 압축된 NFT(cNFTs), 프로그래머블 NFTs
(pNFTs), 전통적 SPL 토큰을 포함한 모든 토큰 표준을 지원합니다.
이 엔드포인트를 사용하여:
- NFT 마켓플레이스 리스팅에 대한 완전한 메타데이터를 가져옵니다.
- 지갑 통합을 위한 자산 소유권 정보를 검색합니다.
- 로열티 강화를 위한 로열티 및 창작자 데이터를 액세스합니다.
- 비용 효율적인 압축 NFT를 식별하기 위해 압축 상태를 확인합니다.
- NFT 컬렉션 분석을 위한 컬렉션 그룹 보기를 확인합니다.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전입니다.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: 요청의 고유 식별자입니다.
example: '1'
default: '1'
method:
type: string
description: 호출할 RPC 메소드의 이름입니다.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
검색할 Solana NFT 또는 디지털 자산의 고유 식별자입니다. 이는 일반적으로 NFT 또는 토큰의
민트 주소입니다.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: 자산 데이터 응답을 위한 표시 및 형식 선택.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: 검증되지 않은 컬렉션의 그룹 정보를 건너뛰지 않고 표시합니다.
showCollectionMetadata:
type: boolean
default: false
description: 컬렉션의 메타데이터를 표시합니다.
showFungible:
type: boolean
description: 소유자가 보유한 가상 토큰을 표시합니다.
default: false
responses:
'200':
description: 성공적인 응답
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC 프로토콜의 버전입니다.
id:
type: string
description: 요청을 식별하는 데 사용되는 ID입니다.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: 이 슬롯까지의 모든 데이터가 색인화되었음을 보장합니다.
interface:
type: string
description: Solana 디지털 자산의 인터페이스 유형을 나타내며, 이는 해당 토큰 표준 및 구현을 뜻합니다.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
이 자산에 에이전트 ID가 있는지 여부입니다. External plugin adapter를
사용하는 MPL Core 자산에만 true입니다. 기본값은 false이며 false 경우 응답에
누락됩니다.
agent_token:
type: string
description: >-
Agent Registry 프로그램의 Base58로 인코딩된 민트 주소입니다. 해당 자산에
레지스트리 항목이 없는 경우 누락됩니다.
asset_signer:
type: string
description: >-
자산을 대신하여 서명하는 데 사용되는 Base58로 인코딩된 PDA입니다. MPL Core 자산의
경우 자산 ID에서 결정적으로 파생됩니다. 해당되지 않는 경우 누락됩니다.
id:
type: string
description: 자산의 고유 식별자입니다.
content:
type: object
description: Solana 디지털 자산의 콘텐츠 정보로, 메타데이터, 파일, 링크를 포함합니다.
properties:
$schema:
type: string
description: 자산 메타데이터에 대한 스키마 URL입니다.
json_uri:
type: string
description: >-
일반적으로 Arweave 또는 기타 분산 저장소에 호스팅되는 Solana NFT의 JSON
메타데이터를 가리키는 URI입니다.
files:
type: array
description: 자산과 관련된 파일 배열입니다.
items:
type: object
metadata:
type: object
description: >-
Solana 디지털 자산에 대한 전체 메타데이터 정보로, 이름, 기호, 속성, 토큰 표준을
포함합니다.
properties:
name:
type: string
description: 자산의 이름입니다.
symbol:
type: string
description: 자산의 기호입니다.
attributes:
type: array
description: 특성 속성 배열입니다.
items:
type: object
properties:
value:
type: string
description: 특성의 값입니다.
trait_type:
type: string
description: 특성의 유형입니다.
description:
type: string
description: 자산에 대한 설명입니다.
token_standard:
type: string
description: 사용된 토큰 표준입니다.
links:
type: object
description: 자산과 관련된 외부 링크입니다.
authorities:
type: array
description: 자산과 관련된 권한 목록입니다.
items:
type: object
properties:
address:
type: string
description: 권한의 주소입니다.
scopes:
type: array
description: 권한의 범위입니다.
items:
type: string
compression:
type: object
description: >-
Solana 디지털 자산의 압축 세부 사항으로, 상태 증명 검증이 있는 압축 NFT인지 여부를
나타냅니다.
properties:
eligible:
type: boolean
description: 자산이 압축에 적합한지 여부입니다.
compressed:
type: boolean
description: >-
자산이 Solana의 상태 압축 기술을 사용하여 현재 압축되었는지 여부로, 저장 비용을
줄입니다.
data_hash:
type: string
description: 자산 데이터의 해시입니다.
creator_hash:
type: string
description: 창작자 데이터의 해시입니다.
asset_hash:
type: string
description: 전체 자산의 해시입니다.
tree:
type: string
description: 머클 트리 주소입니다.
seq:
type: integer
description: 시퀀스 번호입니다.
leaf_id:
type: integer
description: 머클 트리의 리프 식별자입니다.
grouping:
type: array
description: 자산에 대한 그룹 정보입니다.
items:
type: object
properties:
group_key:
type: string
description: 그룹을 식별하는 키입니다.
group_value:
type: string
description: 그룹과 연결된 값입니다.
royalty:
type: object
description: >-
Solana 디지털 자산에 대한 로열티 정보로, 마켓플레이스 수수료 계산 및 창작자 지급에
사용됩니다.
properties:
royalty_model:
type: string
description: 로열티에 사용되는 모델입니다.
target:
type:
- string
- 'null'
description: 로열티의 대상 주소입니다.
percent:
type: number
description: 로열티 비율입니다.
basis_points:
type: integer
description: 로열티 기준 포인트입니다.
primary_sale_happened:
type: boolean
description: 기본 판매가 발생했는지 여부입니다.
locked:
type: boolean
description: 로열티가 잠겨 있는지 여부입니다.
creators:
type: array
description: 자산의 창작자 목록입니다.
items:
type: object
properties:
address:
type: string
description: 창작자의 주소입니다.
share:
type: integer
description: 창작자의 공유 비율입니다.
verified:
type: boolean
description: 창작자가 검증되었는지 여부입니다.
ownership:
type: object
description: >-
Solana 디지털 자산의 소유권 세부 사항으로, 현재 소유자, 위임 상태 및 동결 정보를
포함합니다.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: 자산이 동결되었는지 여부입니다.
delegated:
type: boolean
description: 자산이 위임되었는지 여부입니다.
delegate:
type:
- string
- 'null'
description: 위임된 경우 대리자의 주소입니다.
ownership_model:
type: string
description: 소유권 모델입니다.
owner:
type: string
description: 소유자의 주소입니다.
supply:
type:
- object
- 'null'
description: 자산의 공급 정보입니다.
properties:
print_max_supply:
type: integer
description: 인쇄할 수 있는 최대 공급량입니다.
print_current_supply:
type: integer
description: 현재 인쇄된 공급량입니다.
edition_nonce:
type: integer
description: 에디션 논스입니다.
mutable:
type: boolean
description: 자산이 수정 가능한지 여부입니다.
burnt:
type: boolean
description: 자산이 소각되었는지 여부입니다.
token_info:
type: object
description: 토큰 전용 정보입니다.
properties:
supply:
type: integer
description: 총 토큰 공급량입니다.
decimals:
type: integer
description: 소수 자릿수입니다.
token_program:
type: string
description: 토큰 프로그램 ID입니다.
mint_authority:
type: string
description: 민트 권한 주소입니다.
freeze_authority:
type: string
description: 동결 권한 주소입니다.
plugins:
type: object
description: >-
MPL Core 플러그인 페이로드입니다. 자산 및 컬렉션에서 `그룹` 플러그인 (MIP-11)을
포함할 수 있습니다.
additionalProperties: true
properties:
groups:
type: object
description: MIP-11 그룹 플러그인으로, 멤버십 메타데이터가 포함되어 있습니다.
properties:
authority:
type: object
description: '플러그인 권한 (예: UpdateAuthority).'
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: 이 자산 또는 컬렉션에 대한 그룹 멤버십입니다.
items:
type: object
properties:
group_address:
type: string
description: MPL Core 그룹 계정의 Base58 주소입니다.
member_number:
type: integer
description: 그룹 내의 멤버 번호입니다.
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: 잘못된 요청. 서버가 구문이 잘못된 요청을 이해하지 못했습니다.
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: Too Many Requests. 사용자가 일정 시간 내에 너무 많은 요청을 보냈습니다.
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: >-
당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
받을 수 있습니다.
````