Accounts

Get XDC Balance for a Single Address

Returns the XDC balance of a given address.

https://api.xdcscan.io/api
   ?module=account
   &action=balance
   &address=xdc60103a1e3b46527ef2032114124dadb01631b2af
   &tag=latest

Try this endpoint in your browser 🔗

Request

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

Response

Sample response

{
"status":1,
"message":"OK",
"result":"45985000000000000000000000"
} 

Get XDC Balance for Multiple Addresses in a Single Call

Returns the balance of the accounts from a list of addresses.

https://api.xdcscan.io/api
   ?module=account
   &action=balancemulti
   &address=xdc3f3fC7F56bA472C5cFE63bc696E3666136938443,xdcb94249638a3cd070794a6896f65b954547685f8f,xdc20b855cc70f6b64c76e20fae544309cc11910fdb
   &tag=latest

Try this endpoint in your browser 🔗

Request

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": {
"message": "OK",
"result": [
{
"account": "0x3f3fc7f56ba472c5cfe63bc696e3666136938443",
"balance": "921700816087500000000",
"stale": true
},
{
"account": "0xb94249638a3cd070794a6896f65b954547685f8f",
"balance": "2738043636316474609925029682",
"stale": false
},
{
"account": "0x20b855cc70f6b64c76e20fae544309cc11910fdb",
"balance": "0",
"stale": false
}
],
"status": "1"
}
}

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.xdcscan.io/api
   ?module=account
   &action=txlist
   &address=0x9ab482582c08bdd503f1e903e7f841380feff55e
   &startblock=75948042
   &endblock=75948242
   &page=1
   &offset=10
   &sort=asc

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter
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.

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": [
{
"input": null,
"blockHash": "0x593a277af553ce183bec885e3ab50ad74aee50806d2bcafa5810e8504fc16276",
"blockNumber": 75948242,
"block_consensus": true,
"timeStamp": "2024-06-14T06:45:34.000Z",
"cumulativeGasUsed": "1698724",
"from": "0x9ab482582c08bdd503f1e903e7f841380feff55e",
"gas": "21000",
"gasPrice": "250000000",
"gasUsed": "21000",
"transactionIndex": 11,
"nonce": 92,
"txreceipt_status": 1,
"to": "0x476eb1d70417f584e351278fe1e83d7f24519926",
"value": "500000000000000000",
"revert_reason": null,
"confirmations": 1078913,
"isError": null
}
]
}

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.xdcscan.io/api
   ?module=account
   &action=txlistinternal
   &address=xdcffa2d110e1c130d90c1c1228636702c904aa70e8
   &startblock=0
   &endblock=57018651
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"data": [
{
"blockNumber": "77010245",
"callType": "call",
"from": "0x6c68c5ba9a2998325f3b9e6658eda130c3ab874f",
"to": "0xffa2d110e1c130d90c1c1228636702c904aa70e8",
"transactionHash": "0x290dc1362b99ca26b92360accf527c395ceeea57f69ac5aaf6f1104fb0afb92f",
"value": "0",
"input": "5339c2960000000000000000000000000000000000000000000000000000000000000075",
"gas": "350652",
"isError": null,
"index": 8,
"gasUsed": "1247",
"contractAddress": "",
"timeStamp": "1720593530"
},
{
"blockNumber": "77010245",
"callType": "call",
"from": "0x6c68c5ba9a2998325f3b9e6658eda130c3ab874f",
"to": "0xffa2d110e1c130d90c1c1228636702c904aa70e8",
"transactionHash": "0x290dc1362b99ca26b92360accf527c395ceeea57f69ac5aaf6f1104fb0afb92f",
"value": "0",
"input": "d0c93a7c",
"gas": "383016",
"isError": null,
"index": 4,
"gasUsed": "234",
"contractAddress": "",
"timeStamp": "1720593530"
},
]
}

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.xdcscan.io/api
   ?module=account
   &action=txlistinternal
   &txhash=0x28223599a92c950d9ace13a67082f05a4f92c38004504472a09ba6039ce4e635

Try this endpoint in your browse 🔗

Request

Query Parameters

Parameter	Description
txhash	the string representing the transaction hash to check for internal transactions

Response

