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

# Accounts

## Compare With EtherScan

<table><thead><tr><th width="498">EndPoint</th><th width="116" align="center">EtherScan</th><th align="center">SocialScan</th></tr></thead><tbody><tr><td>Get Ether Balance for a Single Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Ether Balance for Multiple Addresses in a Single Call</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get a list of 'Normal' Transactions By Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get a list of 'Internal' Transactions by Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get 'Internal Transactions' by Transaction Hash</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get 'Internal Transactions' by Block Range</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get a list of 'ERC20 - Token Transfer Events' by Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get a list of 'ERC721 - Token Transfer Events' by Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get a list of 'ERC1155 - Token Transfer Events' by Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get list of Blocks Validated by Address</td><td align="center">✅</td><td align="center">🛠️</td></tr><tr><td>Get Beacon Chain Withdrawals by Address and Block Range</td><td align="center">✅</td><td align="center">🛠️</td></tr><tr><td>Get Historical Ether Balance for a Single Address By BlockNo</td><td align="center">✅</td><td align="center">✅</td></tr></tbody></table>

## Get Ether Balance for a Single Address

\[<https://docs.etherscan.io/api-endpoints/accounts#get-ether-balance-for-a-single-address>]

Returns the Ether balance of a given address.

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=balance
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &tag=latest
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=balance\&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae\&tag=latest\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=balance
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &tag=latest
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=balance\&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae\&tag=latest\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to check for balance</td></tr><tr><td>tag</td><td>the <code>string</code> pre-defined block parameter, either <code>earliest</code>, <code>pending</code> or <code>latest</code></td></tr></tbody></table>
{% endtab %}

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

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

{% hint style="info" %}
:book: **Tip:** The `result` is returned in **wei**.
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Ether Balance for Multiple Addresses in a Single Call

\[<https://docs.etherscan.io/api-endpoints/accounts#get-ether-balance-for-multiple-addresses-in-a-single-call>]

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

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=balancemulti
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
   &tag=latest
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](#compare-with-etherscan) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=balancemulti
   &addresses=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
   &tag=latest
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=balancemulti\&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67\&tag=latest\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>addresses</td><td>the <code>strings</code> representing the addresses to check for balance, separated by <code>,</code> up to <strong>20 addresses</strong> per call</td></tr><tr><td>tag</td><td>the <code>string</code> pre-defined block parameter, either <code>earliest</code>, <code>pending</code> or <code>latest</code></td></tr></tbody></table>
{% endtab %}

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "account":"0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
         "balance":"40891626854930000000000"
      },
      {
         "account":"0x63a9975ba31b0b9626b34300f7f627147df1f526",
         "balance":"332567136222827062478"
      },
      {
         "account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
         "balance":"0"
      }
   ]
}
```

{% hint style="info" %}
:book: **Tip:** The `result` is returned in **wei**.
{% endhint %}
{% endtab %}
{% endtabs %}

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

\[<https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-normal-transactions-by-address>]

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

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=txlist
   &address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=txlist\&address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367\&startblock=0\&endblock=99999999\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=txlist
   &address=0x6cae3b4237a02652d3d7b2e1e459e6f4b790c698
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=txlist\&address=0x6cae3b4237a02652d3d7b2e1e459e6f4b790c698\&startblock=0\&endblock=99999999\&page=1\&offset=10\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to get transactions where the 'from' or 'to' is the given address</td></tr><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for transactions</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for transactions</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of transactions displayed per page</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descendin <strong>Tip:</strong> Specify a smaller <code>startblock</code> and <code>endblock</code> range for faster search results.</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "7873387",
            "timeStamp": "1695034858",
            "hash": "0x9529f9e9df4e23b147fd35e5b6ef9f02d6780ee4c0e4f64c48c9246b59720a20",
            "nonce": "12565",
            "blockHash": "0xa725218c3100e1b2b58595b19d22a84e568a073d4314f70921bd175ab5942d30",
            "transactionIndex": "0",
            "from": "0x5c30940a4544ca845272fe97c4a27f2ed2cd7b64",
            "to": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "value": "107400000000000000000",
            "gas": "50000",
            "gasPrice": "5000000000",
            "isError": "0",
            "txreceipt_status": "1",
            "input": "0x",
            "contractAddress": null,
            "cumulativeGasUsed": "21000",
            "gasUsed": "21000",
            "confirmations": "",
            "methodId": "0x",
            "functionName": ""
        },
        {
            "blockNumber": "7873439",
            "timeStamp": "1695034889",
            "hash": "0x4c5285cd7d058dd7fdedb4b5478dfe39b6ce827acb11153633588246bcdbd2a1",
            "nonce": "0",
            "blockHash": "0x780111b85a1334326d49f84a1ef7da8e1713c540ba6b3a66591d996fb0675e4f",
            "transactionIndex": "0",
            "from": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "to": "0x7c78b18f496d3d37c44de09da4a5a76eb34b7e74",
            "value": "200000000000000000",
            "gas": "188768",
            "gasPrice": "50000000",
            "isError": "0",
            "txreceipt_status": "1",
            "input": "0x986d800200000000000000000000000073485e0c0fb7781802c1d5d476ad9beac8f913670000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002461643434623263662d333863642d343662342d623932342d383363303235316134636665000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041a7833e5a8baa2f2518e0701dc66c83450445e3a607a6094bab7de86f94945f0d489353f13a0d72c21064d3c9e85a628f19613ec5cdc7dbf0c1e8bf0f66df9e1f1c00000000000000000000000000000000000000000000000000000000000000",
            "contractAddress": null,
            "cumulativeGasUsed": "184461",
            "gasUsed": "184461",
            "confirmations": "",
            "methodId": "0x986d8002",
            "functionName": ""
        }
    ]
}
```

