Get Native Holders

post https://web3.nodit.io/v1/{protocol}/{network}/native/getNativeHolders

네이티브 토큰 컨트랙트의 홀더 리스트를 조회합니다. 홀더 리스트에는 홀더의 주소와 홀더가 보유한 토큰의 수량이 포함됩니다.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to tron

조회 대상 체인의 프로토콜을 지정하기 위한 파라미터입니다.

network

string

required

Defaults to mainnet

조회 대상 체인의 네트워크를 지정하기 위한 파라미터입니다. 프로토콜에 따라 지원되는 네트워크가 다를 수 있습니다.

Body Params

page

integer

page 파라미터는 조회하려는 데이터 페이지를 지정하는 데 사용됩니다. 이 파라미터는 100 이하의 값을 받으며, 100을 초과하는 페이지가 필요한 경우 cursor 페이지네이션 방식을 사용해야 합니다.

page 파라미터와 cursor 파라미터는 동시에 사용할 수 없습니다. page와 cursor에 모두 빈 값을 입력한 경우, cursor 페이지네이션을 사용하는 것으로 간주합니다.

rpp

integer

rpp는 results per page의 약자로, 한 페이지의 사이즈를 지정하는 파라미터입니다. 0보다 크고 1000 이하의 숫자를 지정할 수 있습니다.

cursor

string

cursor 파라미터는 페이지네이션을 위한 파라미터로, 이전 페이지와 다음 페이지 간의 데이터 이동을 지원합니다. 이전 페이지에서 얻은 cursor 값을 다음 요청에 제공하면 다음 페이지의 데이터를 로드할 수 있습니다.

withCount

boolean

Defaults to false

응답에 count 필드의 포함 여부를 지정하는 파라미터이며, count 필드는 요청한 데이터의 총 개수를 나타냅니다. 이 파라미터에 true를 입력한 경우, 응답에 count 필드가 포함되며 응답속도가 느려질 수 있습니다.

Responses

Response body

object

page

integer

page 파라미터에 지정된 페이지 번호를 나타내는 필드입니다. 이 필드는 page 파라미터에 0보다 큰 값을 입력한 경우에만 응답에 포함됩니다.

rpp

integer

rpp 파라미터에 지정된 페이지당 결과 수를 나타내는 필드입니다.

cursor

string

cursor 페이지네이션을 위한 필드로, 다음 페이지의 데이터를 로드하기 위해 다음 요청에 제공해야 하는 값입니다.

count

integer

요청한 데이터의 총 개수를 나타내는 필드입니다. 이 필드는 withCount 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.

items

array of objects

required

조회된 데이터의 목록을 나타내는 필드입니다.

items*

object

ownerAddress

string

required

계정 소유자의 트론(TRON) 주소입니다. 주소는 "T"로 시작하는 34자리 Base58 문자열 형식입니다.

balance

string

required

계정의 현재 잔액을 나타냅니다. 값은 10진수 문자열이며, 단위는 TRX의 최소단위인 SUN(1 TRX = 1,000,000 SUN)입니다.

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://web3.nodit.io/v1/tron/mainnet/native/getNativeHolders \
3
     --header 'X-API-KEY: nodit-demo' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --data '{"withCount":false}'

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

application/json

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests