Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo - Etherscan

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo

curl --request GET \
  --url 'https://api.etherscan.io/v2/api?apikey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "1",
  "message": "OK",
  "result": "21265524714464"
}

GET

/

v2

/

api

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo

curl --request GET \
  --url 'https://api.etherscan.io/v2/api?apikey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "1",
  "message": "OK",
  "result": "21265524714464"
}

This is a PRO endpoint, available to the Standard Plan and above

This endpoint is throttled to 2 calls/second regardless of API Pro tier.

{
  "status": "1",
  "message": "OK",
  "result": "21265524714464"
}

Authorizations

apikey

string

query

required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid

string

required

Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.

module

string

default:stats

required

Set to stats for this endpoint.

action

string

default:tokensupplyhistory

required

Set to tokensupplyhistory for this endpoint.

contractaddress

string

required

Contract address of the ERC-20 token.

blockno

integer

required

Block number to check total supply for.

Response

200 - application/json

Successful response

status

string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message

string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result

string

Total supply of the token at the given block, in the token's smallest unit.