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 LineaScan's API page

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.lineascan.build/api
   ?module=account
   &action=balancehistory
   &address=0x1336F0cbcD2B67A788ec1eF6a37f7E1c2Dcc47E1
   &blockno=5343368
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

address

the strings representing the addresses to check for balance, separated by , commas

blockno

the integer block number to check balance for eg. 2000000

Returns the daily average block size within a date range.

https://api.lineascan.build/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2024-05-15
   &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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-31

sort

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2024-05-15
   &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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-31

sort

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

Returns the amount of block rewards distributed to validators daily.

https://api.lineascan.build/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2024-05-15
   &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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-31

sort

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2024-05-15
   &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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-31

sort

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

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.lineascan.build/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
   &blockno=5343368
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the ERC-20 token

blockno

the integer block number to check total supply for eg. 4000000

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.lineascan.build/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
   &address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
   &blockno=5343368
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

https://api.lineascan.build/api
    ?module=account
    &action=addresstokenbalance
    &address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
    &page=1
    &offset=2
    &apikey=YourApikeyToken

Try this endpoint in your browser 🔗

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

https://api.lineascan.build/api
    ?module=account
    &action=addresstokennftbalance
    &address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
    &page=1
    &offset=2
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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

https://api.lineascan.build/api
    ?module=account
    &action=addresstokennftinventory
    &address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
    &contractaddress=0x398f0a3e303Afd3cAe2b602D6bBe01b1C1AF4749
    &page=1
    &offset=20
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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

https://api.lineascan.build/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566&
   &page=1
   &offset=10
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

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

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.lineascan.build/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

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

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

 https://api.lineascan.build/api
    ?module=stats
    &action=dailyavggaslimit
    &startdate=2024-05-15
    &enddate=2024-06-01
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

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

 https://api.lineascan.build/api
    ?module=stats
    &action=dailygasused
    &startdate=2024-05-15
    &enddate=2024-06-01
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

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

 https://api.lineascan.build/api
    ?module=stats
    &action=dailyavggasprice
    &startdate=2024-05-15
    &enddate=2024-06-01
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

Returns the historical price of 1 ETH.

https://api.lineascan.build/api
   ?module=stats
   &action=ethdailyprice
   &startdate=2024-05-15
    &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailytxnfee
   &startdate=2024-05-15
    &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailynewaddress
   &startdate=2024-05-15
    &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

Returns the daily average gas used over gas limit percentage.

https://api.lineascan.build/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2024-05-15
    &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailytx
   &startdate=2024-05-15
    &enddate=2024-06-01
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

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

Last updated