GET
/
tokens
/
{hash}
/
supplies
/
historical
Token Supplies by Address Historical
curl --request GET \
  --url https://api.amberdata.com/blockchains/tokens/{hash}/supplies/historical \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "columns": [
        "timestamp",
        "numHolders",
        "circulatingSupply",
        "totalSupply"
      ],
      "startDate": 1573257600000,
      "endDate": 1575849600000,
      "decimals": "18"
    },
    "data": [
      [
        1573257600000,
        15460,
        "1000000000000000000000000",
        "1000000000000000000000000"
      ]
    ]
  }
}

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:0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
required

The address for which to retrieve token supply. (example is MKR)

Query Parameters

​
startDate
string<date-time>

Filter by token prices after this date - note that the interval can not exceed 6 months (d), or 30 days (h).

​
endDate
string<date-time>

Filter by token prices before this date - note that the interval can not exceed 6 months (d), or 30 days (h).

​
timeInterval
string
default:days

The time interval to return the historical data in: by day (days) or by hour (hours).

​
timeFormat
string
default:ms

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

Response

200
application/json

OK

The response is of type object.