L2 Deposits/Withdrawals

Get List of Plasma Deposits by Address

Returns a list of Plasma Deposits received by an address.

Applicable to Polygon (137)

https://api.etherscan.io/v2/api
   ?chainid=137
   &module=account
   &action=txnbridge
   &address=0x4880bd4695a8e59dc527d124085749744b6c988e
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for balance
blocktype	the string pre-defined block type, blocksfor canonical blocks
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"19569186",
            "timeStamp":"1632738360",
            "blockReward":"388632493476995398"
        },
        {
            "blockNumber":"19569185",
            "timeStamp":"1632738358",
            "blockReward":"1021530830332446078"
        },
    ]
}

⏳ Note : The timeStamp is represented in Unix timestamp.

Get List of Deposit Transactions

Returns a list of deposits in ETH or ERC20 tokens from Ethereum to L2.

Applicable to Arbitrum Stack (42161, 42170, 33139, 660279) and Optimism Stack (10, 8453, 130, 252, 480, 5000, 81457)

https://api.etherscan.io/v2/api
   ?chainid=10
   &module=account
   &action=getdeposittxs
   &address=0x4880bd4695a8e59dc527d124085749744b6c988e
   &page=1
   &offset=1000
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for deposits
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

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"132992375",
         "timeStamp":"1741583527",
         "blockHash":"0xef2ff158c8b12be842429f4a8cde58bfa6a389c5274b46f8a1dd2ee7f958ca4d",
         "hash":"0x64ccd0cfa9f333578b36227492f3bc7f5f3ec4bfa82cdc46f82884db680d8e5b",
         "nonce":"520502",
         "from":"0x36bde71c97b33cc4729cf772ae268934f7ab70b2",
         "to":"0x4200000000000000000000000000000000000007",
         "value":"598200000000000",
         "gas":"490798",
         "gasPrice":"0",
         "input":"0xd764ad0b000100000000000000000000000000000000000000000000000000000002802a00000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be100000000000000000000000042000000000000000000000000000000000000100000000000000000000000000000000000000000000000000002200f4a8130000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000a41635f5fd0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae00000000000000000000000080f3950a4d371c43360f292a4170624abd9eed030000000000000000000000000000000000000000000000000002200f4a8130000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
         "cumulativeGasUsed":"169497",
         "gasUsed":"117234",
         "isError":"0",
         "errDescription":"",
         "txreceipt_status":"1",
         "queueIndex":"999999",
         "L1transactionhash":"0x303bd05c47e62e1243a33210e535ebc70a7567e53a9972fbdef52ee5bcda5acb",
         "L1TxOrigin":"0x36bde71c97b33cc4729cf772ae268934f7ab70b2",
         "tokenAddress":"ETH",
         "tokenSentFrom":"",
         "tokenSentTo":"0x80f3950a4d371c43360f292a4170624abd9eed03",
         "tokenValue":"598200000000000"
      }
   ]
}

Get List of Withdrawal Transactions

Returns a list of withdrawals in ETH or ERC20 tokens from L2 to Ethereum.

Applicable to Arbitrum Stack (42161, 42170, 33139, 660279) and Optimism Stack (10, 8453, 130, 252, 480, 5000, 81457)

https://api.etherscan.io/v2/api
   ?chainid=10
   &module=account
   &action=getwithdrawaltxs
   &address=0x4880bd4695a8e59dc527d124085749744b6c988e
   &page=1
   &offset=1000
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for withdrawals
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

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"132987309",
         "timeStamp":"1741573395",
         "blockHash":"0xee9bfd69e6866e940c40df94189128534fa5f4af2deec13a793bf49fd5d72f95",
         "hash":"0x481037348afbf205068c2e90d28f7afbb5a1542383e47abf05cbf09a8f960d8d",
         "nonce":"3768",
         "from":"0x7202932b3be70edf0657d5bada261d610e0d7db9",
         "to":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789",
         "value":"0",
         "gas":"361196",
         "gasPrice":"162984",
         "input":"0x1fad948c00000000000000000000000000000000000000000000000000000000000000400000000000000000000000007202932b3be70edf0657d5bada261d610e0d7db900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000f9911231b6ae18952ff6dd6b707908e1aac21b07000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000000180000000000000000000000000000000000000000000000000000000000001ebb8000000000000000000000000000000000000000000000000000000000000d82f00000000000000000000000000000000000000000000000000000000001161ce0000000000000000000000000000000000000000000000000000000000031f83000000000000000000000000000000000000000000000000000000000001adb0000000000000000000000000000000000000000000000000000000000000032000000000000000000000000000000000000000000000000000000000000003c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000164b61d27f600000000000000000000000042000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c4a3a79548000000000000000000000000dd05d9ee23eda1fcabaffddbf7996be735ac76820000000000000000000000004c5f9b65192a9de5473f88a6ffa0b9555ac1a00d0000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000754fd9098af9ddcb41da48a1d78f91f1398965addc000000000000000067ce4d870000000000000000000000000000000000000000f49dfc37e1b78d8a69beb7a79fa80783a872d8b31f938179b60cfa692a32715a3d43f5f7df06b71ba8ecfde76ab35e87c37a7fd91ed161eedaa23482fbcc04de1b000000000000000000000000000000000000000000000000000000000000000000000000000000000000410bddfb295213f2782e48b6e3dcd14c4bd515abc4eb8b5caa256a7ae663e64ad02ab58567a6e53b0adb4345960e074a1ce66de0f43a72fd0244e06f3c3c11ab1e1b00000000000000000000000000000000000000000000000000000000000000",
         "cumulativeGasUsed":"8397325",
         "gasUsed":"216038",
         "isError":"0",
         "errDescription":"",
         "txreceipt_status":"1",
         "message":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007812e000000000000000000000000000000000000000000000000000000000000008056a0c3605593b977fbd97477bbefc139704a8bde838a2c53097662dd9992fef200000000000000000000000000000000000000000000000000000000000001e4d764ad0b00010000000000000000000000000000000000000000000000000000000060d9000000000000000000000000420000000000000000000000000000000000001000000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000e40166a07a0000000000000000000000004fc15c91a9c4a9efb404174464687e8e128730c2000000000000000000000000dd05d9ee23eda1fcabaffddbf7996be735ac7682000000000000000000000000f9911231b6ae18952ff6dd6b707908e1aac21b070000000000000000000000004c5f9b65192a9de5473f88a6ffa0b9555ac1a00d0000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
         "messageNonce":"1766847064778384329583297500742918515827483896875618958121606201292644580",
         "status":"Waiting",
         "L1transactionhash":"",
         "tokenAddress":"0xdd05d9ee23eda1fcabaffddbf7996be735ac7682",
         "withdrawalType":"ERC20",
         "tokenValue":"1000000000000000000",
         "L1transactionhashProve":""
      }
   ]
}