API PRO Endpoints

The following is a complete list of additional API endpoints available under the API PRO subscription.

To upgrade your API plan, kindly visit Optimistic Etherscan APIs.

Returns the historical ETH balance of an address at a certain block height.

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

https://api-optimistic.etherscan.io/api
   ?module=account
   &action=balancehistory
   &address=0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1
   &blockno=116110804
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the strings representing the addresses to check for balance, separated by , commas
blockno	the integer block number to check balance for eg. 2000000

Response

Sample Response

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

📖 Tip: The result is returned in wei.

Convert ETH units using our Unit Converter.

Returns the daily average block size within a date range.

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

Try this endpoint in your browser 🔗

Request

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-04
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "UTCDate": "2022-02-01",
      "unixTimeStamp": "1643673600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-02",
      "unixTimeStamp": "1643760000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-03",
      "unixTimeStamp": "1643846400",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-04",
      "unixTimeStamp": "1643932800",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-05",
      "unixTimeStamp": "1644019200",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-06",
      "unixTimeStamp": "1644105600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-07",
      "unixTimeStamp": "1644192000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-08",
      "unixTimeStamp": "1644278400",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-09",
      "unixTimeStamp": "1644364800",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-10",
      "unixTimeStamp": "1644451200",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-11",
      "unixTimeStamp": "1644537600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-12",
      "unixTimeStamp": "1644624000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-13",
      "unixTimeStamp": "1644710400",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-14",
      "unixTimeStamp": "1644796800",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-15",
      "unixTimeStamp": "1644883200",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-16",
      "unixTimeStamp": "1644969600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-17",
      "unixTimeStamp": "1645056000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-18",
      "unixTimeStamp": "1645142400",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-19",
      "unixTimeStamp": "1645228800",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-20",
      "unixTimeStamp": "1645315200",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-21",
      "unixTimeStamp": "1645401600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-22",
      "unixTimeStamp": "1645488000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-23",
      "unixTimeStamp": "1645574400",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-24",
      "unixTimeStamp": "1645660800",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-25",
      "unixTimeStamp": "1645747200",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-26",
      "unixTimeStamp": "1645833600",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-27",
      "unixTimeStamp": "1645920000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2022-02-28",
      "unixTimeStamp": "1646006400",
      "blockSize_bytes": 0
    }
  ]
}

Returns the number of blocks validated daily and the amount of block rewards.

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

Try this endpoint in your browser 🔗

