Links
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

Get Ether Balance for a Single Address

Returns the Ether balance of a given address.
https://api.arbiscan.io/api
?module=account
&action=balance
&address=0x88197EaCf7545B2686715FbBE3DBb0ec725A8514
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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"
}
📖
Tip: The result is returned in wei.
Convert Ethereum units using our Unit Converter.

Get Ether Balance for Multiple Addresses in a Single Call

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
Try this endpoint in your browser
🔗
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"
}
]
}
📖 Tip: The result is returned in wei.
Convert Ethereum units using our Unit Converter.

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.arbiscan.io/api
?module=account
&action=txlist
&address=0x1a97a5a0063d837fd3365e71e5bdc3894e833e6d
&startblock=0
&endblock=latest
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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)"
}
]
}

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.arbiscan.io/api
?module=account
&action=txlistinternal
&address=0x7dc574BD0be3EDBFAd91aABA289391EB64984B9C
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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 results
Sample 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":""
}
]
}

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.arbiscan.io/api
?module=account
&action=txlistinternal
&txhash=0x7f8a6eb0e7154143999e32614b1de2fe918a02f9b169fa369fb308548c426568
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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.

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.arbiscan.io/api
?module=account
&action=txlistinternal
&startblock=21872710
&endblock=21872720
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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.

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.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 and contract address parameters.
Try this endpoint in your browser
🔗
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"
}
]
}

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.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 and contract address parameters.
Try this endpoint in your browser
🔗
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"
}
]
}