Accounts | XDCScan

Get XDC Balance for a Single Address

Returns the XDC balance of a given address.

https://api.xdcscan.com/api
   ?module=account
   &action=balance
   &address=0x0000000000000000000000000000000000000088
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser

Query Parameters

Parameter

Description

Sample response

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

Tip: The result is returned in wei.

Convert XDC units using our Unit Converter.

Get XDC Balance for Multiple Addresses in a Single Call

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

https://api.xdcscan.com/api
   ?module=account
   &action=balancemulti
   &address=0xA488B8FdC6df7cAD537e88b66841F67B1cBB315B,0x0000000000000000000000000000000000000088,0x5e3F8F95d0D663f7b9CeB92e7e013f88319FcB43
   &tag=latest
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "account": "0xA488B8FdC6df7cAD537e88b66841F67B1cBB315B",
      "balance": "3609211978999548500000000000"
    },
    {
      "account": "0x0000000000000000000000000000000000000088",
      "balance": "2990826898000000000000000000"
    },
    {
      "account": "0x5e3F8F95d0D663f7b9CeB92e7e013f88319FcB43",
      "balance": "1186994215880654568882652000"
    }
  ]
}

📖 Tip: The result is returned in wei.

Convert XDC 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.

https://api.xdcscan.com/api
   ?module=account
   &action=txlist
   &address=0x5e3F8F95d0D663f7b9CeB92e7e013f88319FcB43
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response


  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "26630256",
      "timeStamp": "1614363016",
      "hash": "0x7e346ef15b05b138f9a26609384ed08e6c52cf459e35e178f2c3e683342f55fa",
      "nonce": "0",
      "blockHash": "0x559caf5ddbf54b1950233170c5245353880afc665813ef06379fb7308aaf7032",
      "transactionIndex": "0",
      "from": "0x66af49dc66b51175a0170d185e7bd54aa1fc50a7",
      "to": "0x5e3f8f95d0d663f7b9ceb92e7e013f88319fcb43",
      "value": "4999999999999947500000",
      "gas": "21000",
      "gasPrice": "2500",
      "isError": "0",
      "txreceipt_status": "1",
      "input": "0x",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "gasUsed": "21000",
      "confirmations": "54313275",
      "methodId": "0x",
      "functionName": ""
    },
    {
      "blockNumber": "26632134",
      "timeStamp": "1614367208",
      "hash": "0x2b5113d117918a907bceb26e34ce4ec489b26384bc0b02f4c6c70b34f4b56ebd",
      "nonce": "1",
      "blockHash": "0xece8fe0da3fc0b7309d4301864d9a3badf851143be67e8818ad2f92ffc1cf1ba",
      "transactionIndex": "0",
      "from": "0x66af49dc66b51175a0170d185e7bd54aa1fc50a7",
      "to": "0x5e3f8f95d0d663f7b9ceb92e7e013f88319fcb43",
      "value": "599999999999999999947500000",
      "gas": "21000",
      "gasPrice": "2500",
      "isError": "0",
      "txreceipt_status": "1",
      "input": "0x",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "gasUsed": "21000",
      "confirmations": "54311397",
      "methodId": "0x",
      "functionName": ""
    },
    {
      "blockNumber": "26745872",
      "timeStamp": "1614598090",
      "hash": "0xf006bb58bdd3b5bb6a5ba8dfe6e7c06eb4dc7807ca4f948027069aebf08a1123",
      "nonce": "0",
      "blockHash": "0xb344cdede3c411d2156a971e126a569784f3fc12bfae457ec77bc2bfa118f1d3",
      "transactionIndex": "0",
      "from": "0x5e3f8f95d0d663f7b9ceb92e7e013f88319fcb43",
      "to": "0x6c2c3258c47aaad1720c8e6a305bf407a6378548",
      "value": "49999999999800000000000000",
      "gas": "21000",
      "gasPrice": "2500",
      "isError": "0",
      "txreceipt_status": "1",
      "input": "0x",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "gasUsed": "21000",
      "confirmations": "54197659",
      "methodId": "0x",
      "functionName": ""
    },
    {
      "blockNumber": "26746328",
      "timeStamp": "1614599051",
      "hash": "0x2fbfaaf3c9433bab9c2ad67e2136eadb498f9f4f0177a42f70c7041022d914de",
      "nonce": "1",
      "blockHash": "0xaa54873bae17cee5e08e1940888a920cf7262612271f2a0c3fa85d72aaef9893",
      "transactionIndex": "0",
      "from": "0x5e3f8f95d0d663f7b9ceb92e7e013f88319fcb43",
      "to": "0x6c2c3258c47aaad1720c8e6a305bf407a6378548",
      "value": "49999999999800000000000000",
      "gas": "21000",
      "gasPrice": "2500",
      "isError": "0",
      "txreceipt_status": "1",
      "input": "0x",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "gasUsed": "21000",
      "confirmations": "54197203",
      "methodId": "0x",
      "functionName": ""
    },
    {

Get a list of 'Internal' Transactions by Address

Returns the list of internal transactions performed by an address, with optional pagination.

https://api.xdcscan.com/api
   ?module=account
   &action=txlistinternal
   &address=0x0000000000000000000000000000000000000000
   &startblock=0
   &endblock=latest
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "71039198",
      "timeStamp": "1706401172",
      "hash": "0x4f0ba5806e8045be12b50c0ac97cdceeab28732d6604d2f3331acffdfd025c09",
      "from": "0xc0b8e309e6e13a959cf2224a94ed0fc69b6ab900",
      "to": "0x0000000000000000000000000000000000000000",
      "value": "1000000000000000000",
      "contractAddress": "",
      "input": "",
      "type": "call",
      "gas": "2300",
      "gasUsed": "0",
      "traceId": "0_1",
      "isError": "0",
      "errCode": ""
    }
  ]
}

Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

