Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
https://api-sepolia.lineascan.build/api
?module=account
&action=balance
&address=0xfe5b95b0f1d5e43d639d4986c4dd019be3be556e
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":"8994999936999999706000"
}
Get Ether Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-sepolia.lineascan.build/api
?module=account
&action=balancemulti
&address=0xfe5b95b0f1d5e43d639d4986c4dd019be3be556e,0x10dcb03fde342d16e12ff370f90fe49b2e1c8b59,0x90f0badea60131d90317990b70e5c4e2e4869dd1
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
| the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0xfe5b95b0f1d5e43d639d4986c4dd019be3be556e",
"balance": "8994999936999999706000"
},
{
"account": "0x10dcb03fde342d16e12ff370f90fe49b2e1c8b59",
"balance": "6787999765653498971000"
},
{
"account": "0x90f0badea60131d90317990b70e5c4e2e4869dd1",
"balance": "1000000000000000000000"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-sepolia.lineascan.build/api
?module=account
&action=txlist
&address=0x10dcb03fde342d16e12ff370f90fe49b2e1c8b59
&startblock=0
&endblock=99999999
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the addresses to check for balance |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
💡 Tip: Specify a smaller startblock
and endblock
range for faster search results.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "18894",
"timeStamp": "1711104119",
"hash": "0x1f463583c1436944dc28541d0b13e7f1e07107a7bf327de1de41976efa419c06",
"nonce": "2",
"blockHash": "0x43b6da2212a5a76eafb12b40cf778274f13dd04db00dc6c0728239747b373244",
"transactionIndex": "0",
"from": "0x3357e73873944d885c5496718d0a1326f2cab9b4",
"to": "0x10dcb03fde342d16e12ff370f90fe49b2e1c8b59",
"value": "10000000000000000000000",
"gas": "21000",
"gasPrice": "2716000005",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"gasUsed": "21000",
"confirmations": "241416",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "33282",
"timeStamp": "1711163100",
"hash": "0x2883a67856658ba276355dafb28e89d752183662e57311f3b3064f164ed19460",
"nonce": "0",
"blockHash": "0x9b5bfa4d1de71ab76d25e48141bfe1e424922124894f97b3b852b8eff9b63e64",
"transactionIndex": "0",
"from": "0x10dcb03fde342d16e12ff370f90fe49b2e1c8b59",
"to": "0x3be0ec232d2d9b3912de6f1ff941cb499db4ece7",
"value": "5000000000000000000",
"gas": "21000",
"gasPrice": "1500000007",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"gasUsed": "21000",
"confirmations": "227028",
"methodId": "0x",
"functionName": ""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-sepolia.lineascan.build/api
?module=account
&action=txlistinternal
&address=0x971e727e956690b9957be6d51Ec16E73AcAC83A7
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the addresses to check for balance |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
💡 Tip: Specify a smaller startblock
and endblock
range for faster search results
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "5",
"timeStamp": "1709571370",
"hash": "0x3744bbdc85b53128fc06818651b239ff4fac9667c0ae6ec2c03b67304174dff2",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x07641f3ce8020568c89006db8ca526808827e113",
"value": "0",
"contractAddress": "",
"input": "",
"type": "delegatecall",
"gas": "718986",
"gasUsed": "260308",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "23",
"timeStamp": "1710522648",
"hash": "0x809386f66a84565be38ebdb541798f5d5dcd572038e8d0ec1594f8b4c224f76f",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x07641f3ce8020568c89006db8ca526808827e113",
"value": "0",
"contractAddress": "",
"input": "",
"type": "delegatecall",
"gas": "101814",
"gasUsed": "101814",
"traceId": "0_1",
"isError": "0",
"errCode": ""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
https://api-sepolia.lineascan.build/api
?module=account
&action=txlistinternal
&txhash=0x7f8fd603880eaddc6b5412030aec3f6009401ed02f6c91e3dce2b1087ebb784a
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "260307",
"timeStamp": "1712195926",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x05c2832c1a84432f98788b2067e1a896b3af6025",
"value": "10000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "17886",
"gasUsed": "0",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "260307",
"timeStamp": "1712195926",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x05c2832c1a84432f98788b2067e1a896b3af6025",
"value": "10753426003653",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "260307",
"timeStamp": "1712195926",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x857dbfebd7d29a75ff06d1423c418da3b6e07292",
"value": "5146575480347",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"isError": "0",
"errCode": ""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get "Internal Transactions" by Block Range
Returns the list of internal transactions performed within a block range, with optional pagination.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-sepolia.lineascan.build/api
?module=account
&action=txlistinternal
&startblock=20000
&endblock=260307
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "20124",
"timeStamp": "1711109713",
"hash": "0x06c892a3d32eb0d3c32df306477033d411c5e6a89d01437aba1093ab33d5ad59",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0x07641f3ce8020568c89006db8ca526808827e113",
"value": "25000000000000000",
"contractAddress": "",
"input": "",
"type": "delegatecall",
"gas": "26386",
"gasUsed": "26386",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "20124",
"timeStamp": "1711109713",
"hash": "0x06c892a3d32eb0d3c32df306477033d411c5e6a89d01437aba1093ab33d5ad59",
"from": "0x971e727e956690b9957be6d51ec16e73acac83a7",
"to": "0xa27342f1b74c0cfb2cda74bac1628d0c1a9752f2",
"value": "0",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "100",
"gasUsed": "0",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get a list of 'ERC20 - Token Transfer Events' by Address
Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api-sepolia.lineascan.build/api
?module=account
&action=tokentx
&contractaddress=0x8824fdeacfed56217f52d17ceb818ae4c6e2d4fb
&address=0x46b4fbe9419c7bbcc9c6e3b903828276100bdb3d
&page=1
&offset=100
&startblock=0
&endblock=99999999
&sort=asc
&apikey=YourApiKeyToken
Usage:
ERC-20 transfers from an address, specify the address
parameter
ERC-20 transfers from a contract address, specify the contract address
parameter
ERC-20 transfers from an address filtered by a token contract, specify both address
and contract address
parameters.
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string representing the token contract address to check for balance |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "260106",
"timeStamp": "1712184374",
"hash": "0x03cb0606823d2e87fdf2b753bcaba3dcfaf1689a2b1811cc74d84f0c9f39bdac",
"nonce": "0",
"blockHash": "0xb2c4d2a51ab279954c3ef3c34932af8a3f16568b7decd776b7bfb8d1b4866dd4",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x8824fdeacfed56217f52d17ceb818ae4c6e2d4fb",
"to": "0x46b4fbe9419c7bbcc9c6e3b903828276100bdb3d",
"value": "1000",
"tokenName": "Straight",
"tokenSymbol": "S",
"tokenDecimal": "12",
"transactionIndex": "0",
"gas": "1267700",
"gasPrice": "75000007",
"gasUsed": "1267700",
"cumulativeGasUsed": "1267700",
"input": "deprecated",
"confirmations": "204"
}
]
}
Get a list of 'ERC721 - Token Transfer Events' by Address
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract
https://api-sepolia.lineascan.build/api
?module=account
&action=tokennfttx
&contractaddress=0x03f8b4b140249dc7b2503c928e7258cce1d91f1a
&address=0x5a13206d7edbabe5c1bc59d3bd658485b8bb2adf
&page=1
&offset=100
&startblock=0
&endblock=99999999
&sort=asc
&apikey=YourApiKeyToken
Usage:
ERC-721 transfers from an address, specify the address
parameter
ERC-721 transfers from a contract address, specify the contract address
parameter
ERC-721 transfers from an address filtered by a token contract, specify both address
and contract address
parameters.
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string representing the token contract address to check for balance |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "259908",
"timeStamp": "1712158642",
"hash": "0xfeae80b8c14942172f5d97ec50e3fb131099f785a7cf829d227c322fca2ee275",
"nonce": "5",
"blockHash": "0xfd81c1ba0a56d3212d5e9cc84f4529a7ec993f270593700f0280cdc9e03f8ffe",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x03f8b4b140249dc7b2503c928e7258cce1d91f1a",
"to": "0x5a13206d7edbabe5c1bc59d3bd658485b8bb2adf",
"tokenID": "7",
"tokenName": "Algebra Positions NFT-V2",
"tokenSymbol": "ALGB-POS",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "420877",
"gasPrice": "1500000007",
"gasUsed": "394180",
"cumulativeGasUsed": "394180",
"input": "deprecated",
"confirmations": "402"
}
]
}
Last updated