Sample Response

{
"message": "OK",
"status": "1",
"data": [
{
"blockNumber": "64947318",
"callType": "staticcall",
"from": "0x8392687c812c5a4d2d026e47f38fbdd540d802ca",
"to": "0x183477253b3773d0ca1d798c83e7e7572c68375b",
"transactionHash": "0x28223599a92c950d9ace13a67082f05a4f92c38004504472a09ba6039ce4e635",
"value": "0",
"input": "d21220a7",
"gas": "42894262",
"isError": null,
"index": 1192,
"gasUsed": "1081",
"contractAddress": "",
"timeStamp": "1693666311"
},
{
"blockNumber": "64947318",
"callType": "staticcall",
"from": "0x8392687c812c5a4d2d026e47f38fbdd540d802ca",
"to": "0x183477253b3773d0ca1d798c83e7e7572c68375b",
"transactionHash": "0x28223599a92c950d9ace13a67082f05a4f92c38004504472a09ba6039ce4e635",
"value": "0",
"input": "d21220a7",
"gas": "42896495",
"isError": null,
"index": 1191,
"gasUsed": "1081",
"contractAddress": "",
"timeStamp": "1693666311"
},
]
}

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.xdcscan.io/api
   ?module=account
   &action=txlistinternal
   &startblock=56018742 
   &endblock=57018742 
   &page=1
   &offset=10
   &sort=asc

Try this endpoint in your browser 🔗

Request

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"data": [
{
"blockNumber": "56239666",
"callType": "call",
"from": "0xd70ef43752571ba7dff8516863a12b7a26b3b45e",
"to": "0x0000000000000000000000000000000000000089",
"transactionHash": "0x054f51fd5640cf58dc01508a7ac77b91ddfb0edf5e8dc5224ae0d231de1f650a",
"value": "0",
"input": "e341eaa400000000000000000000000000000000000000000000000000000000035a26318111d983e5d3044c8a9ff7550b9d4de90a1bd5769d877faf530aabb6b7bf9358",
"gas": "176168",
"isError": null,
"index": 0,
"gasUsed": "0",
"contractAddress": "",
"timeStamp": "1675224440"
},
{
"blockNumber": "56239666",
"callType": "call",
"from": "0xb9a3a97f6a02a86483bf02cb33f8b33d2d117708",
"to": "0x0000000000000000000000000000000000000089",
"transactionHash": "0x1617ee0acd917e6755bd5f73ba85dc212085f9fb53a92615460bdb786f956081",
"value": "0",
"input": "e341eaa400000000000000000000000000000000000000000000000000000000035a26318111d983e5d3044c8a9ff7550b9d4de90a1bd5769d877faf530aabb6b7bf9358",
"gas": "176168",
"isError": null,
"index": 0,
"gasUsed": "0",
"contractAddress": "",
"timeStamp": "1675224440"
},
{
"blockNumber": "56239666",
"callType": "call",
"from": "0x8f2fb5da850042b7da5097061f098493f8ec6dd8",
"to": "0x0000000000000000000000000000000000000089",
"transactionHash": "0x2008c4ec35af9e60fb64c8372da2af22ba879bc677aaef6254f0530899ae741d",
"value": "0",
"input": "e341eaa400000000000000000000000000000000000000000000000000000000035a26318111d983e5d3044c8a9ff7550b9d4de90a1bd5769d877faf530aabb6b7bf9358",
"gas": "176168",
"isError": null,
"index": 0,
"gasUsed": "0",
"contractAddress": "",
"timeStamp": "1675224440"
},
]
}

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.xdcscan.io/api
   ?module=account
   &action=tokentx
   &contractaddress=0xb062d32b4bcc29767ac6f6f86452a7fbb03a152b
   &address=xdc478a72f7424b7be55a48ed51714cfebba561ee3a
   &page=1
   &offset=100
   &startblock=0
   &endblock=99999999

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

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": [
{
"hash": "0x4a8ac25ed81fca40bfce987a910789da971497ddfec98ba33e919a7bd9f5e582",
"contractAddress": "0xb062d32b4bcc29767ac6f6f86452a7fbb03a152b",
"blockNumber": "75994971",
"confirmations": "11245414",
"blockHash": "0xb88a6cfdd99f1a857b1072d62b285339205c2ea4dee6a70405e84a17cbc538b2",
"input": "a9059cbb000000000000000000000000478a72f7424b7be55a48ed51714cfebba561ee3a0000000000000000000000000000000000000000000000000de0b6b3a7640000",
"timeStamp": "2024-06-15T10:44:52.000Z",
"gas": "200000",
"gasUsed": "53883",
"gasPrice": "1000000000",
"logIndex": 1,
"nonce": "9475",
"value": "0",
"cumulativeGasUsed": "53883",
"transactionIndex": 1,
"from": "0x11abc67e1f6c5ffb277eb6b73a74122a97844bc6",
"to": "0xb062d32b4bcc29767ac6f6f86452a7fbb03a152b",
"tokenName": "Trade Frog",
"tokenSymbol": "TROG",
"tokenDecimal": "18"
}
]
}

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.xdcscan.io/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x2385bd067826f0ac6ad4727cd07d22b84e7af7e8
   &address=xdcdacfd85dc491ca62a58e2f2fd78917d35766c564
   &page=1
   &offset=100
   &startblock=0
   &endblock=27025780
   &sort=asc

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

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": [
{
"hash": "0xec69a1b1eb6a55f442a74d2a1ab2d9d065c27b13ccd253e90ccd070fd11fbd0f",
"contractAddress": "0x2385bd067826f0ac6ad4727cd07d22b84e7af7e8",
"blockNumber": "77281167",
"confirmations": "488283",
"blockHash": "0x32920fa577f998148427144343061655acd879871906c5e75f47e37fe602c76f",
"input": "027a22550000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005168747470733a2f2f7864636e66742e696e667572612d697066732e696f2f697066732f516d583933676748637638765a415742717258774e4a5861505742684432657a6e70524c73573653516d63746f65000000000000000000000000000000",
"timeStamp": "2024-07-16T19:12:19.000Z",
"gas": "294549",
"gasUsed": "294549",
"gasPrice": "250000000",
"logIndex": 4,
"nonce": "23",
"value": "0",
"cumulativeGasUsed": "708287",
"transactionIndex": 4,
"from": "0x510c8974ae266b5a299579c827faf1f4b24776f0",
"to": "0x2385bd067826f0ac6ad4727cd07d22b84e7af7e8",
"tokenName": "XDCNFT",
"tokenSymbol": "XNFT",
"tokenDecimal": null
}
]
}

