listAssetHolder

get

https://web3.luniverse.io/v1/{protocol}/{network}/assets/{contract}/accounts

NFT Contract에 대해 해당 자산을 소유한 모든 Holder목록을 조회할 수 있습니다. 또한 필터 파라미터를 활용하여 특정 토큰의 Holder 또는 특정 계정의 자산 소유 여부를 조회할 수 있습니다.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to ethereum

조회 대상 Chain 프로토콜을 지정하기 위한 파라미터입니다.
지원되는 프로토콜에 대한 정보는 Supported Chains페이지를 참고하거나, Protocol 조회 API를 활용하세요.

network

string

required

Defaults to mainnet

조회 대상 Chain 네트워크를 지정하기 위한 파라미터입니다.
mainnet 또는 테스트넷을 지정할 수 있습니다. 지원되는 네트워크에 대한 정보는 Supported Chains 페이지를 참고하거나 Network 조회 API를 활용하세요.

contract

string

required

조회하고자 하는 컨트랙트의 주소(address). 입력한 값이 CA가 아닌 경우 RESOURCE_NOT_FOUND 에러가 발생합니다.

Query Params

type

string

required

Defaults to nft

조회하고자 하는 자산의 타입을 지정할 수 있습니다. 'nft'를 사용합니다.

tokenIds

array of strings

Holder를 조회하고자 하는 특정 토큰의 ID 목록. 입력하지 않는 경우 모든 토큰을 대상으로 해당 컨트랙트 자산을 보유한 모든 Holder 정보를 얻을 수 있습니다. 입력하는 경우 해당 토큰의 Holder만 조회됩니다.

tokenIds

address

string

Holder여부를 조회하고자 하는 EOA주소. 해당 주소 계정이 이 컨트랙트 자산을 보유한 경우에만 응답에 해당 주소가 포함됩니다. 특정 계정의 자산 보유 여부를 확인하고자 할 때 사용할 수 있습니다.

page

string

Pagination 지원을 위한 필드로, 조회하고자 하는 페이지의 값.

rpp

string

Pagination 지원을 위한 파라미터(Result per Page).
한 페이지에 포함할 응답 객체의 개수를 지정할 수 있습니다. 1이상 100이하의 정수값을 입력할 수 있으며, 기본값은 10입니다.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400