Request

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-04
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "UTCDate": "2022-02-01",
      "unixTimeStamp": "1643673600",
      "blockCount": 34449,
      "blockRewards_Eth": "0.112313071099525485"
    },
    {
      "UTCDate": "2022-02-02",
      "unixTimeStamp": "1643760000",
      "blockCount": 43833,
      "blockRewards_Eth": "0.14485981784310733"
    },
    {
      "UTCDate": "2022-02-03",
      "unixTimeStamp": "1643846400",
      "blockCount": 37329,
      "blockRewards_Eth": "0.122213399047948731"
    },
    {
      "UTCDate": "2022-02-04",
      "unixTimeStamp": "1643932800",
      "blockCount": 35839,
      "blockRewards_Eth": "0.124500452093796503"
    },
    {
      "UTCDate": "2022-02-05",
      "unixTimeStamp": "1644019200",
      "blockCount": 33860,
      "blockRewards_Eth": "0.12721980594650108"
    },
    {
      "UTCDate": "2022-02-06",
      "unixTimeStamp": "1644105600",
      "blockCount": 27472,
      "blockRewards_Eth": "0.084729422722849046"
    },
    {
      "UTCDate": "2022-02-07",
      "unixTimeStamp": "1644192000",
      "blockCount": 34432,
      "blockRewards_Eth": "0.116334358177524818"
    },
    {
      "UTCDate": "2022-02-08",
      "unixTimeStamp": "1644278400",
      "blockCount": 40130,
      "blockRewards_Eth": "0.141397174463682117"
    },
    {
      "UTCDate": "2022-02-09",
      "unixTimeStamp": "1644364800",
      "blockCount": 30955,
      "blockRewards_Eth": "0.103881199669693693"
    },
    {
      "UTCDate": "2022-02-10",
      "unixTimeStamp": "1644451200",
      "blockCount": 38085,
      "blockRewards_Eth": "0.149901960538465736"
    },
    {
      "UTCDate": "2022-02-11",
      "unixTimeStamp": "1644537600",
      "blockCount": 40021,
      "blockRewards_Eth": "0.133392898763221031"
    },
    {
      "UTCDate": "2022-02-12",
      "unixTimeStamp": "1644624000",
      "blockCount": 34119,
      "blockRewards_Eth": "0.201176949480971036"
    },
    {
      "UTCDate": "2022-02-13",
      "unixTimeStamp": "1644710400",
      "blockCount": 27116,
      "blockRewards_Eth": "0.098262573743014655"
    },
    {
      "UTCDate": "2022-02-14",
      "unixTimeStamp": "1644796800",
      "blockCount": 32398,
      "blockRewards_Eth": "0.25391900051223194"
    },
    {
      "UTCDate": "2022-02-15",
      "unixTimeStamp": "1644883200",
      "blockCount": 32376,
      "blockRewards_Eth": "0.065119340149239753"
    },
    {
      "UTCDate": "2022-02-16",
      "unixTimeStamp": "1644969600",
      "blockCount": 31526,
      "blockRewards_Eth": "0.069572223350684361"
    },
    {
      "UTCDate": "2022-02-17",
      "unixTimeStamp": "1645056000",
      "blockCount": 30387,
      "blockRewards_Eth": "0.093273257731924376"
    },
    {
      "UTCDate": "2022-02-18",
      "unixTimeStamp": "1645142400",
      "blockCount": 20999,
      "blockRewards_Eth": "0.108837824859879412"
    },
    {
      "UTCDate": "2022-02-19",
      "unixTimeStamp": "1645228800",
      "blockCount": 16452,
      "blockRewards_Eth": "0.082019908915710786"
    },
    {
      "UTCDate": "2022-02-20",
      "unixTimeStamp": "1645315200",
      "blockCount": 22340,
      "blockRewards_Eth": "0.105237458052274284"
    },
    {
      "UTCDate": "2022-02-21",
      "unixTimeStamp": "1645401600",
      "blockCount": 30640,
      "blockRewards_Eth": "0.120817339768801249"
    },
    {
      "UTCDate": "2022-02-22",
      "unixTimeStamp": "1645488000",
      "blockCount": 29410,
      "blockRewards_Eth": "0.084205448248319998"
    },
    {
      "UTCDate": "2022-02-23",
      "unixTimeStamp": "1645574400",
      "blockCount": 29383,
      "blockRewards_Eth": "0.103805304708082822"
    },
    {
      "UTCDate": "2022-02-24",
      "unixTimeStamp": "1645660800",
      "blockCount": 61397,
      "blockRewards_Eth": "0.273589691871867494"
    },
    {
      "UTCDate": "2022-02-25",
      "unixTimeStamp": "1645747200",
      "blockCount": 40934,
      "blockRewards_Eth": "0.089256020633430275"
    },
    {
      "UTCDate": "2022-02-26",
      "unixTimeStamp": "1645833600",
      "blockCount": 27644,
      "blockRewards_Eth": "0.072901108713905975"
    },
    {
      "UTCDate": "2022-02-27",
      "unixTimeStamp": "1645920000",
      "blockCount": 32725,
      "blockRewards_Eth": "0.071928432978433499"
    },
    {
      "UTCDate": "2022-02-28",
      "unixTimeStamp": "1646006400",
      "blockCount": 41658,
      "blockRewards_Eth": "0.075884683494219752"
    }
  ]
}

Returns the amount of block rewards distributed to validators daily.

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

Try this endpoint in your browser 🔗

Request

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-04
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

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

Returns the daily average of time needed for a block to be successfully validated.

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

Try this endpoint in your browser 🔗

Request

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-04
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "UTCDate": "2022-08-01",
      "unixTimeStamp": "1659312000",
      "blockTime_sec": "0.00"
    },
    {
      "UTCDate": "2022-08-02",
      "unixTimeStamp": "1659398400",
      "blockTime_sec": "0.00"
    },
    {
      "UTCDate": "2022-08-03",
      "unixTimeStamp": "1659484800",
      "blockTime_sec": "0.00"
    },
    {
      "UTCDate": "2022-08-04",
      "unixTimeStamp": "1659571200",
      "blockTime_sec": "0.00"
    }
  ]
}

Returns the historical amount of a ERC-20 token in circulation at a certain block height.

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

