Get Holders Of Fungible Token

GET 
/api/v1/tokens/:tokenAddress/holders

Free [5 Credits]

Retrieve a list of holders for a fungible token.

Request

Path Parameters

tokenAddress stringrequired

token address

Query Parameters

holderAddress string

holderAddress

page int32
Possible values: >= 1
Results page you want to retrieve (1..N)
Example: 1
size int32
Number of records per page, min: 1, Max: 2000
Example: 20

Responses

200

OK

*/*

Schema

Schema

results

object[]

required

Array [

holder

object

required

address Address (string)required

account_type Account Type (string)

Possible values: [EOA, SCA, UNKNOWN]

Example: EOA, SCA

contract_type Contract Type (string)

Possible values: [ERC20, KIP7, KIP17, KIP37, ERC721, ERC1155, CONSENSUS_NODE, CUSTOM, UNKNOWN, UNKNOWN_]

Example: Token, NFT17, NFT37

symbol Token/NFT Symbol (string)

name Token/NFT Name (string)

icon Token/NFT Icon (string)

verified Token/NFT Verified Status (boolean)

kns_domain Kaia Name Service Domain (string)

address_label Address Label (string)

amount Amount (number)required

percentage Percentage (number)

]

paging

object

required

total_count int64required

current_page int32required

last booleanrequired

total_page int32required

property

object

property name* object

Example (from schema)

{
  "results": [
    {
      "holder": {
        "address": "string",
        "account_type": "EOA, SCA",
        "contract_type": "Token, NFT17, NFT37",
        "symbol": "string",
        "name": "string",
        "icon": "string",
        "verified": true,
        "kns_domain": "string",
        "address_label": "string"
      },
      "amount": 0,
      "percentage": 0
    }
  ],
  "paging": {
    "total_count": 0,
    "current_page": 0,
    "last": true,
    "total_page": 0
  },
  "property": {}
}

Loading...