Retrieve Coin Holders

Returns holders of a coin by a given object type.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Supported on Sui Mainnet.

🚧

The Coins Holder API on Sui is currently exclusively available to Pro Members. Non-Pro members can also enjoy a trial period with an allocation of 30 free calls. If you're interested, please register directly through here. Please note that the API Key can also be used for your RPC endpoint.

Parameter

  • coinType, string - the coin type for the coin to get the holders.
  • cursor, string - next page cursor.
  • limit, integer - the maximum number of results to return per page. Defaults to 20, maximum is 50.

Response

Object - a returned object with coin holders info, next page index and total holders of a coin. Contains:

  • data, array - an array of coin holder objects, or an empty array if there are no holders.
    • address, string - the address of a holder.
    • quantity, string - the number of coins a holder has.
    • percentage, float - the relative share of coins held by an individual holder.
  • nextPageCursor, string - cursor used for paginating to the next page of results.
  • total, integer - the number of holders of a coin.
Query Params
string
required
Defaults to 0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI

string - the coin type for the coin to get the holders.

string

next page cursor.

int32
Defaults to 20

the maximum number of results to return per page. Defaults to 20, maximum is 50.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json