Tokens

Compare With EtherScan

EndPoint	EtherScan	SocialScan
Get ERC20-Token TotalSupply by ContractAddress	✅	✅
Get ERC20-Token Account Balance for TokenContractAddress	✅	✅
Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo	✅	🛠️
Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo	✅	✅
Get Token Holder List by Contract Address	✅	✅
Get Token Info by ContractAddress	✅	✅
Get Address ERC20 Token Holding	✅	✅
Get Address ERC721 Token Holding	✅	✅
Get Address ERC1155 Token Holding	-	✅
Get Address ERC721 Token Inventory By Contract Address	✅	🛠️

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.

Mantle

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

Try this endpoint in your browser 🔗

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token

Response

Sample response

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

📈 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

Get ERC20-Token Account Balance for TokenContractAddress

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

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for token balance

Response

Sample response

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

📈 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

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]

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for token balance
blockno	the integer block number to check total supply for eg. 8000000

Response

Sample response

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

📈 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

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.

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

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"
        }
    ]
}

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.

Mantle

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

Try this endpoint in your browser 🔗

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20/ERC-721 token to retrieve token info

Response

Sample response

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

Get Address ERC20 Token Holding

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

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

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to get ERC-20 tokens holding
page	the integer page number, if pagination is enabled
offset	he number of transactions displayed per page

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"
        }
    ]
}

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.

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to get ERC-1155 tokens holding
page	the integer page number, if pagination is enabled
offset	he number of transactions displayed per page

Response

Sample response

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

Get Address ERC1155 Token Holding

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

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 🔗

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to get ERC-1155 tokens holding
page	the integer page number, if pagination is enabled
offset	he number of transactions displayed per page

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"
        }
    ]
}

Get Address ERC721 Token Inventory By Contract Address

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

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 🔗

Monad Testnet

Request

Query Parameters

Parameter	Description
address	the string representing the address to get ERC-721 tokens inventory
contractaddress	the string representing the ERC-721 token contractaddress to check for inventory
page	the integer page number, if pagination is enabled
offset	he number of transactions displayed per page

Response

Sample response

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