> 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/tokens.md).

# Tokens

## 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 ERC20-Token TotalSupply by ContractAddress</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get ERC20-Token Account Balance for TokenContractAddress</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Historical ERC20-Token TotalSupply by ContractAddress &#x26; BlockNo</td><td align="center">✅</td><td align="center">🛠️</td></tr><tr><td>Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Token Holder List by Contract Address</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Token Info by ContractAddress</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Address ERC20 Token Holding</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Address ERC721 Token Holding</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Get Address ERC1155 Token Holding</td><td align="center">-</td><td align="center">✅</td></tr><tr><td>Get Address ERC721 Token Inventory By Contract Address</td><td align="center">✅</td><td align="center">🛠️</td></tr></tbody></table>

## Get ERC20-Token TotalSupply by ContractAddress

\[<https://docs.etherscan.io/api-endpoints/tokens#get-erc20-token-totalsupply-by-contractaddress>]

Returns the current amount of an ERC-20 token in circulation.

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0x09bc4e0d864854c6afb6eb9a9cdf58ac190d0df9
   &apikey=YourApiKeyToken
```

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

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0x34d1ae6076aee4072f54e1156d2e507dd564a355
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=stats\&action=tokensupply\&contractaddress=0x34d1ae6076aee4072f54e1156d2e507dd564a355\&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>contractaddress</td><td>the <code>contract address</code> of the ERC-20 token</td></tr></tbody></table>
{% endtab %}

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

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

{% hint style="info" %}
:chart\_with\_upwards\_trend: **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of 22414291.798388 and 6 decimal places will be returned as 22414291798388
{% endhint %}
{% endtab %}
{% endtabs %}

## Get ERC20-Token Account Balance for TokenContractAddress

\[<https://docs.etherscan.io/api-endpoints/tokens#get-erc20-token-account-balance-for-tokencontractaddress>]

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae
   &address=0xd08c50f7e69e9aeb2867deff4a8053d9a855e26a
   &tag=latest&apikey=YourApiKeyToken
```

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

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da
   &address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586
   &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=tokenbalance\&contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da\&address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586\&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>contractaddress</td><td>the <code>contract address</code> of the ERC-20 token</td></tr><tr><td>address</td><td>the <code>string</code> representing the address to check for token balance</td></tr></tbody></table>
{% endtab %}

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

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

{% hint style="info" %}
:chart\_with\_upwards\_trend: **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of 1406822.890398 and 6 decimal places will be returned as 1406822890398
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo

\[<https://docs.etherscan.io/api-endpoints/tokens#get-historical-erc20-token-totalsupply-by-contractaddress-and-blockno>]

Returns the amount of an ERC-20 token in circulation at a certain block height.

## Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo

\[<https://docs.etherscan.io/api-endpoints/tokens#get-historical-erc20-token-account-balance-for-tokencontractaddress-by-blockno>]

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x201eba5cc46d216ce6dc03f6a759e8e766e956ae
   &address=0xd08c50f7e69e9aeb2867deff4a8053d9a855e26a
   &blockno=8000000
   &apikey=YourApiKeyToken 
```

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

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da
   &address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586
   &blockno=8740590
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b 
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=tokenbalancehistory\&contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da\&address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586\&blockno=8740590\&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>contractaddress</td><td>the <code>contract address</code> of the ERC-20 token</td></tr><tr><td>address</td><td>the <code>string</code> representing the address to check for token balance</td></tr><tr><td>blockno</td><td>the <code>integer</code> block number to check total supply for eg. <a href="https://mantle.socialscan.xyz/block/8000000"><code>8000000</code></a></td></tr></tbody></table>
{% endtab %}

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

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

{% hint style="info" %}
:chart\_with\_upwards\_trend: **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of 26739.19025 and 6 decimal places will be returned as 26739190250
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Token Holder List by Contract Address

\[<https://docs.etherscan.io/api-endpoints/tokens#get-token-holder-list-by-contract-address>]

Return the current ERC20 token holders and number of tokens held.

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111
   &page=1
   &offset=5
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=token\&action=tokenholderlist\&contractaddress=0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111\&page=1\&offset=5\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da
   &page=1
   &offset=5
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=token\&action=tokenholderlist\&contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da\&page=1\&offset=5\&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>contractaddress</td><td>the <code>contract address</code> of the ERC-20 token</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></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "TokenHolderAddress": "0x66bd27cd79ec9dabfc13af537f0e582ca43dbc1e",
            "TokenHolderQuantity": "1"
        },
        {
            "TokenHolderAddress": "0x28edaf755e229534cab2ee286d01c85ab183523a",
            "TokenHolderQuantity": "23"
        },
        {
            "TokenHolderAddress": "0x461234ed54c90ad9f3cd2a8a014aafe0fb4e2732",
            "TokenHolderQuantity": "10000000"
        },
        {
            "TokenHolderAddress": "0x2fc261f7cab6d50580e3007a0ed793d95a1c4e2e",
            "TokenHolderQuantity": "4"
        },
        {
            "TokenHolderAddress": "0x1568ed1cda2eb4b1662c8b2ff1878dee9cc5a302",
            "TokenHolderQuantity": "3"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get Token Info by ContractAddress

\[<https://docs.etherscan.io/api-endpoints/tokens#get-token-info-by-contractaddress>]

Returns project information and social media links of an ERC20/ERC721/ERC1155 token.

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0xf93a85d53e4af0d62bdf3a83ccfc1ecf3eaf9f32
   &apikey=YourApiKeyToken 
```

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

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b 
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=token\&action=tokeninfo\&contractaddress=0x9bcd29c774ba0ce762fc56fde806bd43ed9786da\&apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91ba) :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>contractaddress</td><td>the <code>contract address</code> of the ERC-20/ERC-721 token to retrieve token info</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": {
        "TokenName": "LUSD Stablecoin",
        "TokenSymbol": "LUSD",
        "TokenTotalSupply": "1747906622933561647279",
        "TokenType": "ERC20",
        "TokenDecimals": "18"
    }
}
```

{% endtab %}
{% endtabs %}

## Get Address ERC20 Token Holding&#x20;

\[<https://docs.etherscan.io/api-endpoints/tokens#get-address-erc20-token-holding>]

Returns the ERC-20 tokens and amount held by an address.

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=addresstokenbalance
   &address=0xf89d7b9c864f589bbf53a82105107622b35eaa40
   &page=1
   &offset=100
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=addresstokenbalance\&address=0xf89d7b9c864f589bbf53a82105107622b35eaa40\&page=1\&offset=100\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=addresstokenbalance
   &address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586
   &page=1
   &offset=100
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=addresstokenbalance\&address=0x0bd4ece3939ce5163d8f4ede3740987107c6f586\&page=1\&offset=100\&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 ERC-20 tokens holding</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>he number of transactions displayed per page</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "TokenAddress": "0x06cdb69b6c1d376b1d41bfbb956d49db0f87542b",
            "TokenName": "MantleApe",
            "tokenSymbol": "MAPE",
            "TokenQuantity": "138000000000",
            "TokenDecimals": "1"
        },
        {
            "TokenAddress": "0x09bc4e0d864854c6afb6eb9a9cdf58ac190d0df9",
            "TokenName": "USD Coin",
            "tokenSymbol": "USDC",
            "TokenQuantity": "3910690315139",
            "TokenDecimals": "6"
        },
        {
            "TokenAddress": "0x201eba5cc46d216ce6dc03f6a759e8e766e956ae",
            "TokenName": "Tether USD",
            "tokenSymbol": "USDT",
            "TokenQuantity": "11971345772297",
            "TokenDecimals": "6"
        },
        {
            "TokenAddress": "0x2cb76c8949c7b7fae6dc0614c3b1bfd435f9a0bc",
            "TokenName": "Pepe",
            "tokenSymbol": "PEPE",
            "TokenQuantity": "500000000000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x411c318619c14773b7ab5c8db3ab53d1010d6c38",
            "TokenName": "WhenAirdrop?MakeCommunityHappy&Huge",
            "tokenSymbol": "WHEN",
            "TokenQuantity": "2000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x4c5009bad4aee10682c837a80bdf3525b2a5e41f",
            "TokenName": "Eltam",
            "tokenSymbol": "ELT",
            "TokenQuantity": "17000921623470080659",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x4e466be172c2ebf18a91eaead0eb5bcc10c0c0f7",
            "TokenName": "X",
            "tokenSymbol": "X",
            "TokenQuantity": "1000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x554388ec984278a3c5bff09e6192c20cdfca9f29",
            "TokenName": "Ukrainian hooper",
            "tokenSymbol": "UAHM",
            "TokenQuantity": "1000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x6a3b0eb5b57c9a4f5772fc900dae427e65f8c1a5",
            "TokenName": "Cashtree Token",
            "tokenSymbol": "CTT",
            "TokenQuantity": "195763311783601265459289720",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0x78c1b0c915c4faa5fffa6cabf0219da63d7f4cb8",
            "TokenName": "Wrapped Mantle",
            "tokenSymbol": "WMNT",
            "TokenQuantity": "30472181712879423539880",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xace06325ad4ee36b621445331cac216b0684551a",
            "TokenName": "Walter White",
            "tokenSymbol": "WW",
            "TokenQuantity": "10000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xc1db3ba4b6222bcb1e9b755984469ad88fb42c42",
            "TokenName": "AlphaNutUncleSnus",
            "tokenSymbol": "ANUS",
            "TokenQuantity": "21000000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xc6852ca665409d46a9b80eee98fb14a60b3e0cd8",
            "TokenName": "Bitcoin",
            "tokenSymbol": "BTC",
            "TokenQuantity": "100000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xcabae6f6ea1ecab08ad02fe02ce9a44f09aebfa2",
            "TokenName": "Wrapped BTC",
            "tokenSymbol": "WBTC",
            "TokenQuantity": "233919131",
            "TokenDecimals": "8"
        },
        {
            "TokenAddress": "0xce55c1100f816c42ad33ea5ab032b5ef8634811b",
            "TokenName": "RETOPALER",
            "tokenSymbol": "DUDE",
            "TokenQuantity": "1000000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xd882fa1c026f796bc548bc22d1e1049fda386d2e",
            "TokenName": "Mantle Masters",
            "tokenSymbol": "MAM",
            "TokenQuantity": "510000000000000000000000",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111",
            "TokenName": "Ether",
            "tokenSymbol": "WETH",
            "TokenQuantity": "8881924400349711009864",
            "TokenDecimals": "18"
        },
        {
            "TokenAddress": "0xed17f8559a6441819542fe86a100886388e9bb52",
            "TokenName": "Mentos",
            "tokenSymbol": "MENTOS",
            "TokenQuantity": "1000000000000000000",
            "TokenDecimals": "18"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get Address ERC721 Token Holding

\[<https://docs.etherscan.io/api-endpoints/tokens#get-address-erc721-token-holding>]

Returns the ERC-721 tokens and amount held by an address.&#x20;

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=addresstokennftbalance
   &address=0xf89d7b9c864f589bbf53a82105107622b35eaa40
   &page=1
   &offset=100
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=addresstokennftbalance\&address=0xf89d7b9c864f589bbf53a82105107622b35eaa40\&page=1\&offset=100\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=addresstokennftbalance
   &address=0x3d1ee7bf1e52dc7714fcd82b891f3bd053cc17b7
   &page=1
   &offset=100
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=addresstokennftbalance\&address=0x3d1ee7bf1e52dc7714fcd82b891f3bd053cc17b7\&page=1\&offset=100\&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 ERC-1155 tokens holding</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>he number of transactions displayed per page</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "TokenAddress": "0x7cb4682c6b998e0ca6a3d9aa08a8c66b5e7bf01f",
            "TokenName": "Meow(OMIO) in Mantle",
            "tokenSymbol": "OMIO",
            "TokenQuantity": "500"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get Address ERC1155 Token Holding

Returns the ERC-1155 tokens and amount held by an address

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=addresstoken1155balance
   &address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb
   &page=1
   &offset=100
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=addresstoken1155balance\&address=0x66c623746decd4e7b53d7b0d9e8ad2eb09074fcb\&page=1\&offset=100\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
https://api.socialscan.io/monad-testnet/v1/developer/api
   ?module=account
   &action=addresstoken1155balance
   &address=0x50346bfec4623d0c186f981ae3906fccffa8bc27
   &page=1
   &offset=100
   &apikey=8f9d3e27-a516-4c08-b235-7d94f02ca91b
```

