Stats

Get Total Supply of Ether

Returns the current amount of Ether in circulation.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=ethsupply
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

No parameters required.

Sample Response

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

📖 Tip : Easily convert Ethereum units using our unit converter.

Get Ether Last Price

Returns the latest price of 1 ETH.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=ethprice
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

No parameters required.

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "ethbtc":"0.07364",
      "ethbtc_timestamp":"1663342777",
      "ethusd":"1444.58",
      "ethusd_timestamp":"1663342774"
   }
}

⏳ Tip : The timestamps are represented in Unix timestamp.

Get Daily Average Gas Limit

Returns the historical daily average gas limit of the Optimism network.

 https://api-optimistic.etherscan.io/api
    ?module=stats
    &action=dailyavggaslimit
    &startdate=2022-02-01
    &enddate=2022-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2022-02-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "gasLimit":"19995225"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "gasLimit":"19992137"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "gasLimit":"19994117"
      }
   ]
}

Get Optimism Daily Total Gas Used

Returns the total amount of gas used daily for transactions on the Optimism network.

 https://api-optimistic.etherscan.io/api
    ?module=stats
    &action=dailygasused
    &startdate=2022-02-01
    &enddate=2022-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2022-02-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "gasUsed":"15209687825"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "gasUsed":"15486974769"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "gasUsed":"14214840593"
      }
   ]
}

Get Daily Average Gas Price

Returns the daily average gas price used on the Optimism network.

 https://api-optimistic.etherscan.io/api
    ?module=stats
    &action=dailyavggasprice
    &startdate=2022-02-01
    &enddate=2022-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-02-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "maxGasPrice_Wei":"243000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"2565412962"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "maxGasPrice_Wei":"338000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"2815449842"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "maxGasPrice_Wei":"328000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"3135220373"
      }
   ]
}

Get ETH Historical Price

Returns the historical price of 1 ETH.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=ethdailyprice
   &startdate=2022-08-01
   &enddate=2022-08-04
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-08-01

enddate

the ending date in yyyy-MM-dd format, eg. 2022-08-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "value":"1.05"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "value":"1.05"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "value":"1.02"
       }
    ]
 }

💰 Tip : The value is represented in US Dollars ( USD ).

Get Daily Network Transaction Fee

Returns the historical amount of transaction fees paid to validators per day.

https://api-optimistic.etherscan.io/api?
   module=stats
   &action=dailytxnfee
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2020-10-01

enddate

the ending date in yyyy-MM-dd format, eg. 2020-10-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2020-10-01",
          "unixTimeStamp":"1601510400",
          "transactionFee_Eth":"14.25013925284"
       },
       {
          "UTCDate":"2020-10-02",
          "unixTimeStamp":"1601596800",
          "transactionFee_Eth":"12.01774328819"
       },
       {
          "UTCDate":"2020-10-03",
          "unixTimeStamp":"1601683200",
          "transactionFee_Eth":"12.13871641757844851"
       }
    ]
 }

Get Daily New Address Count

Returns the historical number of new Optimism Chain addresses created per day.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=dailynewaddress
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-10-01

enddate

the ending date in yyyy-MM-dd format, eg. 2022-10-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2020-10-01",
          "unixTimeStamp":"1601510400",
          "newAddressCount":2131
       },
       {
          "UTCDate":"2020-10-02",
          "unixTimeStamp":"1601596800",
          "newAddressCount":1405
       },
       {
          "UTCDate":"2020-10-03",
          "unixTimeStamp":"1601683200",
          "newAddressCount":124
       }
    ]
 }

Get Daily Network Utilization

Returns the daily average gas used over gas limit percentage.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2022-07-01
   &enddate=2022-07-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-07-01

enddate

the ending date in yyyy-MM-dd format, eg. 2022-07-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-07-01",
          "unixTimeStamp":"1625097600",
          "networkUtilization":"0.8838"
       },
       {
          "UTCDate":"2021-07-02",
          "unixTimeStamp":"1625184000",
          "networkUtilization":"0.7714"
       },
       {
          "UTCDate":"2021-07-03",
          "unixTimeStamp":"1625270400",
          "networkUtilization":"0.7928"
       }
    ]
 }

Get Daily Transaction Count

Returns the number of transactions performed on the Optimism Chain per day.

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=dailytx
   &startdate=2022-07-01
   &enddate=2022-07-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2022-07-01

enddate

the ending date in yyyy-MM-dd format, eg. 2022-07-28

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-07-01",
          "unixTimeStamp":"1625097600",
          "transactionCount":8228730
       },
       {
          "UTCDate":"2021-07-02",
          "unixTimeStamp":"1625184000",
          "transactionCount":5954493
       },
       {
          "UTCDate":"2021-07-03",
          "unixTimeStamp":"1625270400",
          "transactionCount":6247611
       }
    ]
 }