https://api.xdcscan.com/api
   ?module=account
   &action=txlistinternal
   &txhash=0x3190ee988c62654d52d15eb023d7b5727d2104024cad4625791281513127ffac
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"1824790",
         "timeStamp":"1690438927",
         "from":"0x3491fe4c3ababdfee894b1a2ecd042827ddb893d",
         "to":"0xb6319cc6c8c27a8f5daf0dd3df91ea35c4720dd7",
         "value":"109558668139425",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"87093",
         "gasUsed":"84929",
         "isError":"0",
         "errCode":""
      },
      {
         "blockNumber":"1824790",
         "timeStamp":"1690438927",
         "from":"0xb6319cc6c8c27a8f5daf0dd3df91ea35c4720dd7",
         "to":"0x38de71124f7a447a01d67945a51edce9ff491251",
         "value":"109558668139425",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"66756",
         "gasUsed":"65330",
         "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.

https://api.xdcscan.com/api
   ?module=account
   &action=txlistinternal
   &startblock=1000013
   &endblock=1001013
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"1000013",
         "timeStamp":"1688789373",
         "hash":"0x32d96bd248a30e4c279ca97555c5c9d9bd42b8578a562ca10d47e692a51b250e",
         "from":"0x4200000000000000000000000000000000000015",
         "to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
         "value":"0",
         "contractAddress":"",
         "input":"",
         "type":"delegatecall",
         "gas":"956929",
         "gasUsed":"18984",
         "traceId":"0_1",
         "isError":"0",
         "errCode":""
      },
      {
         "blockNumber":"1000014",
         "timeStamp":"1688789375",
         "hash":"0x2f5a3a4b933a1a51f46f2aef2d16d713de8309718140e4f394461abc451d5581",
         "from":"0x4200000000000000000000000000000000000015",
         "to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
         "value":"0",
         "contractAddress":"",
         "input":"",
         "type":"delegatecall",
         "gas":"956929",
         "gasUsed":"27384",
         "traceId":"0_1",
         "isError":"0",
         "errCode":""
      }
   ]
}

The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.

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

Returns the list of XDC-20 tokens transferred by an address, with optional filtering by token contract.

https://api.xdcscan.com/api
   ?module=account
   &action=tokentx
   &contractaddress=0x4200000000000000000000000000000000000006
   &address=0xfcd3842f85ed87ba2889b4d35893403796e67ff1
   &page=1
   &offset=100
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

