Comment on page
Accounts
New addition Gas prices for L2 fields such as Gas Price Bid/Paid are now added to the Normal Txns endpoint
📣
✨
Returns the Ether balance of a given address.
https://api.arbiscan.io/api
?module=account
&action=balance
&address=0x88197EaCf7545B2686715FbBE3DBb0ec725A8514
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
tag | the string pre-defined block parameter, either earliest , pending or latest |
Sample response
{
"status": "1",
"message": "OK",
"result": "9075560567492337"
}
Returns the balance of the accounts from a list of addresses.
https://api.arbiscan.io/api
?module=account
&action=balancemulti
&address=0x88197EaCf7545B2686715FbBE3DBb0ec725A8514,0x262a6f88604aa10b30565b02731441ab55d9e9a3,0x27a0a9bf2916685ac00c2abc735eb9048a1c3ba4
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the strings representing the addresses to check for balance, separated by ,
up to 20 addresses per call |
tag | the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x88197EaCf7545B2686715FbBE3DBb0ec725A8514",
"balance":"1230512732137993"
},
{
"account":"0x262a6f88604aa10b30565b02731441ab55d9e9a3",
"balance":"45510297013773890"
},
{
"account":"0x27a0a9bf2916685ac00c2abc735eb9048a1c3ba4",
"balance":"15634979003136277"
}
]
}
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.arbiscan.io/api
?module=account
&action=txlist
&address=0x1a97a5a0063d837fd3365e71e5bdc3894e833e6d
&startblock=0
&endblock=latest
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descendin Tip: Specify a smaller startblock and endblock range for faster search results. |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "11046656",
"timeStamp": "1651511827",
"hash": "0xc55bd3890dc132e5b6c43ed8d5608133731dc096303a933325b8c151bef35223",
"nonce": "1911",
"blockHash": "0xe083eb288e5fd44906e92db36d4cba9062a32c8faa72538678a2e5977b02b173",
"transactionIndex": "0",
"from": "0xf89d7b9c864f589bbf53a82105107622b35eaa40",
"to": "0x1a97a5a0063d837fd3365e71e5bdc3894e833e6d",
"value": "27020940000000000",
"gas": "1200000",
"gasPrice": "722037233",
"gasPriceBid": "902546541",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "0",
"gasUsed": "423200",
"confirmations": "70578588",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "11046738",
"timeStamp": "1651511887",
"hash": "0x0309063f0f52491881cb4dc055555c60edfb943098050000694dd232e4448623",
"nonce": "0",
"blockHash": "0x3cf9b96ea3d666456edf4e96e76a4e4106540932167774b4d51ec9bad3511e61",
"transactionIndex": "0",
"from": "0x1a97a5a0063d837fd3365e71e5bdc3894e833e6d",
"to": "0x61a1ff55c5216b636a294a07d77c6f4df10d3b56",
"value": "0",
"gas": "974575",
"gasPrice": "722037233",
"gasPriceBid": "912546541",
"isError": "0",
"txreceipt_status": "1",
"input": "0x095ea7b30000000000000000000000001c0a560ef9f6ff3f5c2bcce98dc92f2649a507efffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"contractAddress": "",
"cumulativeGasUsed": "51472",
"gasUsed": "570812",
"confirmations": "70578506",
"methodId": "0x095ea7b3",
"functionName": "approve(address spender, uint256 amount)"
}
]
}
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.arbiscan.io/api
?module=account
&action=txlistinternal
&address=0x7dc574BD0be3EDBFAd91aABA289391EB64984B9C
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | 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 resultsSample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"3995059",
"timeStamp":"1640073961",
"hash":"0x40e188690fb6906f701b87f621636c8f99901ed74e5927c2570a4366e7eb6eb0",
"from":"0x7dc574bd0be3edbfad91aaba289391eb64984b9c",
"to":"0x1efb3f88bc88f03fd1804a5c53b7141bbef5ded8",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"315609",
"gasUsed":"201091",
"traceId":"0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"4013752",
"timeStamp":"1640151920",
"hash":"0xbf27ad8b9878440ecc8aab46d4333171273d1e3f87565eb18f8f10ad29437a2e",
"from":"0x7dc574bd0be3edbfad91aaba289391eb64984b9c",
"to":"0x1efb3f88bc88f03fd1804a5c53b7141bbef5ded8",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"314566",
"gasUsed":"201090",
"traceId":"0",
"isError":"0",
"errCode":""
}
]
}
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.arbiscan.io/api
?module=account
&action=txlistinternal
&txhash=0x7f8a6eb0e7154143999e32614b1de2fe918a02f9b169fa369fb308548c426568
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
txhash | the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"21880936",
"timeStamp":"1661793438",
"from":"0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"to":"0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
"value":"99183343867160978",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"350501",
"gasUsed":"51088",
"isError":"0",
"errCode":""
},
{
"blockNumber":"21880936",
"timeStamp":"1661793438",
"from":"0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"to":"0x282161fb6f3c4c45a03f57403b0e1edbc4569565",
"value":"99183343867160",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"315579",
"gasUsed":"0",
"isError":"0",
"errCode":""
}
]
}
The
isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.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.arbiscan.io/api
?module=account
&action=txlistinternal
&startblock=21872710
&endblock=21872720
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"21872711",
"timeStamp":"1661788768",
"hash":"0x44a2d31fe43b28102f3c03c1a088c018a07e5f1e54e3625d386d467afb17ccc6",
"from":"0x0a4d55347817738166e2ef8302e12f99cfbddedd",
"to":"0x0000000000000000000000000000000000000001",
"value":"0",
"contractAddress":"",
"input":"",
"type":"staticcall",
"gas":"2358087",
"gasUsed":"237",
"traceId":"0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"21872711",
"timeStamp":"1661788768",
"hash":"0x44a2d31fe43b28102f3c03c1a088c018a07e5f1e54e3625d386d467afb17ccc6",
"from":"0x0a4d55347817738166e2ef8302e12f99cfbddedd",
"to":"0x0000000000000000000000000000000000000001",
"value":"0",
"contractAddress":"",
"input":"",
"type":"staticcall",
"gas":"2357417",
"gasUsed":"237",
"traceId":"1",
"isError":"0",
"errCode":""
}
]
}
The
isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api.arbiscan.io/api
?module=account
&action=tokentx
&contractaddress=0xda10009cbd5d07dd0cecc66161fc93d7c9000da1
&address=0x27A0A9bf2916685ac00c2abC735eb9048A1c3bA4
&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
andcontract address
parameters.
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"12877796",
"timeStamp":"1653418514",
"hash":"0xc274d5d944fdffd40550eef4c33abba723a76ffa797c613fd909d6df7bd587f0",
"nonce":"0",
"blockHash":"0x5916902f212b864d9b49d1ae6e0bc15827adb279252d62a9d8eec22912cdafc8",
"from":"0xa8642a2085841956a5f0211f9a18e9ae81cfeaf3",
"contractAddress":"0xda10009cbd5d07dd0cecc66161fc93d7c9000da1",
"to":"0x27a0a9bf2916685ac00c2abc735eb9048a1c3ba4",
"value":"4000000000000000000",
"tokenName":"Dai Stablecoin",
"tokenSymbol":"DAI",
"tokenDecimal":"18",
"transactionIndex":"1",
"gas":"845598",
"gasPrice":"515157706",
"gasUsed":"482451",
"cumulativeGasUsed":"221582",
"input":"deprecated",
"confirmations":"9004204"
},
{
"blockNumber":"12887109",
"timeStamp":"1653432975",
"hash":"0xe3abf51773106aadfa1b534474cf04615705a861932360377417c8efeb71e71d",
"nonce":"3",
"blockHash":"0xd4c60b20c004e11e46354493f03ec0be7d2d9b933b226d5d7c985613a181e310",
"from":"0x27a0a9bf2916685ac00c2abc735eb9048a1c3ba4",
"contractAddress":"0xda10009cbd5d07dd0cecc66161fc93d7c9000da1",
"to":"0xed67d6682dc88e06c66e188027ca883455afdada",
"value":"4000000000000000000",
"tokenName":"Dai Stablecoin",
"tokenSymbol":"DAI",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"1092543",
"gasPrice":"403028236",
"gasUsed":"973562",
"cumulativeGasUsed":"414662",
"input":"deprecated",
"confirmations":"8994891"
}
]
}
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api.arbiscan.io/api
?module=account
&action=tokennfttx
&contractaddress=0xc36442b4a4522e871399cd717abdd847ab11fe88
&address=0x7907152ff44693f0bd1c1b78ab8d0ae1f711f696
&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
andcontract address
parameters.
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"19665772",
"timeStamp":"1659919442",
"hash":"0x6760257128cb63b9e8e010b96aa13e27a617cfd2b191bbf51c0d9e77fce1c76a",
"nonce":"5",
"blockHash":"0x15ce0f1d794c0d78f18ca4be4bf883d86612103ae831d148c140b34658d1dae6",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xc36442b4a4522e871399cd717abdd847ab11fe88",
"to":"0x7907152ff44693f0bd1c1b78ab8d0ae1f711f696",
"tokenID":"83555",
"tokenName":"Uniswap V3 Positions NFT-V1",
"tokenSymbol":"UNI-V3-POS",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"1598712",
"gasPrice":"136028367",
"gasUsed":"1190312",
"cumulativeGasUsed":"473632",
"input":"deprecated",
"confirmations":"2216536"
},
{
"blockNumber":"19765413",
"timeStamp":"1660012158",
"hash":"0x5f899a3b1841acfe038779bf560789ed3db7dac3c120820d14ed0aeba76ebcac",
"nonce":"10",
"blockHash":"0x3a4b24dbd459366af327dd52c664b712e849a454d33880cb952e8c7fc54ce771",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xc36442b4a4522e871399cd717abdd847ab11fe88",
"to":"0x7907152ff44693f0bd1c1b78ab8d0ae1f711f696",
"tokenID":"83925",
"tokenName":"Uniswap V3 Positions NFT-V1",
"tokenSymbol":"UNI-V3-POS",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"1875136",
"gasPrice":"288311436",
"gasUsed":"1352480",
"cumulativeGasUsed":"475260",
"input":"deprecated",
"confirmations":"2116895"
}
]
}
Last modified 7mo ago