Stats

Endpoints with are under the API Pro subscription. To upgrade your API plan, kindly visit PolygonScan API Pro.

Get Total Supply of MATIC on the Polygon POS Chain

Returns the current amount of MATIC in circulation.

https://api.polygonscan.com/api?
   module=stats
   &action=maticsupply
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

No parameters required.

Response

Sample Response

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

📖 Tip : The result is returned in wei.

Easily convert MATIC units using our unit converter.

Get MATIC Last Price

Returns the latest price of 1 MATIC.

https://api.polygonscan.com/api
   ?module=stats
   &action=maticprice
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

No parameters required.

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "maticbtc":"0.00002575",
      "maticbtc_timestamp":"1632824558",
      "maticusd":"1.079",
      "maticusd_timestamp":"1632824559"
   }
}

⏳ Tip : The timestamps are represented in Unix timestamp.

Get MATIC Historical Price

Returns the historical price of 1 MATIC.

https://api.polygonscan.com/api
   ?module=stats
   &action=ethdailyprice
   &startdate=2021-08-01
   &enddate=2021-08-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. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-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 ).

Get Daily Network Transaction Fee

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

https://api.polygonscan.com/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"
       }
    ]
 }

Get Daily New Address Count

Returns the historical number of new Polygon addresses created per day.

https://api.polygonscan.com/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. 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",
          "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.polygonscan.com/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2021-07-01
   &enddate=2021-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. 2021-07-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-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"
       }
    ]
 }

Get Daily Transaction Count

Returns the number of transactions performed on the Polygon POS Chain per day.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailytx
   &startdate=2021-07-01
   &enddate=2021-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. 2021-07-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-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
       }
    ]
 }