https://api-optimistic.etherscan.io/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
   &blockno=20071631
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
blockno	the integer block number to check total supply for eg. 4000000

Response

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Returns the balance of a ERC-20 token of an address at a certain block height.

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

https://api-optimistic.etherscan.io/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1
   &address=0x32faa972024eff1c227ecf33554b328eb8494806
   &blockno=112921824
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for balance
blockno	the integer block number to check total supply for eg. 400000

Response

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Return the current ERC20 token holders and number of tokens held.

https://api-optimistic.etherscan.io/api
    ?module=account
    &action=addresstokenbalance
    &address=0x5a52E96BAcdaBb82fd05763E25335261B270Efcb
    &page=1
    &offset=2
    &apikey=YourApikeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for Token Holdings
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0x4200000000000000000000000000000000000042",
      "TokenName": "Optimism",
      "TokenSymbol": "OP",
      "TokenQuantity": "37999000000000000000000000",
      "TokenDivisor": "18"
    },
    {
      "TokenAddress": "0xdc6ff44d5d932cbd77b52e5612ba0529dc6226f1",
      "TokenName": "Worldcoin",
      "TokenSymbol": "WLD",
      "TokenQuantity": "1000000000000000",
      "TokenDivisor": "18"
    }
  ]
}

Return the current ERC20 token holders and number of tokens held.

https://api-optimistic.etherscan.io/api
    ?module=account
    &action=addresstokennftbalance
    &address=0x5a52E96BAcdaBb82fd05763E25335261B270Efcb
    &page=1
    &offset=2
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for Token Holdings
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0x42adf84b545a3a8f0aa73c746b48f11a323720f2",
      "TokenName": "Optimism X TAKASHI MURAKAMI",
      "TokenSymbol": "TakashiX",
      "TokenQuantity": "2"
    }
  ]
}

https://api-optimistic.etherscan.io/api
    ?module=account
    &action=addresstokennftinventory
    &address=0x5a52e96bacdabb82fd05763e25335261b270efcb
    &contractaddress=0x42Adf84B545A3a8f0aa73c746b48F11a323720f2
    &page=1
    &offset=20
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for inventory
contractaddress	the contract address of the ERC-721 token
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0x42adf84b545a3a8f0aa73c746b48f11a323720f2",
      "TokenId": "9302"
    },
    {
      "TokenAddress": "0x42adf84b545a3a8f0aa73c746b48f11a323720f2",
      "TokenId": "9303"
    }
  ]
}

Return the current ERC20 token holders and number of tokens held.

https://api.optimistic.etherscan.io/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1&
   &page=1
   &offset=10
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenHolderAddress": "0x000000000000000000000000000000000000dead",
      "TokenHolderQuantity": "6549992555825959503"
    },
    {
      "TokenHolderAddress": "0x0000000000003e152231c1f63662abd7b1a56234",
      "TokenHolderQuantity": "2000000000000037"
    }
  ]
}

Returns project information and social media links of an ERC-20/ERC-721 token.

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

https://api-optimistic.etherscan.io/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20/ERC-721 token to retrieve token info

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "contractAddress":"0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
         "tokenName":"ChainLink Token",
         "symbol":"LINK",
         "divisor":"18",
         "tokenType":"ERC20",
         "totalSupply":"1573879.616930000000000000",
         "blueCheckmark":"true",
         "description":"A blockchain-based middleware, acting as a bridge between cryptocurrency smart contracts, data feeds, APIs and traditional bank account payments.",
         "website":"https://chain.link/",
         "email":"[e-mail]",
         "blog":"",
         "reddit":"",
         "slack":"",
         "facebook":"",
         "twitter":"https://twitter.com/chainlink",
         "bitcointalk":"",
         "github":"",
         "telegram":"",
         "wechat":"",
         "linkedin":"",
         "discord":"",
         "whitepaper":"https://link.smartcontract.com/whitepaper",
         "tokenPriceUSD":"24.5400000000"
      }
   ]
}

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 🔗

Request

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

Response

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 

Try this endpoint in your browser 🔗

Request

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

Response

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 

Try this endpoint in your browser 🔗

Request

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

Response

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

Try this endpoint in your browser 🔗

Request

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

Response

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 ).

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 🔗

Request

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

Response

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

Try this endpoint in your browser 🔗

Request

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

Response

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

Try this endpoint in your browser 🔗

Request

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

Response

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

Try this endpoint in your browser 🔗

Request

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

Response

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