> For the complete documentation index, see [llms.txt](https://docs.blocksscan.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blocksscan.io/api-endpoints/accounts.md).

# 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 %}