Funny Fun

Token holders

GET

/token-holders

Token holders

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.nusabyte.com/api/v1/token-holders?tokenId&userAddress=GtYQTjgJ64ny3idgisfPctvvesYWfnzBtDqRPT5mUE3s&limit=3&page=1'

Response Example

[
    {
        "tokenId": "1",
        "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "tokenName": "Ethereum",
        "tokenSymbol": "ETH",
        "tokenImageUrl": "https://example.com/token/eth.png",
        "userAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "userName": "Diana",
        "userImageUrl": "https://example.com/user/diana.png",
        "rawTokenAmount": "5000000000000000000",
        "tokenAmount": "5.0",
        "percentage": "1.25"
    }
]

Request

Query Params

tokenId

string

optional

userAddress

string

optional

Example:

GtYQTjgJ64ny3idgisfPctvvesYWfnzBtDqRPT5mUE3s

limit

string

optional

Example:

page

string

optional

Example:

Responses

🟢200Success

application/json

Body

array of:

tokenId

string

required

ID of the token

tokenAddress

string

required

Smart contract address of the token

tokenName

string

required

Name of the token

tokenSymbol

string

required

Token symbol, e.g., 'ETH'

tokenImageUrl

string

required

URL of the token's image

userAddress

string

required

Wallet address of the user

userName

string

required

Display name of the user

userImageUrl

string

required

URL of the user's profile image

rawTokenAmount

string

required

Raw amount of tokens held (as a string)

tokenAmount

string

required

Formatted token amount (human-readable)

percentage

string

required

Percentage of total token supply held by the user (as a string, e.g., '2.5')

Modified at 2025-04-28 07:58:46

Token charts

Token comments