# 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=xdcd0ad6bc1c9e6fd9fc1be1d674109e1afcc78b058
   &tag=latest
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=account\&action=balance\&address=xdcd0ad6bc1c9e6fd9fc1be1d674109e1afcc78b058\&tag=latest) :link:

{% tabs %}
{% tab title="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` |
| {% endtab %} |                                                                                    |

{% tab title="Response" %}
Sample response

```
{
"status":1,
"message":"OK",
"result":"247034877728026032192152901"
} 
```

{% endtab %}
{% endtabs %}

## 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**](https://api.xdcscan.io/api?module=account\&action=balancemulti\&address=xdc3f3fC7F56bA472C5cFE63bc696E3666136938443,xdcb94249638a3cd070794a6896f65b954547685f8f,xdc20b855cc70f6b64c76e20fae544309cc11910fdb\&tag=latest) :link:

{% tabs %}
{% tab title="Request" %}
Query Parameters

| Parameter    | Description                                                                                                                                                         |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| address      | <p>the <code>strings</code> representing the addresses to check for balance, separated by <code>,</code></p><p><br>up to <strong>20 addresses</strong> per call</p> |
| tag          | the `integer` pre-defined block parameter, either `earliest`, `pending` or `latest`                                                                                 |
| {% endtab %} |                                                                                                                                                                     |

{% tab title="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"
}
}
```

{% endtab %}
{% endtabs %}

## Get a list of 'Normal' Transactions By Address

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

{% hint style="info" %}
📝**Note :** This API endpoint returns a maximum of **10000 records** only.
{% endhint %}

<pre><code>https://api.xdcscan.io/api
   ?module=account
   &#x26;action=txlist
<strong>   &#x26;address=xdcd77875df9c9de07a5a701f4431743e3a0e9fe03a
</strong>   &#x26;startblock=88480972
   &#x26;endblock=88480972
   &#x26;page=1
   &#x26;offset=10
   &#x26;sort=asc
</code></pre>

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=account\&action=txlist\&address=xdcd77875df9c9de07a5a701f4431743e3a0e9fe03a\&startblock=88480972\&endblock=88480972\&page=1\&offset=10\&sort=asc) :link:

{% tabs %}
{% tab title="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. |
| {% endtab %} |                                                                                                                                                                                |

{% tab title="Response" %}
Sample Response

```
{
"message": "OK",
"status": "1",
"result": [
{
"hash": "0xb583ef2d4ef74459c080ce3fa637408b1a115d4886e167e743824636563803d3",
"input": null,
"blockHash": "0x1feec3e76f5967dac3e618a1eedd822da77f13697cbb9fcfad1f9739c6377c64",
"blockNumber": 88480972,
"block_consensus": true,
"timeStamp": 1746873623,
"cumulativeGasUsed": "536920",
"from": "0xd77875df9c9de07a5a701f4431743e3a0e9fe03a",
"gas": "21000",
"gasPrice": "0",
"gasUsed": "21000",
"transactionIndex": 3,
"nonce": 25,
"txreceipt_status": 1,
"to": "0x5f1419480dc0ca1686dfbae553468ec50f46cdc2",
"value": "149999900000000000000000000",
"revert_reason": null,
"confirmations": 7550239,
"isError": null
}
]
}
```

{% endtab %}
{% endtabs %}

## Get a list of 'Internal' Transactions by Address

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

{% hint style="info" %}
:pencil: **Note :** This API endpoint returns a maximum of **10000 records** only.
{% endhint %}

<pre data-overflow="wrap"><code><strong>https://api.xdcscan.io/api
</strong>   ?module=account
   &#x26;action=txlistinternal
   &#x26;address=xdcffa2d110e1c130d90c1c1228636702c904aa70e8
   &#x26;startblock=0
   &#x26;endblock=57018651
   &#x26;page=1
   &#x26;offset=10
   &#x26;sort=asc
   &#x26;apikey=YourApiKeyToken
</code></pre>

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=account\&action=txlistinternal\&address=xdcffa2d110e1c130d90c1c1228636702c904aa70e8) :link:

{% tabs %}
{% tab title="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 |

{% hint style="info" %}
:bulb: **Tip:** Specify a smaller `startblock` and `endblock` range for faster search results
{% endhint %}
{% endtab %}

{% tab title="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"
},
]
}

```

