Get Mantle Balance for a Single Address
Returns the Mantle balance of a given address.
https://api.mantlescan.xyz/api
?module=account
&action=balance
&address=0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample response
{
"status":"1",
"message":"OK",
"result":"17000000612300000000000000"
}
Get Mantle Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api.mantlescan.xyz/api
?module=account
&action=balancemulti
&address=0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473,0xb9d507990c009ed1ee853a07b6a20c0925dd8a08,0x5c30940a4544ca845272fe97c4a27f2ed2cd7b64
&tag=latest
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473",
"balance": "17000000612300000000000000"
},
{
"account": "0xb9d507990c009ed1ee853a07b6a20c0925dd8a08",
"balance": "8121791000000000000000000"
},
{
"account": "0x5c30940a4544ca845272fe97c4a27f2ed2cd7b64",
"balance": "1714230920700848097534733"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api.mantlescan.xyz/api
?module=account
&action=txlist
&address=0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473
&startblock=0
&endblock=latest
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/5sec applied",
"result": [
{
"blockNumber": "5466677",
"timeStamp": "1694150095",
"hash": "0xc90ab3a78a9636d7a94ba7522d94ee280813d85f1631f6cc39f56037938d65a3",
"nonce": "50",
"blockHash": "0x92914baca1c2e78020d1d0b433e8b8f1f2e54cb53d05e617b1630b581357442a",
"transactionIndex": "0",
"from": "0xcc401649651a98ad9aede0146b89fa567c98bbb3",
"to": "0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473",
"value": "1000000000000000000",
"gas": "40993",
"gasPrice": "50000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "27329",
"gasUsed": "27329",
"confirmations": "56792285",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "11912886",
"timeStamp": "1696347875",
"hash": "0xdacbcdd5355270e61eeabc80ac6b57efd4640767d0cd17e7ca929db97ed2dee8",
"nonce": "2",
"blockHash": "0x27f091093fd4538282c6db1bafa0546b995f683201fd11cfc8d349acd0816d8d",
"transactionIndex": "0",
"from": "0x3dc5fcb0ad5835c6059112e51a75b57dba668eb8",
"to": "0x94fec56bbeceacc71c9e61623ace9f8e1b1cf473",
"value": "0",
"gas": "100703",
"gasPrice": "50000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x6a761202000000000000000000000000cc401649651a98ad9aede0146b89fa567c98bbb300000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c3684b61f4e2346745870e75c802563dbd4776a1d74d7145bdd7ecdbe6c05ce8b7316ff58a34712003eb71ccacbbbea5a4058d43743f117a44a7ac906b3dc2d071200000000000000000000000003dc5fcb0ad5835c6059112e51a75b57dba668eb8000000000000000000000000000000000000000000000000000000000000000001d8dfe9ab2826d78bddc5c9c4370a2ee1e602e2cdf250892dfce2b3a79751730c6481515bc8e015b4903b93d8c1edb52e3033eda028c052f00e8ca09f7294a9a41f0000000000000000000000000000000000000000000000000000000000",
"contractAddress": "",
"cumulativeGasUsed": "95333",
"gasUsed": "95333",
"confirmations": "50346076",
"methodId": "0x6a761202",
"functionName": ""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api.mantlescan.xyz/api
?module=account
&action=txlistinternal
&address=0xcc401649651a98ad9aede0146b89fa567c98bbb3
&startblock=0
&endblock=2702578
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "7906",
"timeStamp": "1689607402",
"hash": "0x0056d3522a9879adf20f04460674f63169edcacc2b669ad1eedc66be03cdc6f1",
"from": "0x233857eb7247beae44e3a32d638ea717430aa534",
"to": "0xcc401649651a98ad9aede0146b89fa567c98bbb3",
"value": "4000000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "0",
"gasUsed": "0",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "18911",
"timeStamp": "1689678105",
"hash": "0x17a08ed369e878a14e039faeac91f325200dbaaed6d1205c48207bf1ed433d34",
"from": "0x06a9770325ae485ecc5f2ecceaabdebb8350d1e1",
"to": "0xcc401649651a98ad9aede0146b89fa567c98bbb3",
"value": "100000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "0",
"gasUsed": "0",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
https://api.mantlescan.xyz/api
?module=account
&action=txlistinternal
&txhash=0x0056d3522a9879adf20f04460674f63169edcacc2b669ad1eedc66be03cdc6f1
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/5sec applied",
"result": [
{
"blockNumber": "7906",
"timeStamp": "1689607402",
"from": "0x233857eb7247beae44e3a32d638ea717430aa534",
"to": "0x70d91082eed8d95346f965268f06c80286b14a43",
"value": "4000000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "0",
"gasUsed": "0",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "7906",
"timeStamp": "1689607402",
"from": "0x233857eb7247beae44e3a32d638ea717430aa534",
"to": "0xcc401649651a98ad9aede0146b89fa567c98bbb3",
"value": "4000000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "0",
"gasUsed": "0",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "7906",
"timeStamp": "1689607402",
"from": "0x233857eb7247beae44e3a32d638ea717430aa534",
"to": "0x3e567ffd4a3d3f3af23672096ee1606d9957bf7f",
"value": "4000000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "0",
"gasUsed": "0",
"isError": "0",
"errCode": ""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get "Internal Transactions" by Block Range
Returns the list of internal transactions performed within a block range, with optional pagination.
https://api.mantlescan.xyz/api
?module=account
&action=txlistinternal
&startblock=1348
&endblock=13491
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "1418",
"timeStamp": "1688720148",
"hash": "0x0449d72a1810ff98cb8f9441ca87c2395be68afec3d62a42fbe0c69ca89bab41",
"from": "0xe07c17c4d62cb5e62f9702bfe02cd2bcd6605689",
"to": "",
"value": "0",
"contractAddress": "0x75820c45d42f39d5804030d9402f0a44c09e6823",
"input": "",
"type": "create2",
"gas": "170273",
"gasUsed": "170273",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "1419",
"timeStamp": "1688720156",
"hash": "0x08501364a8fde37d4e03365b5e9f2236ebec2596646786e9436c5fd901de98f3",
"from": "0xe07c17c4d62cb5e62f9702bfe02cd2bcd6605689",
"to": "",
"value": "0",
"contractAddress": "0x8a90cad33f00e7393e9321e3884fba9a43f6a970",
"input": "",
"type": "create2",
"gas": "755586",
"gasUsed": "755586",
"traceId": "0_1",
"isError": "0",
"errCode": ""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
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.
https://api.mantlescan.xyz/api
?module=account
&action=tokentx
&contractaddress=0xcDA86A272531e8640cD7F1a92c01839911B90bb0
&address=0xdFf45a3a21F00f7EdFb28816E8589c337421Cc91
&page=1
&offset=2
&startblock=0
&endblock=latest
&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.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "32370176",
"timeStamp": "1703663355",
"hash": "0x751ab9d4968ab506036722ce18e707bd2611282eb0d26b53363e139c21b38e86",
"nonce": "850674",
"blockHash": "0x45f5578bd27d8cc44494d799307ef249955f32ce4b073be0ea44f52290da2afc",
"from": "0x94d692afff21e045691971a20df4a9adb482ddf6",
"contractAddress": "0xcda86a272531e8640cd7f1a92c01839911b90bb0",
"to": "0xdff45a3a21f00f7edfb28816e8589c337421cc91",
"value": "10000000000000000",
"tokenName": "mETH",
"tokenSymbol": "mETH",
"tokenDecimal": "18",
"transactionIndex": "0",
"gas": "1000000",
"gasPrice": "100000000",
"gasUsed": "143992",
"cumulativeGasUsed": "143992",
"input": "deprecated",
"confirmations": "29890350"
},
{
"blockNumber": "32371773",
"timeStamp": "1703663380",
"hash": "0x461b4a0e3942efac6c7eb4a12c4509dc08b38f6a141ecbe0bf67222c37b17355",
"nonce": "850675",
"blockHash": "0xd6920ea1979a32ad4e2b6ae780ca04ede48d5762207e766a9fb54af75d990c37",
"from": "0x94d692afff21e045691971a20df4a9adb482ddf6",
"contractAddress": "0xcda86a272531e8640cd7f1a92c01839911b90bb0",
"to": "0xdff45a3a21f00f7edfb28816e8589c337421cc91",
"value": "1000000000000000000",
"tokenName": "mETH",
"tokenSymbol": "mETH",
"tokenDecimal": "18",
"transactionIndex": "0",
"gas": "1000000",
"gasPrice": "100000000",
"gasUsed": "126904",
"cumulativeGasUsed": "126904",
"input": "deprecated",
"confirmations": "29888753"
}
]
}
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.mantlescan.xyz/api
?module=account
&action=tokennfttx
&contractaddress=0x03dDC4b60D6bBf399A8397d73462060FdFb83476
&address=0x908A827126b28cFF255710979f5fE4fd7dD06013
&page=1
&offset=2
&startblock=0
&endblock=latest
&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.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "9895287",
"timeStamp": "1695686587",
"hash": "0x469d151d5f2aa15c4ccf26706773ddfb4c44ad582fda88a5c001532d1dff8d7f",
"nonce": "599653",
"blockHash": "0x41839dd23a8a42394dab39be4b105fb0397b2077f5f54999c8a5552b40ceee10",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x03ddc4b60d6bbf399a8397d73462060fdfb83476",
"to": "0x908a827126b28cff255710979f5fe4fd7dd06013",
"tokenID": "1679627",
"tokenName": "Pandra: CodeConqueror",
"tokenSymbol": "Pandra: CodeConqueror",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "1554980",
"gasPrice": "60000000",
"gasUsed": "189841",
"cumulativeGasUsed": "189841",
"input": "deprecated",
"confirmations": "52365712"
}
]
}
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.mantlescan.xyz/api
?module=account
&action=token1155tx
&contractaddress=0xD4A1F03c2c4981f7B84b9DE1AF936BF34a20Fa3a
&address=0x0000000000000000000000000000000000000000
&page=1
&offset=2
&startblock=0
&endblock=latest
&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.
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"13472395",
"timeStamp":"1634973285",
"hash":"0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d",
"nonce":"41",
"blockHash":"0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6",
"transactionIndex":"100",
"gas":"140000",
"gasPrice":"52898577246",
"gasUsed":"105030",
"cumulativeGasUsed":"11739203",
"input":"deprecated",
"contractAddress":"0x76be3b62873462d2142405439777e971754e8e77",
"from":"0x1e63326a84d2fa207bdfa856da9278a93deba418",
"to":"0x83f564d180b58ad9a02a449105568189ee7de8cb",
"tokenID":"10371",
"tokenValue":"1",
"tokenName":"parallel",
"tokenSymbol":"LL",
"confirmations":"1447769"
},
{
"blockNumber":"14049909",
"timeStamp":"1642781541",
"hash":"0x58353aab15a4b5a77333b87619edaa749c7f3cf8bb2263a1c0865d73bf1264bd",
"nonce":"4",
"blockHash":"0x1e88a63a4cb4086a747644b8ab7ff3434540930f3029eacb8add08b15974fdc9",
"transactionIndex":"114",
"gas":"253032",
"gasPrice":"225052869211",
"gasUsed":"184899",
"cumulativeGasUsed":"6855790",
"input":"deprecated",
"contractAddress":"0x76be3b62873462d2142405439777e971754e8e77",
"from":"0x83f564d180b58ad9a02a449105568189ee7de8cb",
"to":"0x80833dc92d326a81d0cb74982a8e6f1a3887f837",
"tokenID":"10371",
"tokenValue":"1",
"tokenName":"parallel",
"tokenSymbol":"LL",
"confirmations":"870255"
},
{
"blockNumber":"14067255",
"timeStamp":"1643012777",
"hash":"0x3222b5f71e577c2551e17701eaf39b308b976bbe6bf6ce3f8c20549527b9d6ae",
"nonce":"7",
"blockHash":"0x236cfed8b42fa6cb8956f6e7b889797047d9af0883066b1f3be8284beda16e17",
"transactionIndex":"172",
"gas":"56873",
"gasPrice":"69434775835",
"gasUsed":"52073",
"cumulativeGasUsed":"17181952",
"input":"deprecated",
"contractAddress":"0x76be3b62873462d2142405439777e971754e8e77",
"from":"0x9d48305f859a0006b57da25c80af62ecb8e5c6a2",
"to":"0x83f564d180b58ad9a02a449105568189ee7de8cb",
"tokenID":"10372",
"tokenValue":"1",
"tokenName":"parallel",
"tokenSymbol":"LL",
"confirmations":"852909"
}
]
}