GET
/
tokens
/
{hash}
/
holders
/
latest
Current Holders - By Token Address
curl --request GET \
  --url https://api.amberdata.com/blockchains/tokens/{hash}/holders/latest \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "records": [
      {
        "tokenAddress": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
        "holderAddress": "0xb1690c08e213a35ed9bab7b318de14420fb57d8c",
        "timestamp": 1575920861000,
        "holderFirstTimestamp": "2017-11-23T18:44:21.000Z",
        "numTokens": "209736",
        "decimals": "0"
      }
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-amberdata-blockchain-id
enum<string>
default:ethereum-mainnet

The id of the blockchain

Available options:
ethereum-mainnet,
polygon-mainnet

Path Parameters

​
hash
string
default:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
required

The address to retrieve token holders for

Query Parameters

​
numTokens
integer

Filter by token holders who own the specified amount of tokens.

​
numTokensGt
integer

Filter by token holders who own more than the specified amount of tokens

​
numTokensGte
integer

Filter by token holders who own more than or equal to the specified amount of tokens

​
numTokensLt
integer

Fitler by token holders who own less than the specified amount of tokens

​
numTokensLte
integer

Filter by token holders who own less than or equal to the specified amount of tokens

​
timestampGt
string<date-time>

Filter by token holders who started holding the token after the specified date

​
timestampGte
string<date-time>

Filter by token holders who started holding the token after or equal to the specified date

​
timestampLt
string<date-time>

Filter by token holders who started holding the token before the specified date

​
timestampLte
string<date-time>

Filter by token holders who started holding the token before or equal to the specified date

​
tokenAddress
string

Filter by token holders for this token (mandatory)

​
includePrice
boolean

Indicates whether or not to include price data with the results. Options: true, false. <a href="https://docs.amberdata.io/reference#section-include-price">More Details.</a>

​
currency
string

The currency of the price information (usd or btc.) - only used in conjunction with includePrice. <a href="https://docs.amberdata.io/reference#section-currency">More Details.</a>

​
page
integer
default:0

The page number to return.

​
size
integer
default:50

Number of records per page

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload.<BR/>[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200
application/json

200

The response is of type object.