{% endtab %}
{% endtabs %}

## Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

{% hint style="warning" %}
:pencil: **Note :** This API endpoint returns a maximum of **10000 records** only.
{% endhint %}

```
https://api.xdcscan.io/api
   ?module=account
   &action=txlistinternal
   &txhash=0x28223599a92c950d9ace13a67082f05a4f92c38004504472a09ba6039ce4e635
```

> Try this endpoint in your [**browse**](https://api.xdcscan.io/api?module=account\&action=txlistinternal\&txhash=0x28223599a92c950d9ace13a67082f05a4f92c38004504472a09ba6039ce4e635) :link:

{% tabs %}
{% tab title="Request" %}
Query Parameters

| Parameter    | Description                                                                       |
| ------------ | --------------------------------------------------------------------------------- |
| txhash       | the `string` representing the transaction hash to check for internal transactions |
| {% endtab %} |                                                                                   |

{% tab title="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"
},
]
}
```

{% endtab %}
{% endtabs %}

## Get "Internal Transactions" by Block Range

Returns the list of internal transactions performed within a block range, with optional pagination.

{% hint style="warning" %}
​​ :pencil: **Note :** This API endpoint returns a maximum of **10000 records** only.
{% endhint %}

```
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**](https://api.xdcscan.io/api?module=account\&action=txlistinternal\&startblock=56018742\&endblock=57018742\&page=1\&offset=10\&sort=asc) :link:

{% tabs %}
{% tab title="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 |
| {% endtab %} |                                                                                         |

{% tab title="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"
},
]
}
```

{% endtab %}
{% endtabs %}

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

<pre><code>https://api.xdcscan.io/api
   ?module=account
   &#x26;action=tokentx
   &#x26;contractaddress=0x5d5f074837f5d4618b3916ba74de1bf9662a3fed
<strong>   &#x26;address=xdc3e30bedf687ec4de150556575ad3d548e49055c6
</strong>   &#x26;page=1
   &#x26;offset=100
   &#x26;startblock=94600096
   &#x26;endblock=94600096
</code></pre>

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**](https://api.xdcscan.io/api?module=account\&action=tokentx\&contractaddress=0x5d5f074837f5d4618b3916ba74de1bf9662a3fed\&address=xdc3e30bedf687ec4de150556575ad3d548e49055c6\&page=1\&offset=100\&startblock=94600096\&endblock=94600096) :link:

{% tabs %}
{% tab title="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 |
| {% endtab %}    |                                                                                         |

{% tab title="Response" %}
Sample Response

```
{
"message": "OK",
"status": "1",
"result": [
{
"hash": "0xe951e8f013f937441fd512812b1e2332d232fa23ec047cc4758133ff50d01763",
"contractAddress": "0x5d5f074837f5d4618b3916ba74de1bf9662a3fed",
"blockNumber": "95896372",
"confirmations": "135236",
"blockHash": "0xb436754451dca5e68d7543b5e60517ae25a88bd8211986258419c97ef5aeaed8",
"input": "a212c5aa0000000000000000000000003e30bedf687ec4de150556575ad3d548e49055c6",
"timeStamp": "2025-11-11T06:15:55.000Z",
"gas": "81803",
"gasUsed": "81803",
"gasPrice": "12500000000",
"logIndex": 1,
"nonce": "115632",
"value": "0",
"cumulativeGasUsed": "113648",
"transactionIndex": 1,
"from": "0xe34382d3ecdee6e4087c1d76a98a4eed31f63248",
"to": "0x02fe7b136f5dbff8d00546cb5af45afd1e1d350c",
"tokenName": "STORX",
"tokenSymbol": "SRX",
"tokenDecimal": "18"
},
{
"hash": "0x84048d8bb853c3cb38f5a94707c33f7a116dc3a085bd8a41898a81c6ba87af47",
"contractAddress": "0x5d5f074837f5d4618b3916ba74de1bf9662a3fed",
"blockNumber": "94600131",
"confirmations": "1431477",
"blockHash": "0xdb1a639e3725d19ee3576f783862dd953d53d32f4b87c7263b1710b8eeeda171",
"input": "a9059cbb000000000000000000000000dadf533e664dd18e6057875074e14a09962d9eef0000000000000000000000000000000000000000000033f670f6709a6754d9b4",
"timeStamp": "2025-10-09T14:05:17.000Z",
"gas": "200000",
"gasUsed": "43915",
"gasPrice": "12500000000",
"logIndex": 1,
"nonce": "124",
"value": "0",
"cumulativeGasUsed": "87340",
"transactionIndex": 1,
"from": "0x3e30bedf687ec4de150556575ad3d548e49055c6",
"to": "0x5d5f074837f5d4618b3916ba74de1bf9662a3fed",
"tokenName": "STORX",
"tokenSymbol": "SRX",
"tokenDecimal": "18"
},
]
}
```

{% endtab %}
{% endtabs %}

## 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=0x1542b0c97eb74e68114dfe7604d6bd838e521c19
   &address=xdc05362284ec790765f678bf5a4747166137f8f6ea
   &page=1
   &offset=100
   &startblock=92577829
   &endblock=92577829
   &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**](https://api.xdcscan.io/api?module=account\&action=tokennfttx\&contractaddress=0x1542b0c97eb74e68114dfe7604d6bd838e521c19\&address=xdc05362284ec790765f678bf5a4747166137f8f6ea\&page=1\&offset=100\&startblock=92577829\&endblock=92577829) :link:

{% tabs %}
{% tab title="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 |
| {% endtab %}    |                                                                                         |

{% tab title="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
}
]
}
```

