Logo
Covalent API Documentation

getTokenHoldersV2ForTokenAddress

GET https://api.covalenthq.com/v1/:chainName/tokens/:tokenAddress/token_holders_v2/?block-height=&date=&page-size=&page-number=

Returns: TokenHoldersResponse

{
  "updated_at" : "{{DATETIME}}",
  "chain_id" : "{{INTEGER}}",
  "chain_name" : "{{STRING}}",
  "items" : [ {
    "contract_decimals" : "{{INTEGER}}",
    "contract_name" : "{{STRING}}",
    "contract_ticker_symbol" : "{{STRING}}",
    "contract_address" : "{{STRING}}",
    "supports_erc" : [ "{{STRING}}" ],
    "logo_url" : "{{STRING}}",
    "address" : "{{STRING}}",
    "balance" : "{{INTEGER}}",
    "total_supply" : "{{INTEGER}}",
    "block_height" : "{{INTEGER}}"
  } ],
  "pagination" : {
    "has_more" : "{{BOOLEAN}}",
    "page_number" : "{{INTEGER}}",
    "page_size" : "{{INTEGER}}",
    "total_count" : "{{INTEGER}}"
  }
}

 

Body PARAM

Key Datatype Required Description 
block-height
null
date
null
page-size
null
page-number
null



HEADERS

Key Datatype Required Description 
Content-Type
string




RESPONSES

Curl
curl -X GET 'https://api.covalenthq.com/v1/:chainName/tokens/:tokenAddress/token_holders_v2/?block-height=&date=&page-size=&page-number=?block-height=&date=&page-size=&page-number=' -H 'Content-Type: application/json'

ENDPOINTS