Get a list of 'ERC1155 - Token Transfer Events' by Address

Returns the list of ERC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract.

https://api.xdcscan.io/api
?module=account
&action=token1155tx
&contractaddress=0x3e50c80f8a6a173a8059830d0cf0c9e5b04c43c0
&address=xdcd64c17cde828456d91b14e820d819f63e24b0160
&page=1
&offset=100
&startblock=0
&endblock=99999999
&sort=asc

Usage:

• ERC-1155 transfers from an address, specify the address parameter

• ERC-1155 transfers from a contract address, specify the contract address parameter

• ERC-1155 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Try this endpoint in your browser 🔗

Request

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

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": [
{
"hash": "0xd1f0764155512dae2e520c2c61a81b762932b78a1885c9cb6019141621aa3885",
"contractAddress": "0x3e50c80f8a6a173a8059830d0cf0c9e5b04c43c0",
"blockNumber": "63870890",
"confirmations": "13898560",
"blockHash": "0xf9cc85f0518c342e116744e403c5e1caf2cdec4c250ee449c422109c836aee6a",
"input": "6d4de477000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000000512068747470733a2f2f78647365612e696e667572612d697066732e696f2f697066732f516d4e7178374b6737453668626e546b3669413661623771397638767554345a6b627954394c644b6a53456464430000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005000000000000000000000000000000000000000000000000000000000000001900000000000000000000000000000000000000000000000000000000000004830000000000000000000000000000000000000000000000004563918244f4000000000000000000000000000000000000000000000000003635c9adc5dea00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006f465794a4f526c524f5957316c496a6f694d6a41794d794243556c6c445253425a5431564f527942535430394c535555675255524a56456c5054694973496b3547564646315957353061585235496a6f694d6a55694c434a4f526c5250636d6470626d4673535731685a3255694f694a6f64485277637a6f764c33686b633256684c584279623251746257566b615745745932397564474670626d56794c6e4d7a4c6d467459587076626d46336379356a62323076626d5a304c7a42345a445930597a45335932526c4f4449344e4455325a446b78596a45305a5467794d4751344d546c6d4e6a4e6c4d6a52694d4445324d433950636d6c6e615735686243394f526c51764d5459354d544d304d7a67784f5455794d6935335a574a7749697769546b5a5554334a6e6157356862456c745957646c55484a6c646d6c6c64794936626e567362437769546b5a55564768316258424a6257466e5a53493649694973496b35475646526f64573177535731685a325651636d563261575633496a6f6949697769546b5a5554334a6e6157356862456c745957646c5358426d63794936496d68306448427a4f6938766547527a5a5745756157356d64584a684c576c775a6e4d75615738766158426d637939526256424d4f45314562565a4b55446c704d56566a4f45746e4e48683462556f78574656485a544d33576e42554d6b746e51584a6a59304e6d566c704b49697769546b5a55564768316258424a6257466e5a556c775a6e4d694f6949694c434a4462323177636d567a6332566b526d6c735a534936496d68306448427a4f6938766547527a5a57457463484a765a4331745a5752705953316a6232353059576c755a584975637a4d7559573168656d39755958647a4c6d4e76625339755a6e51764d48686b4e6a526a4d54646a5a4755344d6a67304e545a6b4f5446694d54526c4f4449775a4467784f5759324d3255794e4749774d5459774c304e76625842795a584e7a5a575176546b5a554c7a45324f54457a4e444d344d546b314d6a49756432566963434973496b4e76625842795a584e7a5a57525561485674596b5a70624755694f6949694c434a4f526c52455a584e6a636d6c7764476c766269493649694d784945354754434245556b46475643425153554e4c584735525169394451564a5054456c4f515342515155355553455653553178755130394d5445564852546f6751557842516b464e515341694c434a5164585250626c4e68624756556558426c496a6f69526d6c345a575251636d6c6a5a534973496c423164453975553246735a53493664484a315a537769546b5a5555484a70593255694f6949784d44417749697769546b5a5554576c756157313162554a705a4349364d43776951327876593274556157316c496a6f69496977695257356b51327876593274556157316c496a6f6949697769546b5a55556d39355957783065534936496a55694c434a4f526c5251636d39775a584a306157567a496a6f6949697769546b5a5551334a6c5958527663694936496a42345a445930597a45335932526c4f4449344e4455325a446b78596a45305a5467794d4751344d546c6d4e6a4e6c4d6a52694d4445324d434973496b354756453933626d5679496a6f694d48686b4e6a526a4d54646a5a4755344d6a67304e545a6b4f5446694d54526c4f4449775a4467784f5759324d3255794e4749774d545977496977695347467a61465a686248566c496a6f694969776954575630526d6c735a534936496a49774d6a4e69636e6c6a5a586c766457356e636d397661326c6c5a57527064476c7662693530654851694c434a4e5a5852685247463059534936496d68306448427a4f6938766547527a5a5745756157356d64584a684c576c775a6e4d75615738766158426d63793952625535786544644c5a7a64464e6d6869626c52724e6d6c424e6d46694e334535646a683264565130576d7469655651355447524c616c4e465a475244496977695132397564484a68593352425a4752795a584e7a496a6f694d48677a5a545577597a67775a6a68684e6d45784e7a4e684f4441314f54677a4d47517759325977597a6c6c4e5749774e474d304d324d77496977695132397564484a68593352556558426c496a6f784d5455314c434a445958526c5a32397965534936496b4e766247786c59335270596d786c63794973496b4e766157354f5957316c496a6f695631684551794973496c56756247396a61304e76626e526c626e51694f6949694c434a44623278735a574e3061573975546d46745a534936496c4e7762334a306379425952454d6749697769513239736247566a64476c76626b356c64486476636d73694f694a5952454d694c434a44623278735a574e306157397555336c74596d3973496a6f694969776959574e3061585a7064486b694f694a4e61573530496e303d000000000000000000000000",
"timeStamp": "2023-08-06T17:43:59.000Z",
"gas": "448641",
"gasUsed": "444074",
"gasPrice": "250000000",
"logIndex": 1,
"nonce": "44",
"value": "0",
"cumulativeGasUsed": "444074",
"transactionIndex": 1,
"from": "0xd64c17cde828456d91b14e820d819f63e24b0160",
"to": "0xcdce3724fba95c29fca1c03f22e0fc77da3c15c1",
"tokenName": "XDSea",
"tokenSymbol": "XDSea",
"tokenDecimal": null
},
{
"hash": "0xe0c0edf7eb50f20627126503953d8bcbf0da7580b149442f57cbecde96269de6",
"contractAddress": "0x3e50c80f8a6a173a8059830d0cf0c9e5b04c43c0",
"blockNumber": "63871471",
"confirmations": "13897979",
"blockHash": "0xd1d3aad1d77dfbc87101124fdf56ce5185219fc040183778cd35e8a3ad48945a",
"input": "6d4de477000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000000512068747470733a2f2f78647365612e696e667572612d697066732e696f2f697066732f516d627a48574d43517974513266714b4239455870726446527778325a5947674a4c7a637079387a4450447837450000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005000000000000000000000000000000000000000000000000000000000000001900000000000000000000000000000000000000000000000000000000000004830000000000000000000000000000000000000000000000001bc16d674ec8000000000000000000000000000000000000000000000000003635c9adc5dea00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006e865794a4f526c524f5957316c496a6f69536b465a5445564f494664425245524d525342535430394c535555675255524a56456c5054694973496b3547564646315957353061585235496a6f694d6a55694c434a4f526c5250636d6470626d4673535731685a3255694f694a6f64485277637a6f764c33686b633256684c584279623251746257566b615745745932397564474670626d56794c6e4d7a4c6d467459587076626d46336379356a62323076626d5a304c7a42345a445930597a45335932526c4f4449344e4455325a446b78596a45305a5467794d4751344d546c6d4e6a4e6c4d6a52694d4445324d433950636d6c6e615735686243394f526c51764d5459354d544d304e5451324d7a55794f5335335a574a7749697769546b5a5554334a6e6157356862456c745957646c55484a6c646d6c6c64794936626e567362437769546b5a55564768316258424a6257466e5a53493649694973496b35475646526f64573177535731685a325651636d563261575633496a6f6949697769546b5a5554334a6e6157356862456c745957646c5358426d63794936496d68306448427a4f6938766547527a5a5745756157356d64584a684c576c775a6e4d75615738766158426d6379395262564e56526a4a485a46646d5154465a4e6e5649626d646e536c707759335272556d5a475447396d574774325a475a7a5456597a61466b32626b704849697769546b5a55564768316258424a6257466e5a556c775a6e4d694f6949694c434a4462323177636d567a6332566b526d6c735a534936496d68306448427a4f6938766547527a5a57457463484a765a4331745a5752705953316a6232353059576c755a584975637a4d7559573168656d39755958647a4c6d4e76625339755a6e51764d48686b4e6a526a4d54646a5a4755344d6a67304e545a6b4f5446694d54526c4f4449775a4467784f5759324d3255794e4749774d5459774c304e76625842795a584e7a5a575176546b5a554c7a45324f54457a4e4455304e6a4d314d6a6b756432566963434973496b4e76625842795a584e7a5a57525561485674596b5a70624755694f6949694c434a4f526c52455a584e6a636d6c7764476c7662694936496b704257557846546942585155524554455567497a4533584735585569394e5355464e535342455430785153456c4f55794263626b4e5054457846523055364945464d51554a42545545694c434a5164585250626c4e68624756556558426c496a6f69526d6c345a575251636d6c6a5a534973496c423164453975553246735a53493664484a315a537769546b5a5555484a70593255694f6949784d44417749697769546b5a5554576c756157313162554a705a4349364d43776951327876593274556157316c496a6f69496977695257356b51327876593274556157316c496a6f6949697769546b5a55556d39355957783065534936496a49694c434a4f526c5251636d39775a584a306157567a496a6f6949697769546b5a5551334a6c5958527663694936496a42345a445930597a45335932526c4f4449344e4455325a446b78596a45305a5467794d4751344d546c6d4e6a4e6c4d6a52694d4445324d434973496b354756453933626d5679496a6f694d48686b4e6a526a4d54646a5a4755344d6a67304e545a6b4f5446694d54526c4f4449775a4467784f5759324d3255794e4749774d545977496977695347467a61465a686248566c496a6f694969776954575630526d6c735a534936496d70686557786c626e64685a4752735a584a76623274705a57566b615852706232347564486830496977695457563059555268644745694f694a6f64485277637a6f764c33686b633256684c6d6c755a6e56795953317063475a7a4c6d6c764c326c775a6e4d7655573169656b685854554e52655852524d6d5a785330493552566877636d5247556e64344d6c705a5232644b5448706a63486b34656b52515248673352534973496b4e76626e527959574e305157526b636d567a63794936496a42344d3255314d474d344d47593459545a684d54637a595467774e546b344d7a426b4d474e6d4d474d355a5456694d44526a4e444e6a4d434973496b4e76626e527959574e3056486c775a5349364d5445314e537769513246305a576476636e6b694f694a44623278735a574e3061574a735a584d694c434a4462326c75546d46745a534936496c645952454d694c434a56626d787659327444623235305a573530496a6f6949697769513239736247566a64476c76626b3568625755694f694a546347397964484d675745524449434973496b4e766247786c593352706232354f5a58523362334a72496a6f695745524449697769513239736247566a64476c76626c4e3562574a766243493649694973496d466a64476c3261585235496a6f6954576c7564434a39000000000000000000000000000000000000000000000000",
"timeStamp": "2023-08-06T18:11:19.000Z",
"gas": "428368",
"gasUsed": "424106",
"gasPrice": "250000000",
"logIndex": 1,
"nonce": "46",
"value": "0",
"cumulativeGasUsed": "424106",
"transactionIndex": 1,
"from": "0xd64c17cde828456d91b14e820d819f63e24b0160",
"to": "0xcdce3724fba95c29fca1c03f22e0fc77da3c15c1",
"tokenName": "XDSea",
"tokenSymbol": "XDSea",
"tokenDecimal": null
},
   ]
}

