Accounts

Get balance for a single address

Returns the balance of a given address.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=balance
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &tag=latest
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address to check for balance
tag*	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

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=balancehistory
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &starttimestamp=1656010239
   &endtimestamp=1656010242
   &offset=0
   &limit=10
   &sort=desc
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address to check for balance
starttimestamp	the starting timestamp of interval, default value is null
endtimestamp	the ending timestamp of interval, default value is null
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000
sort	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

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=balancemulti
   &address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
   &tag=latest
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the strings representing the addresses to check for balance, separated by ,
tag*	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

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=counters
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &tag=latest
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address to check for counters
tag	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",
            "self": "0"
        },
        "internalTransactionCount": {
            "total": "1500",
            "incoming": "700",
            "outgoing": "800",
            "self": "0"
        },
        "tokenTransferCount": {
            "total": "600",
            "incoming": "200",
            "outgoing": "400",
            "self": "0"
        },
        "producedBlockCount": "20",
        "balanceChangesCount": "1200"
    } 
}

Get the total number of wallet addresses

Returns the total number of wallet addresses.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=gettotalwalletcount
   &apikey=YourApiKeyToken

cURL

Sample response

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

Get the number of wallets with a non-zero balance

Returns the number of wallets (contracts and EOA accounts) with a non-zero balance

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=getnonzerowalletcount
   &apikey=YourApiKeyToken

cURL

Sample response

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

Get a list of 'normal' transactions by address

Returns the list of transactions performed by an address.

Sample request

Plain

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

cURL

Request query parameters

Parameter	Description
address*	the string representing the address to check for normal transactions
startblock	the integer block number to start searching for transactions, default value is 0
endblock	the integer block number to stop searching for transactions, default value is 1000000000
direction	direction option in for incoming transactions, out for outgoing, self for the equal sender and receiver, default value is all
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000
sort	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

Plain

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

cURL

Request query parameters

Parameter	Description
address*	the string representing the address to check for internal transactions
startblock	the integer block number to start searching for transactions, default value is 0
endblock	the integer block number to stop searching for transactions, default value is 1000000000
direction	direction option in for incoming transactions, out for outgoing, self for the equal sender and receiver, default value is all
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000
sort	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

Plain

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

cURL

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

Parameter	Description
address**	the string representing the token address
contractaddress**	the string representing the contract address
startblock	the integer block number to start searching for transactions, default value is 0
endblock	the integer block number to stop searching for transactions, default value is 1000000000
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000
sort	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

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=getminedblocks
   &address=0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b
   &offset=0
   &limit=10
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address
offset	skips the offset records before beginning to return the records, default value is 0
limit	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

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=kyc
   &address=0xc3a8119e77803a306bcf250db89d9eed89842af3
   &tag=latest
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address
tag	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"
    }
}

Get volumes for a single address

Returns the total funds sent, received, and the spent fees for a given address.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=volumes
   &address=0x4642227a142d77b4b1b46ab38ca41be19263f8e8
   &starttimestamp=1734083783
   &endtimestamp=1734095612
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	the string representing the address
starttimestamp	the starting timestamp of interval, default value is null
endtimestamp	the ending timestamp of interval, default value is null

Sample response

{
    "status": "1",
    "message": "OK",
    "result": {
        "fee": "662285354000000000",
        "inputVolume": "100000000000000000000",
        "outputVolume": "10000000000000000"
    }
}

Get top accounts by balance

Returns a list of addresses of the top 10,000 accounts by native coin balance.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=account
   &action=topbalance
   &offset=0
   &limit=10
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000

Sample response

{
    "status": "1",
    "message": "OK",
    "result": {
        "accounts": [
            {
                "address": "0x0000000000000000000000000000000000001100",
                "balance": "333000000000000000000000000",
                "percentage": "33.300000",
                "transactionCount": "0"
            },
            {
                "address": "0x0000000000000000000000000000000000001110",
                "balance": "135000000000000000000000000",
                "percentage": "13.500000",
                "transactionCount": "0"
            },
            {
                "address": "0x0000000000000000000000000000000000001101",
                "balance": "100000000000000000000000000",
                "percentage": "10.000000",
                "transactionCount": "0"
            }
        ]
    }
}