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.
https://api.lineascan.build/api
?module=account
&action=balancehistory
&address=0x1336F0cbcD2B67A788ec1eF6a37f7E1c2Dcc47E1
&blockno=5343368
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": "21988485865935486"
}
Convert ETH units using our Unit Converter.
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"blockSize_bytes": 7120
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"blockSize_bytes": 7280
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"blockSize_bytes": 7894
},
{
"UTCDate": "2024-05-18",
"unixTimeStamp": "1715990400",
"blockSize_bytes": 6781
},
{
"UTCDate": "2024-05-19",
"unixTimeStamp": "1716076800",
"blockSize_bytes": 6374
},
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"blockCount": 28799,
"blockRewards_Eth": "5.05948173591574772"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"blockCount": 28797,
"blockRewards_Eth": "4.673198581533348096"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"blockCount": 28793,
"blockRewards_Eth": "5.177073187195568938"
},
{
"UTCDate": "2024-05-18",
"unixTimeStamp": "1715990400",
"blockCount": 28791,
"blockRewards_Eth": "4.19397142412936982"
},
{
"UTCDate": "2024-05-19",
"unixTimeStamp": "1716076800",
"blockCount": 28794,
"blockRewards_Eth": "4.830417484820715669"
},
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"blockRewards_Eth": "0"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"blockRewards_Eth": "0"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"blockRewards_Eth": "0"
},
{
"UTCDate": "2024-05-18",
"unixTimeStamp": "1715990400",
"blockRewards_Eth": "0"
},
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"blockTime_sec": "3.00"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"blockTime_sec": "3.00"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"blockTime_sec": "3.00"
},
{
"UTCDate": "2024-05-18",
"unixTimeStamp": "1715990400",
"blockTime_sec": "3.00"
},
{
"UTCDate": "2024-05-19",
Returns the historical amount of a ERC-20 token in circulation at a certain block height.
https://api.lineascan.build/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
&blockno=5343368
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":"10000000000000000000000000000"
}
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.
https://api.lineascan.build/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
&address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
&blockno=5343368
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":"59506075464776302187283962"
}
Eg. a token with a balance of 215.241526476136819398
and 18 decimal places will be returned as 215241526476136819398
https://api.lineascan.build/api
?module=account
&action=addresstokenbalance
&address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
&page=1
&offset=2
&apikey=YourApikeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x67429b4d93d6fa3b2f175f9a52543ef07c2035b9",
"TokenName": "Soyjacks",
"TokenSymbol": "SoyJ",
"TokenQuantity": "10000000000000000000000000",
"TokenDivisor": "18"
},
{
"TokenAddress": "0x48855d4b8bc24b491a755a77a8b1bc2cc10df2b6",
"TokenName": "Mumu",
"TokenSymbol": "MUMU",
"TokenQuantity": "10000000000000000000000000",
"TokenDivisor": "18"
}
]
}
https://api.lineascan.build/api
?module=account
&action=addresstokennftbalance
&address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
&page=1
&offset=2
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x398f0a3e303afd3cae2b602d6bbe01b1c1af4749",
"TokenName": "Wizard of Linea",
"TokenSymbol": "WIZ",
"TokenQuantity": "2"
}
]
}
https://api.lineascan.build/api
?module=account
&action=addresstokennftinventory
&address=0xC882b111A75C0c657fC507C04FbFcD2cC984F071
&contractaddress=0x398f0a3e303Afd3cAe2b602D6bBe01b1C1AF4749
&page=1
&offset=20
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x398f0a3e303afd3cae2b602d6bbe01b1c1af4749",
"TokenId": "1573"
},
{
"TokenAddress": "0x398f0a3e303afd3cae2b602d6bbe01b1c1af4749",
"TokenId": "4285"
}
]
}
https://api.lineascan.build/api
?module=token
&action=tokenholderlist
&contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566&
&page=1
&offset=10
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenHolderAddress": "0x7f5c179a1d8dc784c7d62d5c25c02df639a3476f",
"TokenHolderQuantity": "5179445387066382344828048333"
},
{
"TokenHolderAddress": "0x21dceed765c30b2abea933a161479aea4702e433",
"TokenHolderQuantity": "74000000000000000000"
},
{
"TokenHolderAddress": "0x86a8138a1dbbb5f42804446caa34dcff79752ebc",
"TokenHolderQuantity": "1000000000000000000"
},
{
"TokenHolderAddress": "0x0096fc3267e9a3cecdbefb9edd09cea0a2cdfe0f",
"TokenHolderQuantity": "575543278391487800000000000"
},
{
"TokenHolderAddress": "0xc24e8f4de66c7113b0e6a7d8270020f684db0955",
"TokenHolderQuantity": "100000000000000000000"
},
{
"TokenHolderAddress": "0xcee1ad5f9ef7263c6f89fe9333ca9f12f235fa50",
"TokenHolderQuantity": "65264"
},
{
"TokenHolderAddress": "0x6adb56433a0ffc68bedb2eb7c1bde846693dae04",
"TokenHolderQuantity": "95000000000000000000"
},
{
"TokenHolderAddress": "0xe73d4b73eff834fef9a0276298c996c5f3b08274",
"TokenHolderQuantity": "450548462321209736353688"
},
{
"TokenHolderAddress": "0x5f8d6597672e0e5fe3a6ef9c88cf18fc675cae7c",
"TokenHolderQuantity": "864901000000000000000000"
},
{
"TokenHolderAddress": "0xd6216fc19db775df9774a6e33526131da7d19a2c",
"TokenHolderQuantity": "233977994423156698010939031"
}
]
}
Returns project information and social media links of an ERC-20/ERC-721 token.
https://api.lineascan.build/api
?module=token
&action=tokeninfo
&contractaddress=0x5FBDF89403270a1846F5ae7D113A989F850d1566
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0x5fbdf89403270a1846f5ae7d113a989f850d1566",
"tokenName": "Foxy",
"symbol": "FOXY",
"divisor": "18",
"tokenType": "ERC20",
"totalSupply": "10000000000000000000000000000",
"blueCheckmark": "false",
"description": "Foxy is a mascot token for the Linea blockchain. Foxy is a culture coin, a meme token for the users of the Linea blockchain to rally behind, and help build a sense of community.",
"website": "https://www.welikethefox.io/",
"email": "",
"blog": "https://welikethefox.medium.com/",
"reddit": "",
"slack": "",
"facebook": "",
"twitter": "https://twitter.com/foxylinea",
"bitcointalk": "",
"github": "",
"telegram": "https://t.me/coinmarketcap",
"wechat": "",
"linkedin": "",
"discord": "",
"whitepaper": "",
"tokenPriceUSD": "0.0223243600"
}
]
}
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
Query Parameters
Sample Response
"gasLimit": "61000000"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"gasLimit": "61000000"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"gasLimit": "61000000"
},
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"gasUsed": "53457324323"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"gasUsed": "53107940956"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"gasUsed": "58137462416"
},
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"maxGasPrice_Wei": "122000000000",
"minGasPrice_Wei": "50000000",
"avgGasPrice_Wei": "150140585"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"maxGasPrice_Wei": "236003862058",
"minGasPrice_Wei": "50000000",
"avgGasPrice_Wei": "127745914"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"maxGasPrice_Wei": "1519122054292",
"minGasPrice_Wei": "50000000",
"avgGasPrice_Wei": "127519124"
},
{
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"value": "3033.46"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"value": "2945.17"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"value": "3093.44"
}
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"transactionFee_Eth": "5.05948173591574772"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"transactionFee_Eth": "4.673198581533348096"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"transactionFee_Eth": "5.177073187195568938"
}
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"newAddressCount": 15045
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"newAddressCount": 30756
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"newAddressCount": 14455
}
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"networkUtilization": "0.0304"
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"networkUtilization": "0.0302"
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"networkUtilization": "0.0331"
}
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
Query Parameters
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2024-05-15",
"unixTimeStamp": "1715731200",
"transactionCount": 402185
},
{
"UTCDate": "2024-05-16",
"unixTimeStamp": "1715817600",
"transactionCount": 404341
},
{
"UTCDate": "2024-05-17",
"unixTimeStamp": "1715904000",
"transactionCount": 440816
},
{
"UTCDate": "2024-05-18",
"unixTimeStamp": "1715990400",
"transactionCount": 370938
Last updated