{% endtab %}
{% endtabs %}

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

\[<https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-internal-transactions-by-address>]

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

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=txlistinternal
   &address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=txlistinternal\&address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367\&startblock=0\&endblock=99999999\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=txlistinternal
   &address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=txlistinternal\&address=0x73485e0c0fb7781802c1d5d476ad9beac8f91367\&startblock=0\&endblock=99999999\&page=1\&offset=10\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to get internal transactions where the 'from' or 'to' is the given address</td></tr><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for transactions</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for transactions</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of transactions displayed per page</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descendin <strong>Tip:</strong> Specify a smaller <code>startblock</code> and <code>endblock</code> range for faster search results.</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "7873626",
            "timeStamp": "1695035002",
            "hash": "0x25cd57fe35bb19b4e404ac281180ec29f8563c374e70ca3bdac093f46cf0b446",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x78c1b0c915c4faa5fffa6cabf0219da63d7f4cb8",
            "value": "2475154167674527037",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "72536",
            "gasUsed": "",
            "traceId": "call_7873626_8",
            "isError": "0",
            "errCode": null
        },
        {
            "blockNumber": "7873626",
            "timeStamp": "1695035002",
            "hash": "0x25cd57fe35bb19b4e404ac281180ec29f8563c374e70ca3bdac093f46cf0b446",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "value": "12375770838372636",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "None",
            "gasUsed": "",
            "traceId": "call_7873626_12",
            "isError": "0",
            "errCode": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get 'Internal Transactions' by Transaction Hash

\[<https://docs.etherscan.io/api-endpoints/accounts#get-internal-transactions-by-transaction-hash>]

Returns the list of internal transactions performed within a transaction.

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=txlistinternal
   &txhash=0x25cd57fe35bb19b4e404ac281180ec29f8563c374e70ca3bdac093f46cf0b446
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=txlistinternal\&txhash=0x25cd57fe35bb19b4e404ac281180ec29f8563c374e70ca3bdac093f46cf0b446\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=txlistinternal
   &txhash=0x4cd096de94913d2e57235dde8869afde791327f1f64d272fdd1be503e0b679e7
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=txlistinternal\&txhash=0x4cd096de94913d2e57235dde8869afde791327f1f64d272fdd1be503e0b679e7\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>txhash</td><td>the <code>string</code> representing the transaction hash to check for internal transactions</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "7873626",
            "timeStamp": "1695035002",
            "hash": "0x25cd57fe35bb19b4e404ac281180ec29f8563c374e70ca3bdac093f46cf0b446",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "value": "12375770838372636",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "None",
            "gasUsed": "",
            "traceId": "call_7873626_12",
            "isError": "0",
            "errCode": null
        },
        {
            "blockNumber": "7873654",
            "timeStamp": "1695035023",
            "hash": "0x55361a13df29fc9267eaffcb908e7545ec2a6e67e3bd546c7623b0d210c0e6f8",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "value": "11737706662139411",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "None",
            "gasUsed": "",
            "traceId": "call_7873654_33",
            "isError": "0",
            "errCode": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get "Internal Transactions" by Block Range

\[<https://docs.etherscan.io/api-endpoints/accounts#get-internal-transactions-by-block-range>]

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

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=txlistinternal
   &startblock=7873654
   &endblock=7873655
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=txlistinternal\&startblock=7873654\&endblock=7873655\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=txlistinternal
   &startblock=8654704
   &endblock=8654705
   &page=1
   &offset=10
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=txlistinternal\&startblock=8654704\&endblock=8654705\&page=1\&offset=10\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for transactions</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for transactions</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of internal transactions displayed per page</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descending</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "7873654",
            "timeStamp": "1695035023",
            "hash": "0x55361a13df29fc9267eaffcb908e7545ec2a6e67e3bd546c7623b0d210c0e6f8",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x78c1b0c915c4faa5fffa6cabf0219da63d7f4cb8",
            "value": "1485729890418202888",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "203801",
            "gasUsed": "",
            "traceId": "call_7873654_17",
            "isError": "0",
            "errCode": null
        },
        {
            "blockNumber": "7873654",
            "timeStamp": "1695035023",
            "hash": "0x55361a13df29fc9267eaffcb908e7545ec2a6e67e3bd546c7623b0d210c0e6f8",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x78c1b0c915c4faa5fffa6cabf0219da63d7f4cb8",
            "value": "990140175378268684",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "91081",
            "gasUsed": "",
            "traceId": "call_7873654_29",
            "isError": "0",
            "errCode": null
        },
        {
            "blockNumber": "7873654",
            "timeStamp": "1695035023",
            "hash": "0x55361a13df29fc9267eaffcb908e7545ec2a6e67e3bd546c7623b0d210c0e6f8",
            "from": "0x4bf659ca398a73aaf73818f0c64c838b9e229c08",
            "to": "0x73485e0c0fb7781802c1d5d476ad9beac8f91367",
            "value": "11737706662139411",
            "contractAddress": "",
            "input": "",
            "type": "call",
            "gas": "None",
            "gasUsed": "",
            "traceId": "call_7873654_33",
            "isError": "0",
            "errCode": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get a list of 'ERC20 - Token Transfer Events' by Address

\[<https://docs.etherscan.io/api-endpoints/accounts#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.

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=tokentx
   &contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae
   &address=0xbe18aad013699c1cdd903cb3e6d596ef99c37650
   &page=1
   &offset=5
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=YourApiKeyToken
```

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.w3w.ai/mantle/v1/developer/api?module=account\&action=tokentx\&contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae\&address=0xbe18aad013699c1cdd903cb3e6d596ef99c37650\&page=1\&offset=5\&startblock=0\&endblock=27025780\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=tokentx
   &contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae
   &address=0xbe18aad013699c1cdd903cb3e6d596ef99c37650
   &page=1
   &offset=5
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

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.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=tokentx\&contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae\&address=0xbe18aad013699c1cdd903cb3e6d596ef99c37650\&page=1\&offset=5\&startblock=0\&endblock=27025780\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to get token transfers where the 'from' or 'to' is the given address</td></tr><tr><td>contractaddress</td><td>the <code>string</code> representing the address to get token transfers where the contract address(token) is the given contract address</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of token transfers displayed per page</td></tr><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for token transfers</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for token transfers</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descending</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "7333",
            "timeStamp": "1689577047",
            "hash": "0x81a596d77396be3c0cbf7178fe1519462d2351f3280ccc7523163ebc0d3b6425",
            "nonce": "23",
            "blockHash": "0x8d84507fd64583d0b6f430c154b2aea2b29cb040f332532fc9ff2f1c68f0d54c",
            "from": "0x423f9b19db22337d249c1d85ee045700846953b3",
            "contractAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "to": "0xbe18aad013699c1cdd903cb3e6d596ef99c37650",
            "tokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "transactionIndex": "0",
            "gas": "1046701",
            "gasPrice": "50000000",
            "gasUsed": "695001",
            "cumulativeGasUsed": "695001",
            "value": "152788048",
            "tokenDecimal": "6"
        },
        {
            "blockNumber": "10160",
            "timeStamp": "1689588453",
            "hash": "0x0a5a832cb0c3780545851a9fb0025bdbda55935cf8763f7c8be07078ef9fe62a",
            "nonce": "4",
            "blockHash": "0x2d18e2bbbb7c327c6a96db2847c9d3fb0ab0da2cffd193d1371165ad51551060",
            "from": "0xbe18aad013699c1cdd903cb3e6d596ef99c37650",
            "contractAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "to": "0xb0c6071582e9eb0e3125b6ce85ff6d57077ccf71",
            "tokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "transactionIndex": "0",
            "gas": "313173",
            "gasPrice": "50000000",
            "gasUsed": "204435",
            "cumulativeGasUsed": "204435",
            "value": "8963763",
            "tokenDecimal": "6"
        },
        {
            "blockNumber": "10328",
            "timeStamp": "1689588725",
            "hash": "0x335dd3e3d62749921381e38d3aac728f10c094ad3db64aa1f57dc70f76cd5525",
            "nonce": "11",
            "blockHash": "0x8fd60869ca43d13942acac7c4873d12b6907f2adf6d8808c1ba71e3bce2d654a",
            "from": "0xb0c6071582e9eb0e3125b6ce85ff6d57077ccf71",
            "contractAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "to": "0xbe18aad013699c1cdd903cb3e6d596ef99c37650",
            "tokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "transactionIndex": "0",
            "gas": "318007",
            "gasPrice": "50000000",
            "gasUsed": "202816",
            "cumulativeGasUsed": "202816",
            "value": "10000000",
            "tokenDecimal": "6"
        },
        {
            "blockNumber": "10601",
            "timeStamp": "1689589203",
            "hash": "0x28702874efff0c0e2833276062ff5cb752313c456b9c61d60e5683fa3daf3179",
            "nonce": "18",
            "blockHash": "0xdf82ec7c81cf6a45f0ec10ddaa80576d8c480e11512e1f7d963b87988b251a82",
            "from": "0xbe18aad013699c1cdd903cb3e6d596ef99c37650",
            "contractAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "to": "0xb0c6071582e9eb0e3125b6ce85ff6d57077ccf71",
            "tokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "transactionIndex": "0",
            "gas": "264702",
            "gasPrice": "50000000",
            "gasUsed": "172626",
            "cumulativeGasUsed": "172626",
            "value": "9078358",
            "tokenDecimal": "6"
        },
        {
            "blockNumber": "12472",
            "timeStamp": "1689596060",
            "hash": "0x3a04dd65fe685217672425d6a3ab521de8e9c8318a005c93f9346d6cc0b6f561",
            "nonce": "1",
            "blockHash": "0x5ea738983c438cb03fe16dfd08e64e3ceb0449bac3f56bd2e212d64a64d7fbd6",
            "from": "0xbe18aad013699c1cdd903cb3e6d596ef99c37650",
            "contractAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "to": "0x7757829764d4bf87f29bce9d7ae689011623efcb",
            "tokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "transactionIndex": "0",
            "gas": "290250",
            "gasPrice": "50000000",
            "gasUsed": "189392",
            "cumulativeGasUsed": "189392",
            "value": "4951663",
            "tokenDecimal": "6"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get a list of 'ERC721 - Token Transfer Events' by Address

\[<https://docs.etherscan.io/api-endpoints/accounts#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.

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x03ddc4b60d6bbf399a8397d73462060fdfb83476
   &address=0x03ddc4b60d6bbf399a8397d73462060fdfb83476
   &page=1
   &offset=5
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=YourApiKeyToken
```

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.w3w.ai/mantle/v1/developer/api?module=account\&action=tokennfttx\&contractaddress=0x03ddc4b60d6bbf399a8397d73462060fdfb83476\&address=0x03ddc4b60d6bbf399a8397d73462060fdfb83476\&page=1\&offset=5\&startblock=0\&endblock=27025780\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0xaa9575d63dfc224b9583fc303db3188c08d5c85a
   &address=0x6d8fa3025b6d6604309ca257563cca358c0cf1aa
   &page=1
   &offset=5
   &startblock=0
   &endblock=8762486
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

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.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=tokennfttx\&contractaddress=0xaa9575d63dfc224b9583fc303db3188c08d5c85a\&address=0x6d8fa3025b6d6604309ca257563cca358c0cf1aa\&page=1\&offset=5\&startblock=0\&endblock=8762486\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to get token transfers where the 'from' or 'to' is the given address</td></tr><tr><td>contractaddress</td><td>the <code>string</code> representing the address to get token transfers where the contract address(token) is the given contract address</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of token transfers displayed per page</td></tr><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for token transfers</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for token transfers</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descending</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "553198",
            "timeStamp": "1691015845",
            "hash": "0x61535452b98a9eb4790886293fa52302215f48e3b5ad3f3aac1e620c59aa72bd",
            "nonce": "64744",
            "blockHash": "0x0012a71ccbe151719f7359d5923a9dd153871a66edf27efa396bb3aaf39d0497",
            "from": "0x0000000000000000000000000000000000000000",
            "contractAddress": "0x03ddc4b60d6bbf399a8397d73462060fdfb83476",
            "to": "0x03ddc4b60d6bbf399a8397d73462060fdfb83476",
            "tokenName": "Pandra: CodeConqueror",
            "tokenSymbol": "Pandra: CodeConqueror",
            "transactionIndex": "0",
            "gas": "1554980",
            "gasPrice": "60000000",
            "gasUsed": "189829",
            "cumulativeGasUsed": "189829",
            "tokenID": "452316"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

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

\[<https://docs.etherscan.io/api-endpoints/accounts#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.

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=token1155tx
   &contractaddress=0x55fcd19c08aec229da7f5ee00b5663c0d101249f
   &address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb
   &page=1
   &offset=3
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=YourApiKeyToken
```

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.w3w.ai/mantle/v1/developer/api?module=account\&action=token1155tx\&contractaddress=0x55fcd19c08aec229da7f5ee00b5663c0d101249f\&address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb\&page=1\&offset=3\&startblock=0\&endblock=27025780\&sort=asc\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=token1155tx
   &contractaddress=0x55fcd19c08aec229da7f5ee00b5663c0d101249f
   &address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb
   &page=1
   &offset=3
   &startblock=0
   &endblock=27025780
   &sort=asc
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

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.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=token1155tx\&contractaddress=0x55fcd19c08aec229da7f5ee00b5663c0d101249f\&address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb\&page=1\&offset=3\&startblock=0\&endblock=27025780\&sort=asc\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
> {% endtab %}
> {% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to get token transfers where the 'from' or 'to' is the given address</td></tr><tr><td>contractaddress</td><td>the <code>string</code> representing the address to get token transfers where the contract address(token) is the given contract address</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>the number of token transfers displayed per page</td></tr><tr><td>startblock</td><td>the <code>integer</code> block number to start searching for token transfers</td></tr><tr><td>endblock</td><td>the <code>integer</code> block number to stop searching for token transfers</td></tr><tr><td>sort</td><td>the sorting preference, use <code>asc</code> to sort by ascending and <code>desc</code> to sort by descending</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "19426681",
            "timeStamp": "1699122374",
            "hash": "0x5bfcd6ea3bc720d75366400211f5f93896ecc40a79732130671200a1faf419fb",
            "nonce": "6",
            "blockHash": "0x61faa9546ac6c8591430feb38d1c672eb341a3c052274d8286feb7f0731bb771",
            "from": "0x0000000000000000000000000000000000000000",
            "contractAddress": "0x55fcd19c08aec229da7f5ee00b5663c0d101249f",
            "to": "0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb",
            "tokenName": "Atem Review",
            "tokenSymbol": "AREV",
            "transactionIndex": "0",
            "gas": "95172",
            "gasPrice": "50000000",
            "gasUsed": "89181",
            "cumulativeGasUsed": "89181",
            "tokenValue": "1",
            "tokenID": "47904319105302873047897169606562638416794919136090736404102047423686867157991"
        },
        {
            "blockNumber": "19426803",
            "timeStamp": "1699122431",
            "hash": "0xbf3370a6bea5a7e9843baf5d783afa35678af87274e0e38c8e5c996c5f5a48c2",
            "nonce": "7",
            "blockHash": "0x8b7cac905fbcdb9b2a888fd9f43783850f3e005f20b8c18621cfa74e632235a1",
            "from": "0x0000000000000000000000000000000000000000",
            "contractAddress": "0x55fcd19c08aec229da7f5ee00b5663c0d101249f",
            "to": "0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb",
            "tokenName": "Atem Review",
            "tokenSymbol": "AREV",
            "transactionIndex": "0",
            "gas": "188355",
            "gasPrice": "50000000",
            "gasUsed": "180950",
            "cumulativeGasUsed": "180950",
            "tokenValue": "1",
            "tokenID": "47904319105302873047897169606562638416794919136038005462278939730777873581031"
        },
        {
            "blockNumber": "19426880",
            "timeStamp": "1699122463",
            "hash": "0x39738bd213e559cd82338ff9ddc2c52fe1748693f1f0f3a14feec16300b3ec6d",
            "nonce": "8",
            "blockHash": "0x804fa5ba38566ef1bbdb628d9911c634137e45dcf34ddc950734660cd436615f",
            "from": "0x0000000000000000000000000000000000000000",
            "contractAddress": "0x55fcd19c08aec229da7f5ee00b5663c0d101249f",
            "to": "0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb",
            "tokenName": "Atem Review",
            "tokenSymbol": "AREV",
            "transactionIndex": "0",
            "gas": "85648",
            "gasPrice": "50000000",
            "gasUsed": "79805",
            "cumulativeGasUsed": "79805",
            "tokenValue": "1",
            "tokenID": "19780814495082097322476860826113068384783782804818570138952197515567523954788"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get list of Blocks Validated by Address

## Get Beacon Chain Withdrawals by Address and Block Range

## Get Historical Ether Balance for a Single Address By BlockNo

\[<https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-erc1155-token-transfer-events-by-address>]

{% tabs %}
{% tab title="Mantle" %}

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=balancehistory
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &blockno=8000000
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=balancehistory\&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae\&blockno=8000000\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=balancehistory
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &blockno=8000000
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=balancehistory\&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae\&blockno=8000000\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b) :link:
{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="239">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>the <code>string</code> representing the address to check for balance</td></tr><tr><td>blockno</td><td>the <code>integer</code> block number to check balance for eg. 8000000</td></tr></tbody></table>
{% endtab %}

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

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://thehemera.gitbook.io/explorer-api/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.