> ## 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.
# getAssetBatch
> 최대 1,000개의 Solana NFT, 압축 NFT, 또는 토큰에 대한 세부 정보를 단일 효율적 배치 요청으로 검색
## 요청 매개변수
응답의 표시 옵션입니다.
검증되지 않은 컬렉션의 그룹 정보를 무시하지 않고 표시합니다.
컬렉션의 메타데이터를 표시합니다.
소유자가 보유한 대체 가능한 토큰을 표시합니다.
## OpenAPI
````yaml ko/openapi/das-api/getAssetBatch.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
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: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetBatch
description: ID를 기반으로 자산 배치를 반환합니다.
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
example: '1'
description: 요청을 식별하기 위한 ID입니다.
default: '1'
method:
type: string
enum:
- getAssetBatch
description: 호출할 DAS 메서드의 이름입니다.
default: getAssetBatch
params:
type: object
default:
ids:
- F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
ids:
type: array
items:
type: string
description: 검색할 자산의 ID입니다.
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
required:
- ids
example:
ids:
- F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
responses:
'200':
description: 성공적인 응답
content:
application/json:
schema:
type: array
description: 자산의 배열.
items:
type: object
properties:
interface:
type: string
description: 자산의 인터페이스입니다.
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: MPL Core의 Base58로 인코딩된 자산 서명 PDA. 해당 사항이 없을 경우 생략됩니다.
id:
type: string
description: 자산의 ID입니다.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
plugins:
type: object
description: MPL Core 플러그인, 선택적 MIP-11 `groups` 멤버십 포함.
additionalProperties: true
content:
type: object
description: 자산의 콘텐츠입니다.
properties:
last_indexed_slot:
type: integer
description: 이 슬롯을 포함하여 모든 데이터가 인덱싱된 것이 보장됩니다.
example: 365750752
$schema:
type: string
example: https://schema.metaplex.com/nft1.0.json
json_uri:
type: string
example: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
type: array
items:
type: object
example:
- 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
metadata:
type: object
properties:
attributes:
type: array
items:
type: object
example:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
description:
type: string
example: Fock it.
name:
type: string
example: 'Mad Lads #8420'
symbol:
type: string
example: MAD
authorities:
type: array
items:
type: object
example:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
type: object
example:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
type: array
items:
type: object
example:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
type: object
example:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
type: array
items:
type: object
example:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
type: object
example:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
type: object
example:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
token_info:
type: object
description: 특정 토큰에 대한 세부 정보입니다.
properties:
symbol:
type: string
description: 토큰의 기호입니다.
supply:
type: integer
description: 토큰의 총 발행량입니다.
decimals:
type: integer
description: 토큰이 사용하는 소수점 자릿수입니다.
token_program:
type: string
description: 토큰 프로그램 ID입니다.
price_info:
type: object
description: 토큰의 가격에 대한 정보입니다.
properties:
price_per_token:
type: number
description: 개별 토큰당 가격입니다.
currency:
type: string
description: 토큰 가격이 표시되는 통화입니다.
mint_authority:
type: string
description: 토큰의 민트 권한 주소입니다.
freeze_authority:
type: string
description: 토큰의 동결 권한 주소입니다.
'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: >-
당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
얻을 수 있습니다.
````