Optimism
HomeTwitterKnowledge Base
Optimism Etherscan
Optimism Etherscan
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth Proxy
    • Tokens
    • Stats
  • 🏆API PRO
    • API PRO
    • API PRO Endpoints
  • 📖Tutorials
    • Signing Raw Transactions
    • Read/Write Smart Contracts
    • Integrating Google Sheets
    • Verifying Contracts Programmatically
  • 🔧Misc Tools & Utilities
    • Libraries
    • Plugins
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Getting Help
  • Visit Optimism Etherscan
Powered by GitBook
On this page
  • Get Total Supply of Ether
  • Get Ether Last Price
  • Get Daily Average Gas Limit
  • Get Optimism Daily Total Gas Used
  • Get Daily Average Gas Price
  • Get ETH Historical Price
  • Get Daily Network Transaction Fee
  • Get Daily New Address Count
  • Get Daily Network Utilization
  • Get Daily Transaction Count
  1. API Endpoints

Stats

PreviousTokensNextAPI PRO

Last updated 1 year ago

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

No parameters required.

Sample Response

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

Tip : Easily convert Ethereum units using our

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

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

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 

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"
      }
   ]
}

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 

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"
      }
   ]
}

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 

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"
      }
   ]
}

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

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"
       }
    ]
 }

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 

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"
       }
    ]
 }

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

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
       }
    ]
 }

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

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"
       }
    ]
 }

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

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
       }
    ]
 }

Try this endpoint in your

Get Optimism Daily Total Gas Used

Try this endpoint in your

Get Daily Average Gas Price

Try this endpoint in your

Get ETH Historical Price

Try this endpoint in your

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

Get Daily Network Transaction Fee

Try this endpoint in your

Get Daily New Address Count

Try this endpoint in your

Get Daily Network Utilization

Try this endpoint in your

Get Daily Transaction Count

Try this endpoint in your

🎯
💰
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
📖
🔗
⏳
browser
unit converter.
browser
Unix timestamp.