Get CELO Balance for a Single Address
Returns the CELO balance of a given address.
Copy https://api.celoscan.io/api
?module=account
&action=balance
&address=0xd9df8d890d05295330ae4e8b0c70e079f52ee47a
&tag=latest
&apikey=YourApiKeyToken Try this endpoint in your browser
Request Response
Query Parameters
the string representing the address to check for balance
the string pre-defined block parameter, either earliest, pending or latest
Sample response
Copy {
"status": "1",
"message": "OK",
"result": "9999999001000000000000"
} Get CELO Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
Copy https://api.celoscan.io/api
?module=account
&action=balancemulti
&address=0xd9df8d890d05295330ae4e8b0c70e079f52ee47a,0x2753e4fa98e628626ce7139996e445464702e3c3,0xc165409ae8885d1b80f200544118dfeee6dc3550
&tag=latest
&apikey=YourApiKeyToken Request Response
Query Parameters
the strings representing the addresses to check for balance, separated by ,
up to 20 addresses per call
the integer pre-defined block parameter, either earliest, pending or latest
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"account": "0xd9df8d890d05295330ae4e8b0c70e079f52ee47a",
"balance": "9999999001000000000000"
},
{
"account": "0x2753e4fa98e628626ce7139996e445464702e3c3",
"balance": "1522640000000000"
},
{
"account": "0xc165409ae8885d1b80f200544118dfeee6dc3550",
"balance": "1522640000000000"
}
]
} Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
Copy https://api.celoscan.io/api
?module=account
&action=txlist
&address=0xd9df8d890d05295330ae4e8b0c70e079f52ee47a
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken Request Response
Query Parameters
the string representing the addresses to check for balance
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the integer page number, if pagination is enabled
the number of transactions displayed per page
the sorting preference, use asc to sort by ascending and desc to sort by descendin Tip: Specify a smaller startblock and endblock range for faster search results.
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "14250333",
"timeStamp": "1658919481",
"hash": "0x044431cc538430a5117365a37ec59f200eba6734d6d59e3992f1585272090402",
"nonce": "208506",
"blockHash": "0x73ec754a912fcf81674c45369cccac5c38b621b356fb9a942215aea682067f90",
"transactionIndex": "1",
"from": "0xf6436829cf96ea0f8bc49d300c536fcc4f84c4ed",
"to": "0xd9df8d890d05295330ae4e8b0c70e079f52ee47a",
"value": "9999999000000000000000",
"gas": "21004",
"gasPrice": "500000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "596941",
"gasUsed": "21000",
"confirmations": "6149302",
"methodId": "0x",
"functionName": ""
}
]
} Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
Copy https://api.celoscan.io/api
?module=account
&action=txlistinternal
&address=0x4F93Fa058b03953C851eFaA2e4FC5C34afDFAb84
&startblock=20399628
&endblock=20399648
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken Request Response
Query Parameters
the string representing the addresses to check for balance
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the integer page number, if pagination is enabled
the number of transactions displayed per page
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "20399628",
"timeStamp": "1689666437",
"hash": "0xdab54b2cee04e99ffdd03bfff0ed70d7367e08da27e8e11e0b63ea7e923b4143",
"from": "0x4f93fa058b03953c851efaa2e4fc5c34afdfab84",
"to": "0x581c1f38f73e15490192193a9496c7074d41412c",
"value": "6988465000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "20399628",
"timeStamp": "1689666437",
"hash": "0xdab54b2cee04e99ffdd03bfff0ed70d7367e08da27e8e11e0b63ea7e923b4143",
"from": "0x4f93fa058b03953c851efaa2e4fc5c34afdfab84",
"to": "0x581c1f38f73e15490192193a9496c7074d41412c",
"value": "512705000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "20399637",
"timeStamp": "1689666482",
"hash": "0xe2fa0dabfba04cb0a4c1570a36fd175aa20a807fea4f2d75ef106596a425e4ba",
"from": "0x4f93fa058b03953c851efaa2e4fc5c34afdfab84",
"to": "0xd09248e036ad0cb12042f48da21a5a4a6a83d02d",
"value": "6263225000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"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.
Copy https://api.celoscan.io/api
?module=account
&action=txlistinternal
&txhash=0xe2fa0dabfba04cb0a4c1570a36fd175aa20a807fea4f2d75ef106596a425e4ba
&apikey=YourApiKeyToken Request Response
Query Parameters
the string representing the transaction hash to check for internal transactions
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "20399637",
"timeStamp": "1689666482",
"from": "0x4f93fa058b03953c851efaa2e4fc5c34afdfab84",
"to": "0xd09248e036ad0cb12042f48da21a5a4a6a83d02d",
"value": "6263225000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "20399637",
"timeStamp": "1689666482",
"from": "0x4f93fa058b03953c851efaa2e4fc5c34afdfab84",
"to": "0xd09248e036ad0cb12042f48da21a5a4a6a83d02d",
"value": "588680000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"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.
Copy https://api.celoscan.io/api
?module=account
&action=txlistinternal
&startblock=13481773
&endblock=13491773
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken Request Response
Query Parameters
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the integer page number, if pagination is enabled
the number of transactions displayed per page
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "13481777",
"timeStamp": "1654988074",
"hash": "0x68a6dee16cca38b7dfbe8ee04d476a3ad4e90e19ffc9406a4b749720145bb909",
"from": "0xbdb92ca42559adc5adc20a1e4985dc7c476483be",
"to": "",
"value": "0",
"contractAddress": "0x22c0c52f2d72225a7fac064b40939ff9082cae71",
"input": "",
"type": "create",
"gas": "929561",
"gasUsed": "541505",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "13481814",
"timeStamp": "1654988259",
"hash": "0xa7dc1c8efcf810a747477c47b64ff97439378f9847b87afd962f8f1a734267a0",
"from": "0xbdb92ca42559adc5adc20a1e4985dc7c476483be",
"to": "",
"value": "0",
"contractAddress": "0xc59803642e99e2a7c46184b4c8fc8f14c3845561",
"input": "",
"type": "create",
"gas": "929561",
"gasUsed": "541505",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "13481825",
"timeStamp": "1654988314",
"hash": "0x6f7e1b10e7754b961ce8a1cd6f641e061b41fba4bf149864909404c00c892fdd",
"from": "0x62a25e867f7853b362bbda8c0f400466a8063880",
"to": "",
"value": "0",
"contractAddress": "0x8e9c0963d6799c0a2017315acc35711db7ae2c0f",
"input": "",
"type": "create2",
"gas": "14712153",
"gasUsed": "4218",
"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.
Copy https://api.celoscan.io/api
?module=account
&action=tokentx
&contractaddress=0x471EcE3750Da237f93B8E339c536989b8978a438
&address=0xd9df8d890d05295330ae4e8b0c70e079f52ee47a
&page=1
&offset=100
&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.
Request Response
Query Parameters
the string representing the address to check for balance
the string representing the token contract address to check for balance
the integer page number, if pagination is enabled
the number of transactions displayed per page
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "15645248",
"timeStamp": "1665894233",
"hash": "0x35a864ee2dab777157d8fc0b76ae896a628f919c2091294fdc637490f6593499",
"nonce": "38",
"blockHash": "0xbaf365aeaa1ffe2aca42226407a16044ec7f60eb917f1f931a9b450513271516",
"from": "0x1c824dfa97d1f2fbc525f428456d5e7ca27ceb98",
"contractAddress": "0x471ece3750da237f93b8e339c536989b8978a438",
"to": "0xd9df8d890d05295330ae4e8b0c70e079f52ee47a",
"value": "1000000000000",
"tokenName": "Celo native asset",
"tokenSymbol": "CELO",
"tokenDecimal": "18",
"transactionIndex": "2",
"gas": "100000",
"gasPrice": "500000000",
"gasUsed": "40416",
"cumulativeGasUsed": "607846",
"input": "deprecated",
"confirmations": "4754480"
}
]
} 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.
Copy https://api.celoscan.io/api
?module=account
&action=tokennfttx
&contractaddress=0xE33519C400B8F040E73aeDa2f45DfDD4634A7cA0
&address=0xb6350e4e9d5e107ba47c4efafe8544c34b0a8efd
&page=1
&offset=100
&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.
Request Response
Query Parameters
the string representing the address to check for balance
the string representing the token contract address to check for balance
the integer page number, if pagination is enabled
the number of transactions displayed per page
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "20387377",
"timeStamp": "1689605181",
"hash": "0xa8635c84a2be8b7c65755bc9fb5f273a10bcf0162bd999bab2f4316888f34e91",
"nonce": "1",
"blockHash": "0x5685b91cd75de523cbf14a5a7559a1c8a3ab7f6823852b3cf39a4dc84b2bd8e5",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0xe33519c400b8f040e73aeda2f45dfdd4634a7ca0",
"to": "0xb6350e4e9d5e107ba47c4efafe8544c34b0a8efd",
"tokenID": "5001347",
"tokenName": "Merkly ONFT",
"tokenSymbol": "MERK",
"tokenDecimal": "0",
"transactionIndex": "5",
"gas": "94559",
"gasPrice": "25000000000",
"gasUsed": "72738",
"cumulativeGasUsed": "954679",
"input": "deprecated",
"confirmations": "12370"
},
{
"blockNumber": "20387384",
"timeStamp": "1689605216",
"hash": "0xd9e11183e3284822df9b245bcf2053ff05d328d05aeb577f40bd6411338a9502",
"nonce": "2",
"blockHash": "0x0b2a5b484f307625923ab790fbcb9257c0d472b39ffea284564fb290f34929b1",
"from": "0xb6350e4e9d5e107ba47c4efafe8544c34b0a8efd",
"contractAddress": "0xe33519c400b8f040e73aeda2f45dfdd4634a7ca0",
"to": "0xe33519c400b8f040e73aeda2f45dfdd4634a7ca0",
"tokenID": "5001347",
"tokenName": "Merkly ONFT",
"tokenSymbol": "MERK",
"tokenDecimal": "0",
"transactionIndex": "10",
"gas": "217543",
"gasPrice": "25000000000",
"gasUsed": "156707",
"cumulativeGasUsed": "1538093",
"input": "deprecated",
"confirmations": "12363"
}
]
} 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.
Copy https://api.celoscan.io/api
?module=account
&action=token1155tx
&contractaddress=0x21115c266fa15ae8827838c4ed8b824bd6bf381f
&address=0x3a42f1dcc218b0ee48966954208c9c4acbc04d89
&page=1
&offset=100
&startblock=0
&endblock=99999999
&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.
Request Response
Query Parameters
the string representing the address to check for balance
the string representing the token contract address to check for balance
the integer page number, if pagination is enabled
the number of transactions displayed per page
the integer block number to start searching for transactions
the integer block number to stop searching for transactions
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
Copy {
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"20878516",
"timeStamp":"1692061046",
"hash":"0x040bc780d061e2ea7650163c9038a4c2d54573ea94369ed10745e7e3ea873ef2",
"nonce":"3",
"blockHash":"0x3faefef5c998c6b8cf428e43e24fddeb4eda50f8e02d0e8d34230054e89b9b76",
"transactionIndex":"4",
"gas":"134371",
"gasPrice":"25000000000",
"gasUsed":"102167",
"cumulativeGasUsed":"488676",
"input":"deprecated",
"contractAddress":"0x21115c266fa15ae8827838c4ed8b824bd6bf381f",
"from":"0x0000000000000000000000000000000000000000",
"to":"0x3a42f1dcc218b0ee48966954208c9c4acbc04d89",
"tokenID":"1",
"tokenValue":"1",
"tokenName":"Celosapien Open Edition",
"tokenSymbol":"COE",
"confirmations":"4320"
}
]
} Get list of Blocks Mined by Address
Returns the list of blocks mined by an address.
Copy https://api.celoscan.io/api
?module=account
&action=getminedblocks
&address=0x66Be809e9ba5A6F57625b32506916db49a75D360
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken Request Response
Query Parameters
the string representing the address to check for balance
the string pre-defined block type, either blocks for canonical blocks or uncles for uncle blocks only
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
Copy {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "20399755",
"timeStamp": "1689667072",
"blockReward": "114110840623800420"
},
{
"blockNumber": "20399645",
"timeStamp": "1689666522",
"blockReward": "36725095000277241"
}
]
} 