Get balance for a single address
Returns the balance of a given address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&tag=latest
&apikey=YourApiKeyToken
Request query parameters
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": "40891626854930000000000"
}
Get balance history for a single address
Returns the balance history of a given address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=balancehistory
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&starttimestamp=1656010239
&endtimestamp=1656010242
&offset=0
&limit=10
&sort=desc
&apikey=YourApiKeyToken
Request query parameters
the string representing the address to check for balance
the starting timestamp of interval, default value is null
the ending timestamp of interval, default value is null
skips the offset records before beginning to return the records, default value is 0
the number of records displayed per page, default value is 10000
the sorting preference, use asc to sort by ascending and desc to sort by descending, default value is asc
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "123",
"timeStamp": "1656020241",
"balance": "40126832366005123220000",
"balanceChange": "-764794488924876780000"
},
{
"blockNumber": "1",
"timeStamp": "1656010239",
"balance": "40891626854930000000000",
"balanceChange": "40891626854930000000000"
}
]
}
Get balance for multiple addresses in a single call
Returns the balance of the accounts from a list of addresses (maximum of 20 addresses per call).
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=balancemulti
&address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
&tag=latest
&apikey=YourApiKeyToken
Request query parameters
the strings representing the addresses to check for balance, separated by ,
the string pre-defined block parameter, either earliest, pending or latest
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
"balance": "40891626854930000000000"
},
{
"account": "0x63a9975ba31b0b9626b34300f7f627147df1f526",
"balance": "332567136222827062478"
},
{
"account": "0x198ef1ec325a96cc354c7266a038be8b5c558f67",
"balance": "0"
}
]
}
Get various account counters for a single address
Returns the account counters of a given address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=counters
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&tag=latest
&apikey=YourApiKeyToken
Request query parameters
the string representing the address to check for counters
the string pre-defined block parameter, either earliest, pending or latest
Sample response
{
"status": "1",
"message": "OK",
"result": {
"gasUsed": "4328265",
"transactionCount": {
"total": "900",
"incoming": "300",
"outgoing": "600"
},
"internalTransactionCount": {
"total": "1500",
"incoming": "700",
"outgoing": "800"
},
"tokenTransferCount": {
"total": "600",
"incoming": "200",
"outgoing": "400"
},
"producedBlockCount": "20",
"balanceChangesCount": "1200"
}
}
Get the total number of wallet addresses
Returns the total number of wallet addresses.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=gettotalwalletcount
&apikey=YourApiKeyToken
Sample response
{
"status": "1",
"message": "OK",
"result": "264567"
}
Get a list of 'normal' transactions by address
Returns the list of transactions performed by an address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=txlist
&address=0x28c6c06298d514db089934071355e5743bf21d60
&startblock=18541319
&endblock=18541319
&direction=in
&offset=10
&limit=10
&sort=asc
&apikey=YourApiKeyToken
Request query parameters
the string representing the address to check for normal transactions
the integer block number to start searching for transactions, default value is 0
the integer block number to stop searching for transactions, default value is 1000000000
direction option in for incoming transactions, out for outgoing, default value is all
skips the offset records before beginning to return the records, default value is 0
the number of records displayed per page, default value is 10000
the sorting preference, use asc to sort by ascending and desc to sort by descending, default value is asc
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"blockHash":"0x7d81377abfa115565cd537df1a5873fca616f531292ff000d24083265590aa06",
"blockNumber":"18541319",
"confirmations":"0",
"contractAddress":null,
"cumulativeGasUsed":"6769329",
"decoded":{
"method_call":"transfer(address _to, uint256 _value)",
"method_id":"0xa9059cbb",
"parameters":[
{
"name":"_to",
"type":"address",
"value":"0xdc58e6ad03fa3c21c2f68105af3954411d17ad8e"
},
{
"name":"_value",
"type":"uint256",
"value":"109246000000000000000"
}
]
},
"from":"0x28c6c06298d514db089934071355e5743bf21d60",
"functionName":"transfer(address _to, uint256 _value)",
"gas":"207128",
"gasPrice":"34235322240",
"gasUsed":"44422",
"hash":"0x4a92f997fa11357e7dbd07161844d3518bb1bdc980ba6cbc571fe0bf69dc07e3","input":"0xa9059cbb000000000000000000000000dc58e6ad03fa3c21c2f68105af3954411d17ad8e000000000000000000000000000000000000000000000005ec17c2309c530000",
"isError":"0",
"methodId":"0xa9059cbb",
"nonce":"8181556",
"receiptStatus":"1",
"revertReason":null,
"timeStamp":"1699616555",
"to":"0x767fe9edc9e0df98e07454847909b5e959d7ca0e",
"transactionIndex":"48",
"type":"2",
"value":"0"
}
]
}
Get a list of 'internal' transactions by address
Returns the list of internal transactions performed by an address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=txlistinternal
&address=0xe6f0742f01fbab90d76e87ac291be94ff2103363
&startblock=0
&endblock=99999999
&direction=all
&offset=10
&limit=10
&sort=asc
&apikey=YourApiKeyToken
Request query parameters
the string representing the address to check for internal transactions
the integer block number to start searching for transactions, default value is 0
the integer block number to stop searching for transactions, default value is 1000000000
direction option in for incoming transactions, out for outgoing, default value is all
skips the offset records before beginning to return the records, default value is 0
the number of records displayed per page, default value is 10000
the sorting preference, use asc to sort by ascending and desc to sort by descending, default value is asc
Sample response
{
"status":"1",
"message":"OK",
"result": [
{
"blockNumber": "2535368",
"timeStamp": "1477837690",
"hash": "0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
"index": "0",
"transactionIndex": "0",
"from": "0x20d42f2e99a421147acf198d775395cac2e8b03d",
"to": null,
"value": "0",
"contractAddress": "0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"input": "0x",
"type": "create",
"callType": null,
"gas": "254791",
"gasUsed": "46750",
"traceId": "0",
"isError": "0",
"errCode": null
},
{
"blockNumber": "2535479",
"timeStamp": "1477839134",
"hash": "0x1a50f1dc0bc912745f7d09b988669f71d199719e2fb7592c2074ede9578032d0",
"index": "0",
"transactionIndex": "0",
"from": "0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"to": "0x20d42f2e99a421147acf198d775395cac2e8b03d",
"value": "100000000000000000",
"contractAddress": null,
"input": "0x",
"type": "call",
"callType": "call",
"gas": "235231",
"gasUsed": "0",
"traceId": "0",
"isError": "0",
"errCode": null
}
]
}
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.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=tokentx
&contractaddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
&address=0x4e83362442b8d1bec281594cea3050c8eb01311c
&startblock=0
&endblock=27025780
&offset=0
&limit=10
&sort=asc
&apikey=YourApiKeyToken
Usage:
ERC-20 transfers from an address, specify the address parameter
ERC-20 transfers from a contract address, specify the contractaddress parameter
ERC-20 transfers from an address filtered by a token contract, specify both address and contractaddress parameters
Request query parameters
the string representing the token address
the string representing the contract address
the integer block number to start searching for transactions, default value is 0
the integer block number to stop searching for transactions, default value is 1000000000
skips the offset records before beginning to return the records, default value is 0
the number of records displayed per page, default value is 10000
the sorting preference, use asc to sort by ascending and desc to sort by descending, default value is asc
Sample response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"4730207",
"index": 0,
"timeStamp":"1513240363",
"hash":"0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4",
"nonce":"406",
"blockHash":"0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37",
"from":"0x642ae78fafbb8032da552d619ad43f1d81e4dd7c",
"contractAddress":"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"to":"0x4e83362442b8d1bec281594cea3050c8eb01311c",
"value":"5901522149285533025181",
"tokenName":"Maker",
"tokenSymbol":"MKR",
"tokenDecimal":"18",
"tokenPriceUSD": "1123.78",
"transactionIndex":"81",
"gas":"940000",
"gasPrice":"32010000000",
"gasUsed":"77759",
"cumulativeGasUsed":"2523379",
"input":"deprecated",
"confirmations":"7968350",
"methodId": "0xa9059cbb",
"functionName": "transfer(address _to, uint256 _value)"
},
{
"blockNumber":"4764973",
"index": 0,
"timeStamp":"1513764636",
"hash":"0x9c82e89b7f6a4405d11c361adb6d808d27bcd9db3b04b3fb3bc05d182bbc5d6f",
"nonce":"428",
"blockHash":"0x87a4d04a6d8fce7a149e9dc528b88dc0c781a87456910c42984bdc15930a2cac",
"from":"0x4e83362442b8d1bec281594cea3050c8eb01311c",
"contractAddress":"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"to":"0x69076e44a9c70a67d5b79d95795aba299083c275",
"value":"132520488141080",
"tokenName":"Maker",
"tokenSymbol":"MKR",
"tokenDecimal":"18",
"tokenPriceUSD": "1123.78",
"transactionIndex":"167",
"gas":"940000",
"gasPrice":"35828000000",
"gasUsed":"127593",
"cumulativeGasUsed":"6315818",
"input":"deprecated",
"confirmations":"7933584",
"methodId": "0xa9059cbb",
"functionName": "transfer(address _to, uint256 _value)"
}
]
}
Get list of blocks mined by address
Returns the list of blocks mined by an address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=getminedblocks
&address=0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b
&offset=0
&limit=10
&apikey=YourApiKeyToken
Request query parameters
the string representing the address
skips the offset records before beginning to return the records, default value is 0
the number of records displayed per page, default value is 10000
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "3462296",
"timeStamp": "1491118514",
"blockReward": "5194770940000000000"
},
{
"blockNumber": "2691400",
"timeStamp": "1480072029",
"blockReward": "5086562212310617100"
}
]
}
Get KYC level, activation status and reputation by address
Returns information about the KYC level, activation status, and reputation (trust score) of an address.
Sample request
https://api.main.atgraphite.com/api
?module=account
&action=kyc
&address=0xc3a8119e77803a306bcf250db89d9eed89842af3
&tag=latest
&apikey=YourApiKeyToken
Request query parameters
the string representing the address
the string pre-defined block parameter, either block number or latest, default value is latest
Sample response
{
"status": "1",
"message": "OK",
"result": {
"activated": true,
"activationBlockNumber": "2",
"kycLastUpdateBlockNumber": null,
"kycLevel": "0",
"reputation": "205"
}
}