> Try this endpoint in your [**browser**](https://api.socialscan.io/monad-testnet/v1/developer/api?module=account\&action=addresstoken1155balance\&address=0x50346bfec4623d0c186f981ae3906fccffa8bc27\&page=1\&offset=100\&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 ERC-1155 tokens holding</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>he number of transactions displayed per page</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "TokenAddress": "0x0d380362762b0cf375227037f2217f59a4ec4b9e",
            "TokenName": "Unknown Token",
            "tokenSymbol": "UNKNOWN",
            "TokenQuantity": "6",
            "TokenID": "1"
        },
        {
            "TokenAddress": "0x47cadd4d96bb9576801daea369e6e2e56fee0d19",
            "TokenName": "Unknown Token",
            "tokenSymbol": "UNKNOWN",
            "TokenQuantity": "1",
            "TokenID": "1"
        },
        {
            "TokenAddress": "0x55fcd19c08aec229da7f5ee00b5663c0d101249f",
            "TokenName": "Atem Review",
            "tokenSymbol": "AREV",
            "TokenQuantity": "4",
            "TokenID": "7058472944302784265226680021550255369409155060545734611887342597112214857488"
        },
        {
            "TokenAddress": "0x55fcd19c08aec229da7f5ee00b5663c0d101249f",
            "TokenName": "Atem Review",
            "tokenSymbol": "AREV",
            "TokenQuantity": "1",
            "TokenID": "7058472944302784265226680021550255369409155060576883187386365782103785744144"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Get Address ERC721 Token Inventory By Contract Address <a href="#get-address-erc721-token-inventory-by-contract-address" id="get-address-erc721-token-inventory-by-contract-address"></a>

\[<https://docs.etherscan.io/api-endpoints/tokens#get-address-erc721-token-inventory-by-contract-address>]

Returns the ERC-721 token inventory of an address, filtered by contract address.&#x20;

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

```
https://api.w3w.ai/mantle/v1/developer/api
   ?module=account
   &action=addresstokennftinventory
   &address=0x03ddc4b60d6bbf399a8397d73462060fdfb83476
   &contractaddress=0x03ddc4b60d6bbf399a8397d73462060fdfb83476
   &page=1
   &offset=100
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.w3w.ai/mantle/v1/developer/api?module=account\&action=addresstokennftinventory\&address=0x03ddc4b60d6bbf399a8397d73462060fdfb83476\&contractaddress=0x03ddc4b60d6bbf399a8397d73462060fdfb83476\&page=1\&offset=100\&apikey=YourApiKeyToken) :link:
> {% endtab %}

{% tab title="Monad Testnet" %}

```
```

{% 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 ERC-721 tokens inventory</td></tr><tr><td>contractaddress</td><td>the <code>string</code> representing the ERC-721 token contractaddress to check for inventory</td></tr><tr><td>page</td><td>the <code>integer</code> page number, if pagination is enabled</td></tr><tr><td>offset</td><td>he number of transactions displayed per page</td></tr></tbody></table>
{% endtab %}

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

```
{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "tokenID": "126569"
        },
        {
            "tokenID": "126581"
        },
        {
            "tokenID": "127934"
        },
        {
            "tokenID": "142938"
        },
        {
            "tokenID": "239749"
        }
    ]
}
```

{% 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/tokens.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.