{% endtab %}
{% endtabs %}

## 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**](https://api.xdcscan.io/api?module=account\&action=token1155tx\&contractaddress=0x3e50c80f8a6a173a8059830d0cf0c9e5b04c43c0\&address=xdcd64c17cde828456d91b14e820d819f63e24b0160\&page=1\&offset=100\&startblock=0\&endblock=99999999\&sort=asc) :link:

{% tabs %}
{% tab title="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 |
| {% endtab %}    |                                                                                         |

{% tab title="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
},
   ]
}
```

{% endtab %}
{% endtabs %}

## 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=0x3bddd35ddf0945c0151a4ccd547d9e7a0b1fa4cd
   &blocktype=blocks
   &page=1
   &offset=10
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=account\&action=getminedblocks\&address=0x3bddd35ddf0945c0151a4ccd547d9e7a0b1fa4cd\&blocktype=blocks\&page=1\&offset=10) :link:

{% tabs %}
{% tab title="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                                                               |
| {% endtab %} |                                                                                                             |

{% tab title="Response" %}
Sample Response

```
{
"message": "OK",
"status": "1",
"result": [
{
"blockNumber": "96035947",
"timeStamp": "2025-11-14T16:12:29.000Z"
},
{
"blockNumber": "96035840",
"timeStamp": "2025-11-14T16:08:42.000Z"
},
{
"blockNumber": "96035732",
"timeStamp": "2025-11-14T16:05:06.000Z"
},
{
"blockNumber": "96035624",
"timeStamp": "2025-11-14T16:01:30.000Z"
},
{
"blockNumber": "96035482",
"timeStamp": "2025-11-14T15:56:29.000Z"
},
{
"blockNumber": "96035375",
"timeStamp": "2025-11-14T15:52:47.000Z"
},
{
"blockNumber": "96035270",
"timeStamp": "2025-11-14T15:48:46.000Z"
},
{
"blockNumber": "96035163",
"timeStamp": "2025-11-14T15:45:04.000Z"
},
{
"blockNumber": "96035057",
"timeStamp": "2025-11-14T15:41:16.000Z"
},
{
"blockNumber": "96034951",
"timeStamp": "2025-11-14T15:37:28.000Z"
}
]
}
```

{% hint style="warning" %}
:hourglass\_flowing\_sand: **Note :** The `timeStamp` is represented in [**Unix timestamp.** ](https://www.unixtimestamp.com/)\*\*\*\*
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Historical XDC Balance for a Single Address By BlockNumber

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

{% hint style="warning" %}
:pencil: **Note :** This endpoint is throttled to **2 calls/second** regardless of API Pro tier.
{% endhint %}

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

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=account\&action=balancehistory\&address=xdcd77875dF9C9dE07a5a701F4431743e3A0e9Fe03a\&blockno=50916245) :link:

{% tabs %}
{% tab title="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`](https://xdc.blocksscan.io/block/63025284) |
| {% endtab %} |                                                                                                            |

{% tab title="Response" %}
Sample Response

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blocksscan.io/api-endpoints/accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.