listAccountBalance

get

https://web3.luniverse.io/v1/{protocol}/{network}/accounts/{address}/balance

특정 주소의 계정이 소유하고 있는 자산 잔고 목록을 조회합니다. 자산 타입별 조회 및 특정 컨트랙트로 발행된 자산의 조회를 지원합니다.

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를 활용하세요.

address

string

required

Defaults to 0x

잔고를 조회하고자 하는 대상 계정의 주소를 지정하기 위한 파라미터입니다.

Query Params

type

string

조회하고자 하는 자산의 타입을 지정할 수 있습니다.
지정한 타입의 자산만 응답에 포함됩니다. ft, nft 또는 빈 값이 허용되며, ft로 지정한 경우 Fungible Token(ERC20등 토큰 자산), nft로 지정한 경우 Non-Fungible Token(ERC721등 NFT자산), 빈 값으로 요청한 경우 Native Token에 해당하는 해당 계정의 잔고가 응답됩니다.

contract

string

특정 컨트랙트에서 발행된 자산의 잔고만 조회하고자 하는 경우 해당 컨트랙트의 주소를 지정할 수 있습니다.
Native Asset의 경우 컨트랙트 주소가 없기 때문에, type 파라미터가 존재하는 경우에만 정상 처리됩니다.

page

int32

Defaults to 1

Pagination 지원을 위한 파라미터.
조회하고자 하는 Page 값을 지정할 수 있으며, 0보다 큰 정수만 정상적으로 처리됩니다. 기본값은 1입니다.

rpp

int32

Defaults to 20

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

Responses

Language

Credentials

Header

Response

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

application/json

200200

400400