Links

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
Response
No parameters required.
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
Response
No parameters required.
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
Response
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
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
Response
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 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
Response
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",
"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
Response
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
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
Response
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
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
}
]
}