Get CELO Balance for a Single Address
Returns the CELO balance of a given address.
https://api-alfajores.celoscan.io/api
?module=account
&action=balance
&address=0xfdd8bd58115ffbf04e47411c1d228ecc45e93075
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":"5200000000000000000"
}
Get CELO Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-alfajores.celoscan.io/api
?module=account
&action=balancemulti
&address=0x05ccfd7a8e3d523878fce2b532aa4e4326709b30,0x43c25991f0f037517d174b7e0ffd8c8ccc471c6b,0x05ccfd7a8e3d523878fce2b532aa4e4326709b30
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
| the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x05ccfd7a8e3d523878fce2b532aa4e4326709b30",
"balance":"69773154467226062981"
},
{
"account":"0x43c25991f0f037517d174b7e0ffd8c8ccc471c6b",
"balance":"745507385245450052880"
},
{
"account":"0x05ccfd7a8e3d523878fce2b532aa4e4326709b30",
"balance":"69773154467226062981"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-alfajores.celoscan.io/api
?module=account
&action=txlist
&address=0x05ccfD7A8e3D523878fCE2B532aA4E4326709b30
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| 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 |
💡 Tip: Specify a smaller startblock
and endblock
range for faster search results.
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"18275977",
"timeStamp":"1686754893",
"hash":"0xc5b1d4935c1a25ebff8cb4084b95c0ca0502e7b3738e640727b29f644422f0c8",
"nonce":"0",
"blockHash":"0x128f1e74d883e946cbbd8c948a78ace87b46d4b7341fd818ce0b4906884ce229",
"transactionIndex":"1",
"from":"0x05ccfd7a8e3d523878fce2b532aa4e4326709b30",
"to":"0xa6920dd986896d5433b4f388fcb705947a6af835",
"value":"0",
"gas":"58841",
"gasPrice":"25000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x095ea7b3000000000000000000000000108b0a8d2699f1b481ab0688a7ef71760cc172570000000000000000000000000000000000000000000000000000000000000000",
"contractAddress":"",
"cumulativeGasUsed":"147871",
"gasUsed":"24979",
"confirmations":"131994",
"methodId":"0x095ea7b3",
"functionName":"approve(address spender, uint256 amount)"
},
{
"blockNumber":"18275982",
"timeStamp":"1686754918",
"hash":"0x50d1176a0ac5d822ff77ffcb7659673d4cd83bb23cdb5be6ac0a98afe65c4e72",
"nonce":"1",
"blockHash":"0x6afc0db624c93d836f9ebcc196ef1e9cd9ba8b37fbaab7392e94b35647cd13bd",
"transactionIndex":"2",
"from":"0x05ccfd7a8e3d523878fce2b532aa4e4326709b30",
"to":"0x5db5637cf0db0c610c44d24835603865c1ca5d33",
"value":"1000000000000000000",
"gas":"3340759",
"gasPrice":"25000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x5678b0dc0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000071578d2733d236000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000021302055534443202b20313030303030303030303030303030303030302043454c4f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000140000000000000000000000000108b0a8d2699f1b481ab0688a7ef71760cc17257000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000a6920dd986896d5433b4f388fcb705947a6af83500000000000000000000000064aeed758b878d7023a361bbc7f11bcbad53494200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000de0b6b3a7640000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc914afffffffffffffffffffffffffffffffffffffffffffffffffffffffffffcc76e00000000000000000000000000000000000000000000000000000000000001f4",
"contractAddress":"",
"cumulativeGasUsed":"2421640",
"gasUsed":"2284481",
"confirmations":"131989",
"methodId":"0x5678b0dc",
"functionName":""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-alfajores.celoscan.io/api
?module=account
&action=txlistinternal
&address=0xfdd8bd58115ffbf04e47411c1d228ecc45e93075
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| 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 |
💡 Tip: Specify a smaller startblock
and endblock
range for faster search results
Sample Response
{"status":"1","message":"OK","result":[{"blockNumber":"515","timeStamp":"1594924348","hash":"0x863f4bac5e959602fadff091ccab805ba21acb831bf24c16a0400bbf37f33bf8","from":"0xfdd8bd58115ffbf04e47411c1d228ecc45e93075","to":"0xb9ff7ab50a2f0fd3e2fb2814b016ac90c91df98f","value":"0","contractAddress":"","input":"","type":"delegatecall","gas":"19642373","gasUsed":"45574","traceId":"0_1","isError":"0","errCode":""},{"blockNumber":"545","timeStamp":"1594924498","hash":"0x6299e194e0fd8476d655e6756026d6d69604b9d9f452b2735b1b8d6f73253015","from":"0xfdd8bd58115ffbf04e47411c1d228ecc45e93075","to":"0xb9ff7ab50a2f0fd3e2fb2814b016ac90c91df98f","value":"0","contractAddress":"","input":"","type":"delegatecall","gas":"19664236","gasUsed":"63872","traceId":"0_1","isError":"0","errCode":""}]}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
https://api-alfajores.celoscan.io/api
?module=account
&action=txlistinternal
&txhash=0xfacd88edd672ce7afe2599a989c685a620eb6d5936c42869560572f20df61344
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"5783806",
"timeStamp":"1635931593",
"from":"0xb58d05247d16b3f1bd6b59c52f7f61ffef02bec8",
"to":"0x8d86bc475bedcb08179c5e6a4d494ebd3b44ea8b",
"value":"1205470000000000",
"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.
📝 Note : This API endpoint returns a maximum of 10000 records only.
https://api-alfajores.celoscan.io/api
?module=account
&action=txlistinternal
&startblock=5783806
&endblock=5783906
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"5783806",
"timeStamp":"1635931593",
"hash":"0xfacd88edd672ce7afe2599a989c685a620eb6d5936c42869560572f20df61344",
"from":"0xb58d05247d16b3f1bd6b59c52f7f61ffef02bec8",
"to":"0x697faf50a997b9655047658bf1ffc0805689e053",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"170168",
"gasUsed":"107198",
"traceId":"0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"5783806",
"timeStamp":"1635931593",
"hash":"0xfacd88edd672ce7afe2599a989c685a620eb6d5936c42869560572f20df61344",
"from":"0xb58d05247d16b3f1bd6b59c52f7f61ffef02bec8",
"to":"0x8d86bc475bedcb08179c5e6a4d494ebd3b44ea8b",
"value":"1205470000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"0",
"traceId":"0_0",
"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-alfajores.celoscan.io/api
?module=account
&action=tokentx
&contractaddress=0x0eba4fce2891cfab21587ff4888763fbdc3af9f9
&address=0x90fb187b30fab67c44c4e6edf64078e4fc149787
&page=1
&offset=100
&startblock=0
&endblock=99999999
&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 🔗
Query Parameters
Parameter | Description |
---|
| 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"16577753",
"timeStamp":"1678257643",
"hash":"0x950e1a9be13c43b1c77977e98b884a77c027e82f0c9fed99e96db66187285a7b",
"nonce":"54",
"blockHash":"0xf915bf3cdf3bc8fb17af92bce25a81c4843a651882aab82f33c146d29d53d0d8",
"from":"0xab3e7de900375851d3959c389118af2bef499b98",
"contractAddress":"0x0eba4fce2891cfab21587ff4888763fbdc3af9f9",
"to":"0x90fb187b30fab67c44c4e6edf64078e4fc149787",
"value":"460117349000000000000",
"tokenName":"DebtToken USDC",
"tokenSymbol":"DeUSDC",
"tokenDecimal":"18",
"transactionIndex":"1",
"gas":"3115576",
"gasPrice":"25000000000",
"gasUsed":"2171161",
"cumulativeGasUsed":"2217196",
"input":"deprecated",
"confirmations":"1830282"
},
{
"blockNumber":"16582070",
"timeStamp":"1678279228",
"hash":"0x59cce5750dbd164dfda5a23b193031e7060bedb22a0c778590978c5d54a54dbc",
"nonce":"63",
"blockHash":"0x94187a058d49b3184bfa2a2acb46b48cd5c7bdd3174a9bfdf9e960a0dba33d7a",
"from":"0x8626fda12ff124d0cecd8465d3316312f1dbc342",
"contractAddress":"0x0eba4fce2891cfab21587ff4888763fbdc3af9f9",
"to":"0x90fb187b30fab67c44c4e6edf64078e4fc149787",
"value":"77810625000000000000",
"tokenName":"DebtToken USDC",
"tokenSymbol":"DeUSDC",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"3142929",
"gasPrice":"25000000000",
"gasUsed":"2168376",
"cumulativeGasUsed":"2168376",
"input":"deprecated",
"confirmations":"1825965"
}
]
}
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-alfajores.celoscan.io/api
?module=account
&action=tokennfttx
&contractaddress=0x3d79edaabc0eab6f08ed885c05fc0b014290d95a
&address=0x3aef949afef6b00fcf4b4993946cae330cecb2f4
&page=1
&offset=100
&startblock=0
&endblock=99999999
&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 🔗
Query Parameters
Parameter | Description |
---|
| 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"16584816",
"timeStamp":"1678292958",
"hash":"0xb5965bda27e3478c0139698454fd8c28120585392dc6193a0a9b3b5b1ed037bc",
"nonce":"117",
"blockHash":"0xbe3bcd484e37522425eb3aad12e901018264eb3a301caf3e01d8925cad480c1a",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x3d79edaabc0eab6f08ed885c05fc0b014290d95a",
"to":"0x3aef949afef6b00fcf4b4993946cae330cecb2f4",
"tokenID":"101",
"tokenName":"Uniswap V3 Positions NFT-V1",
"tokenSymbol":"UNI-V3-POS",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"3370325",
"gasPrice":"25000000000",
"gasUsed":"2306871",
"cumulativeGasUsed":"2306871",
"input":"deprecated",
"confirmations":"1823236"
},
{
"blockNumber":"16584827",
"timeStamp":"1678293013",
"hash":"0x161f800429c461a7b54c63355158b651097b880559e2b48d3a8e5a8f49b39a6d",
"nonce":"118",
"blockHash":"0xdeae3cf5ebd1d2896052119f2f84b747ead43b8f4f563e7fb6c77131d214e861",
"from":"0x3aef949afef6b00fcf4b4993946cae330cecb2f4",
"contractAddress":"0x3d79edaabc0eab6f08ed885c05fc0b014290d95a",
"to":"0x0000000000000000000000000000000000000000",
"tokenID":"101",
"tokenName":"Uniswap V3 Positions NFT-V1",
"tokenSymbol":"UNI-V3-POS",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"1725045",
"gasPrice":"25000000000",
"gasUsed":"1043588",
"cumulativeGasUsed":"1043588",
"input":"deprecated",
"confirmations":"1823225"
}
]
}
Get list of Blocks Mined by Address
Returns the list of blocks mined by an address.
https://api-alfajores.celoscan.io/api
?module=account
&action=getminedblocks
&address=0xf764ada197bbaba75cd819942b14872460880d3b
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"18408055",
"timeStamp":"1687418365",
"blockReward":"5962269000000000"
},
{
"blockNumber":"18407965",
"timeStamp":"1687417915",
"blockReward":"0"
}
]
}