> ## 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
> 소유권, 제작자, 컬렉션 및 사용자 지정 속성을 포함한 유연한 기준을 사용하여 Solana NFT, 압축 NFT 및 토큰을 검색하고 필터링합니다.
## 요청 매개변수
필터링 검색 결과를 위해 소유한 디지털 자산을 검색할 Solana 지갑 주소입니다.
압축 NFT(cNFT), 일반 NFT, 프로그래머블 NFT(pNFT) 또는 대상 자산 발견을 위한 Fungible SPL 토큰을 포함한 특정 Solana 토큰 유형 필터입니다.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
반환할 결과 페이지입니다.
특정 프로토콜 또는 업데이트 권한자가 제어하는 자산을 찾는 데 유용한 프로그램 권한을 기반으로 Solana 디지털 자산을 필터링하기 위한 권한 주소 기준입니다.
반환할 자산의 최대 수입니다.
응답에 대한 정렬 옵션입니다.
자산이 정렬될 기준입니다.
* `created`
* `recent_action`
* `updated`
* `none`
정렬 방향입니다.
* `asc`
* `desc`
저장 비용 절감과 확장성 향상을 위해 상태 압축 기술을 사용하는 압축 Solana NFT(cNFT) 필터입니다.
압축 가능한 Solana 자산을 필터링하지만 아직 상태 압축 형식으로 압축되지 않았습니다.
자산 검색을 위한 위임 기준입니다.
작성자 및 로열티 추적을 위한 특정 아티스트, 프로젝트 또는 작성자에 의해 생성된 Solana NFT를 찾기 위한 작성자 지갑 주소 기준입니다.
작성자가 검증되었는지 여부입니다.
관련 자산을 찾기 위해 컬렉션 멤버십에 따라 Solana NFT를 필터링하기 위한 컬렉션 그룹화 배열입니다.
컬렉션 트리에 따라 압축 NFT(cNFT)를 필터링하기 위한 머클 트리 주소입니다. 이 매개변수는 Helius 전용이며 공식 DAS 사양의 일부가 아닙니다.
자산 검색을 위한 공급 기준입니다.
자산 검색을 위한 공급 민트 기준입니다.
자산이 동결되었는지 여부입니다.
자산이 소각되었는지 여부입니다.
에이전트 신원을 가진 자산을 필터링합니다 (MPL Core AgentIdentity 외부 플러그인).
에이전트 레지스트리 프로그램에서 base58 에이전트 토큰 민트 주소로 필터링합니다.
base58 자산 서명자 PDA(MPL Core)로 필터링합니다.
프로그래머블 NFT, 레거시 NFT, Fungible 토큰, MPL Core 자산, 컬렉션 또는 그룹(MIP-11) 등의 특정 NFT 구현을 필터링하기 위한 Solana 토큰 표준 인터페이스 유형입니다.
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
로열티 대상 유형 기준입니다.
로열티 대상 기준입니다.
로열티 금액 기준입니다.
소유권 모델 기준입니다.
이전 페이지로 이동하기 위한 커서입니다.
다음 페이지로 이동하기 위한 커서입니다.
Solana 자산 검색 응답을 사용자 정의하기 위한 고급 디스플레이 옵션입니다.
검증되지 않은 컬렉션을 표시하는 대신 건너뜁니다.
컬렉션의 메타데이터를 표시합니다.
일치하는 자산의 총 수를 표시합니다 (느린 요청).
소유자의 네이티브(SOL) 잔액을 표시합니다.
잔액이 0인 자산을 표시합니다.
## OpenAPI
````yaml ko/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT 검색 및 발견 API
version: 1.0.0
description: >
솔라나 생태계 전반에 걸쳐 강력한 필터링 기능을 갖춘 NFT, 토큰 및 기타 디지털 자산을 검색하고 발견할 수 있는 고급 Solana
디지털 자산 표준(DAS) API입니다.
이 종합 검색 API는 NFT 마켓플레이스, 포트폴리오 애플리케이션 및 분석 플랫폼이 컬렉션, 크리에이터, 압축 상태,
소유권을 포함한 여러 기준에 따라 디지털 자산을 발견하고 필터링할 수 있는 기반을 제공합니다 - 솔라나 생태계 전반에 걸쳐 전통적 및
압축 NFT 둘 다 지원합니다.
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: searchAssets
description: >
포괄적인 필터링 옵션을 사용하여 Solana 디지털 자산을 검색하고 발견하십시오.
이 강력한 발견 API는 소유권, 크리에이터, 컬렉션,
압축 상태 및 메타데이터 속성을 포함한 여러 기준을 사용하여 애플리케이션이 NFT, 압축 NFT, 대체 가능한 토큰,
기타 디지털 자산을 찾을 수 있도록 합니다. Solana 생태계 전반에 걸쳐 고급 자산 발견 기능을 필요로 하는 마켓플레이스,
포트폴리오
추적기 및 분석 플랫폼에 적합합니다.
주요 기능:
- 모든 Solana NFT 표준(전통, 압축, 프로그래머블)에 대한 다중 기준 검색
- NFT 프로젝트 및 커뮤니티를 위한 컬렉션 기반 필터링
- 저작권 및 포트폴리오 분석을 위한 크리에이터 및 소유 기반 쿼리
- 비용 효율적인 자산 식별을 위한 압축 상태 필터링
- 특성 기반 발견을 위한 메타데이터 속성 검색
- 대량 결과 세트를 위한 완전한 페이지네이션 지원
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
description: 요청을 식별하기 위한 ID입니다.
default: '1'
method:
type: string
enum:
- searchAssets
description: 호출할 JSON-RPC 메서드의 이름입니다.
default: searchAssets
params:
type: object
description: '`searchAssets` 메서드의 매개 변수입니다.'
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: 검색 결과를 필터링하기 위해 소유한 디지털 자산을 검색할 Solana 지갑 주소입니다.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
압축 NFT(cNFT), 일반 NFT, 프로그래머블 NFT(pNFT), 대체 가능 SPL 토큰을
포함한 특정 솔라나 토큰 유형을 필터링하여 자산 발견을 목표로 합니다.
example: all
page:
type: integer
description: 반환할 결과의 페이지입니다.
example: 1
authorityAddress:
type: string
description: >
특정 프로토콜이나 업데이트 권한으로 제어되는 자산을 찾는 데 유용하게 프로그램 권한을 기준으로
Solana 디지털 자산을 필터링합니다.
example: string
limit:
type: integer
description: 반환할 자산의 최대 수입니다.
example: 100
sortBy:
type: object
description: 응답의 정렬 옵션입니다.
properties:
sortBy:
type: string
description: 자산이 정렬될 기준입니다.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: 정렬 방향입니다.
enum:
- asc
- desc
compressed:
type: boolean
description: >
저장 비용 절감과 확장성을 향상시키기 위해 상태 압축 기술을 사용하는 압축 Solana
NFT(cNFT)를 필터링합니다.
example: true
compressible:
type: boolean
description: |
압축이 가능하지만 아직 상태 압축 형식으로 압축되지 않은 Solana 자산을 필터링합니다.
example: false
delegate:
type: integer
description: 자산 검색을 위한 위임 기준입니다.
creatorAddress:
type: string
description: >
저작권 및 로열티 추적을 위한 특정 아티스트, 프로젝트 또는 크리에이터가 만든 Solana NFT를
찾기 위한 크리에이터 지갑 주소 기준입니다.
example: string
creatorVerified:
type: boolean
description: 크리에이터가 검증되었는지 여부입니다.
example: true
grouping:
type: array
items:
type: string
description: |
컬렉션 그룹 배열은 솔라나 NFT를 컬렉션 멤버십으로 필터링하여 관련 자산을 찾기 위한 것입니다.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: |
컬렉션 트리로 압축 NFT(cNFT)를 필터링하기 위한 머클 트리 주소입니다.
이 매개 변수는 Helius 전용이며 공식 DAS 명세의 일부가 아닙니다.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: 자산 검색을 위한 공급 기준입니다.
example: 0
supplyMint:
type: string
description: 자산 검색을 위한 공급 민트 기준입니다.
frozen:
type: boolean
description: 자산이 동결되었는지 여부입니다.
example: false
burnt:
type: boolean
description: 자산이 소각되었는지 여부입니다.
example: false
isAgent:
type: boolean
description: >-
에이전트 아이덴티티(MPL Core AgentIdentity 외부 플러그인)를 가진 자산을
필터링합니다.
agentToken:
type: string
description: 에이전트 레지스트리 프로그램의 base58 에이전트 토큰 민트 주소로 필터링합니다.
assetSigner:
type: string
description: base58 자산 서명자 PDA (MPL Core)로 필터링합니다.
interface:
type: string
description: >
프로그래머블 NFT, 레거시 NFT, 대체 가능 토큰, MPL Core 자산, 컬렉션,
그룹(MIP-11)을 포함하여 특정 NFT 구현을 필터링하기 위한 Solana 토큰 표준 인터페이스
유형입니다.
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: 로열티 대상 유형 기준입니다.
example: creators
royaltyTarget:
type: integer
description: 로열티 대상 기준입니다.
example: 0
royaltyAmount:
type: integer
description: 로열티 금액 기준입니다.
example: 0
ownerType:
type: integer
description: 소유권 모델 기준입니다.
example: 1
before:
type: string
description: 뒤로 페이지네이션할 수 있는 커서입니다.
example: string
after:
type: string
description: 앞으로 페이지네이션할 수 있는 커서입니다.
example: string
options:
type: object
description: Solana 자산 검색 응답을 사용자 정의하기 위한 고급 표시 옵션입니다.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: 검증되지 않은 컬렉션을 건너뛰는 대신 표시합니다.
showCollectionMetadata:
type: boolean
default: false
description: 컬렉션의 메타데이터를 표시합니다.
showGrandTotal:
type: boolean
default: false
description: 일치하는 전체 자산 숫자를 표시합니다(요청 속도 느림).
showNativeBalance:
type: boolean
default: false
description: 소유자의 기본(SOL) 잔액을 표시합니다.
showZeroBalance:
type: boolean
default: false
description: 잔액이 0인 자산을 표시합니다.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: 성공적인 응답
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: 이 슬롯까지 포함하여 모든 데이터를 인덱싱한 것이 보장됩니다.
example: 365750752
total:
type: integer
description: 검색 기준과 일치하는 Solana NFT 및 디지털 자산의 총 수입니다.
example: 80
limit:
type: integer
description: 요청된 자산의 최대 수입니다.
example: 50
page:
type: integer
description: 현재 페이지의 결과입니다.
example: 1
items:
type: array
description: 자산 배열입니다.
items:
type: object
properties:
interface:
type: string
description: 디지털 자산의 Solana 토큰 표준 구현 유형입니다.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
이 자산에 에이전트 아이덴티티가 있는지 여부(MPL Core AgentIdentity
외부 플러그인). 거짓일 경우 생략됩니다.
agent_token:
type: string
description: >-
에이전트 레지스트리 프로그램의 base58 인코딩된 에이전트 토큰 민트. 등록되지 않은
경우 생략됩니다.
asset_signer:
type: string
description: >-
MPL Core용 base58 인코딩된 자산 서명자 PDA. 해당되지 않는 경우
생략됩니다.
plugins:
type: object
description: 옵션을 포함한 MPL Core 플러그인, MIP-11 `groups` 멤버십 포함.
additionalProperties: true
id:
type: string
description: 솔라나 디지털 자산의 고유한 민트 주소 식별자입니다.
ownership:
type: object
description: 현재 소유자 및 모델을 포함한 솔라나 디지털 자산의 소유권 세부 정보입니다.
content:
type: object
description: >-
Solana 디지털 자산의 URI, 속성 및 미디어를 포함한 콘텐츠 및
메타데이터입니다.
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: Solana 지갑 계정의 기본 SOL 잔액을 lamports 및 USD 값으로 나타냅니다.
properties:
lamports:
type: integer
description: 계정 내 lamports의 수입니다.
price_per_sol:
type: number
description: SOL의 현재 가격입니다.
total_price:
type: number
description: 이 계정의 총 SOL 가치입니다.
'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)에서 무료로
받을 수 있습니다.
````