Get list of Blocks Validated by Address

Returns the list of blocks Validated by an address.

https://api.xdcscan.io/api
   ?module=account
   &action=getminedblocks
   &address=xdc0000000000000000000000000000000000000000
   &blocktype=blocks
   &page=1
   &offset=10

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, either blocks for canonical blocks or uncles for uncle blocks only
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": [
{
"blockNumber": "77027807",
"timeStamp": "2024-07-10T16:56:50.000Z"
},
{
"blockNumber": "77027806",
"timeStamp": "2024-07-10T16:56:48.000Z"
},
{
"blockNumber": "77027805",
"timeStamp": "2024-07-10T16:56:46.000Z"
},
{
"blockNumber": "77027804",
"timeStamp": "2024-07-10T16:56:44.000Z"
},
{
"blockNumber": "77027803",
"timeStamp": "2024-07-10T16:56:42.000Z"
},
{
"blockNumber": "77027802",
"timeStamp": "2024-07-10T16:56:40.000Z"
},
{
"blockNumber": "77027801",
"timeStamp": "2024-07-10T16:56:38.000Z"
},
{
"blockNumber": "77027800",
"timeStamp": "2024-07-10T16:56:36.000Z"
},
{
"blockNumber": "77027799",
"timeStamp": "2024-07-10T16:56:34.000Z"
},
{
"blockNumber": "77027798",
"timeStamp": "2024-07-10T16:56:32.000Z"
}
]
}

⏳ Note : The timeStamp is represented in Unix timestamp. ****

Get Historical XDC Balance for a Single Address By BlockNumber

Returns the balance of an address at a certain block height.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.xdcscan.io/api
   ?module=account
   &action=balancehistory
   &address=xdcd77875dF9C9dE07a5a701F4431743e3A0e9Fe03a
   &blockno=50916245

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for balance
blockno	the integer block number to check balance for eg. 63025284

Response

Sample Response

{
"message": "OK",
"status": "1",
"result": "14700000799.9987295"
}