XDC-20 transfers from an address, specify the address parameter
XDC-20 transfers from a contract address, specify the contract address parameter
XDC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Query Parameters

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"1798354",
         "timeStamp":"1690386055",
         "hash":"0xdb838eaaa510e3d34effdc8c43d8cc07af4a21ee8b8f70f3e6a2852f60942baf",
         "nonce":"5",
         "blockHash":"0x7b4774a4e9acb9f9b3e6c051552e9bd5032146b6e21c3c7fc53c228b7dc979fb",
         "from":"0xfcd3842f85ed87ba2889b4d35893403796e67ff1",
         "contractAddress":"0x4200000000000000000000000000000000000006",
         "to":"0xd02d69c0ab8f5b9201198bde104ab4923b53630e",
         "value":"200000000000000000",
         "tokenName":"Wrapped XDC",
         "tokenSymbol":"WETH",
         "tokenDecimal":"18",
         "transactionIndex":"1",
         "gas":"418716",
         "gasPrice":"1000000000",
         "gasUsed":"322410",
         "cumulativeGasUsed":"369323",
         "input":"deprecated",
         "confirmations":"31671"
      },
      {
         "blockNumber":"1798364",
         "timeStamp":"1690386075",
         "hash":"0x76043f355916523c49ee15988319340da023f293021c77bf102afa3a16865030",
         "nonce":"1",
         "blockHash":"0x68a99cfec6ca05b318421ff86cb39bae251a6a86da2d7d642410d9562c4427e2",
         "from":"0xfcd3842f85ed87ba2889b4d35893403796e67ff1",
         "contractAddress":"0x4200000000000000000000000000000000000006",
         "to":"0xd02d69c0ab8f5b9201198bde104ab4923b53630e",
         "value":"2000000000000000",
         "tokenName":"Wrapped XDC",
         "tokenSymbol":"WETH",
         "tokenDecimal":"18",
         "transactionIndex":"1",
         "gas":"412089",
         "gasPrice":"1500000050",
         "gasUsed":"315315",
         "cumulativeGasUsed":"362228",
         "input":"deprecated",
         "confirmations":"31661"
      }
   ]
}

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

Returns the list of XDC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.

https://api.xdcscan.com/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x1fc10ef15e041c5d3c54042e52eb0c54cb9b710c
   &address=0xb82880e217478907cc9b1e5795d75d3257608ce0
   &page=1
   &offset=100
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

XDC-721 transfers from an address, specify the address parameter
XDC-721 transfers from a contract address, specify the contract address parameter
XDC-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Query Parameters

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"1830023",
         "timeStamp":"1690449393",
         "hash":"0x66485621605e8c8d60ab7ddac0f75ee9c397e24bc3c1e87069b01409a01ec6ad",
         "nonce":"1",
         "blockHash":"0x5a7e2bc24e43181298e19e82c2984f5014ef595caf752036e887fd2a63a04f2f",
         "from":"0x0000000000000000000000000000000000000000",
         "contractAddress":"0x1fc10ef15e041c5d3c54042e52eb0c54cb9b710c",
         "to":"0xb82880e217478907cc9b1e5795d75d3257608ce0",
         "tokenID":"81180",
         "tokenName":"XDC is for builders",
         "tokenSymbol":"BASEBUILDERS",
         "tokenDecimal":"0",
         "transactionIndex":"1",
         "gas":"118857",
         "gasPrice":"1500000050",
         "gasUsed":"79238",
         "cumulativeGasUsed":"126151",
         "input":"deprecated",
         "confirmations":"33"
      }
   ]
}

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

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

https://api.xdcscan.com/api
   ?module=account
   &action=token1155tx
   &contractaddress=0xba5e05cb26b78eda3a2f8e3b3814726305dcac83
   &address=0x8cd98dea4e95170f068e6d5aed1e7f1c285e7f77
   &page=1
   &offset=100
   &startblock=0
   &endblock=99999999
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

XDC-1155 transfers from an address, specify the address parameter
XDC-1155 transfers from a contract address, specify the contract address parameter
XDC-1155 transfers from an address filtered by a token contract, specify both address and contract address parameters.