Get BTTC Balance for a Single Address
Returns the BTTC balance of a given address.
https://api.bttcscan.com/api
?module=account
&action=balance
&address=0xb4aD1dAFDAc6968B03Ff008f1c50F0d587f76922
&apikey=YourApiKeyToken
Try this endpoint in your
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":"6606958364310279627486006"
}
Get BTTC Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api.bttcscan.com/api
?module=account
&action=balancemulti
&address=0x7c9ce891349f1344f6bd8d0194414ddcf1285d1b,0xb710d22a4c9bbf25c56541afc4906be052fcee96,0xb4ad1dafdac6968b03ff008f1c50f0d587f76922
&tag=latest
&apikey=YourApiKeyToken
Query Parameters
the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call
the string pre-defined block parameter, either earliest, pending or latest
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x7c9ce891349f1344f6bd8d0194414ddcf1285d1b",
"balance":"2718516917413798463704266"
},
{
"account":"0xb710d22a4c9bbf25c56541afc4906be052fcee96",
"balance":"3699999999999999000"
},
{
"account":"0xb4ad1dafdac6968b03ff008f1c50f0d587f76922",
"balance":"6606958364310279627486006"
}
]
}
Returns the historical BTTC balance of an address at a certain block height.
https://api.bttcscan.com/api
?module=account
&action=balancehistory
&address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7
&blockno=2000000
&apikey=YourApiKeyToken
Query Parameters
the string representing the address to check for balance
the integer block number to check balance for eg. 2000000
Sample Response
{
"status":"1",
"message":"OK-Missing/Invalid API Key, rate limit of 1/5sec applied",
"result":[
{
"account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1",
"balance":"37700000000000001"
},
{
"account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD",
"balance":"4999777740000000000"
},
{
"account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
"balance":"57443177693229716"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api.bttcscan.com/api
?module=account
&action=txlist
&address=0xb4aD1dAFDAc6968B03Ff008f1c50F0d587f76922
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"21471488",
"timeStamp":"1683455691",
"hash":"0xfe29dcd8454175ac6f62af97a56ae91a53c697785726351b2ad2fe17d18d781c",
"nonce":"6244",
"blockHash":"0x562bd52f273b362199f8752ef6d0a73aab901720ea3473298b048ed0041aeafb",
"transactionIndex":"0",
"from":"0xb6ac943bb1f3beb33e92b9819bc81557d4f92ece",
"to":"0xb4ad1dafdac6968b03ff008f1c50f0d587f76922",
"value":"10000000000000000000000000",
"gas":"21000",
"gasPrice":"500000000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"21000",
"gasUsed":"21000",
"confirmations":"1310081",
"methodId":"0x",
"functionName":""
},
{
"blockNumber":"21474636",
"timeStamp":"1683462183",
"hash":"0xacae738a9607e6924fd49564a7616195db0e45863790b608ee39e497207002d1",
"nonce":"0",
"blockHash":"0xffdd6ed8f2d0b10b4540226a7048a26313355eaa6f9d6f6c0f2daaf3769e9379",
"transactionIndex":"0",
"from":"0xb4ad1dafdac6968b03ff008f1c50f0d587f76922",
"to":"0xad2e4af437b5d9e6f905548bf8202a6d45926559",
"value":"0",
"gas":"339126",
"gasPrice":"500000000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0xaf73295c00000000000000000000000000000000000000000000000000000000000007d00000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000ad8a2ef02589b54d73e37a9f5bb407c19bf6cba0000000000000000000000000be46ee69b268e6415915729f428806381d3dc420000000000000000000000006986319c50e0c9244798dccbb3bc8b1681c7590c00000000000000000000000002cd43a7e8fc2e54f75f4e5d764431578b6169fe0000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000009888221fe6b5a2ad4ce7266c7826d2ad74d40ccf000000000000000000000000e1da8a0a7e91903a4f41cc6d388db5ca4917e7840000000000000000000000008d193c6efa90bcff940a98785d1ce9d093d3dc8a000000000000000000000000252cd063341a1a47933086b93f85417c09c54aec",
"contractAddress":"",
"cumulativeGasUsed":"296881",
"gasUsed":"296881",
"confirmations":"1306933",
"methodId":"0xaf73295c",
"functionName":""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api.bttcscan.com/api
?module=account
&action=txlistinternal
&address=0xd656a56be995c29013069996a237c613938d6d3e
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22514345",
"timeStamp":"1685607083",
"hash":"0x41cfbfbf55d55d0c644c325747e786965730f0b85248ec640b88a2075e72c3e0",
"from":"0xd656a56be995c29013069996a237c613938d6d3e",
"to":"0x5649b4dd00780e99bab7abb4a3d581ea1aeb23d0",
"value":"107000000000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"1727007",
"gasUsed":"106962",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22514345",
"timeStamp":"1685607083",
"hash":"0x41cfbfbf55d55d0c644c325747e786965730f0b85248ec640b88a2075e72c3e0",
"from":"0x5649b4dd00780e99bab7abb4a3d581ea1aeb23d0",
"to":"0xd656a56be995c29013069996a237c613938d6d3e",
"value":"3218232478564098866235821",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"1595236",
"gasUsed":"55",
"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.bttcscan.com/api
?module=account
&action=txlistinternal
&txhash=0x3dffd1861148f6221afcd209fc07152a49a35bced03c5895426df919dee724b9
&apikey=YourApiKeyToken
Query Parameters
the string representing the transaction hash to check for internal transactions
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22780674",
"timeStamp":"1686156533",
"from":"0xd656a56be995c29013069996a237c613938d6d3e",
"to":"0xeae47c5d99f7b31165a7f0c5f7e0d6afa25cfd55",
"value":"505958345960761169917617359",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2603478",
"gasUsed":"132198",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22780674",
"timeStamp":"1686156533",
"from":"0xeae47c5d99f7b31165a7f0c5f7e0d6afa25cfd55",
"to":"0x8d193c6efa90bcff940a98785d1ce9d093d3dc8a",
"value":"49357853014468553348687690",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2545621",
"gasUsed":"24002",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22780674",
"timeStamp":"1686156533",
"from":"0xeae47c5d99f7b31165a7f0c5f7e0d6afa25cfd55",
"to":"0xd656a56be995c29013069996a237c613938d6d3e",
"value":"456600492946292616568929669",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2433170",
"gasUsed":"55",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22780674",
"timeStamp":"1686156533",
"from":"0x23181f21dea5936e24163ffaba4ea3b316b57f3c",
"to":"0x0c759476b4e74614d30e1f667455a4e1f2da8acb",
"value":"49501742651483955031005029",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"95",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22780674",
"timeStamp":"1686156533",
"from":"0x0c759476b4e74614d30e1f667455a4e1f2da8acb",
"to":"0xd656a56be995c29013069996a237c613938d6d3e",
"value":"49501742651483955031005029",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2211318",
"gasUsed":"55",
"isError":"0",
"errCode":""
}
]
}
22780674
Get "Internal Transactions" by Block Range
Returns the list of internal transactions performed within a block range, with optional pagination.
https://api.bttcscan.com/api
?module=account
&action=txlistinternal
&startblock=22770674
&endblock=22780674
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22770674",
"timeStamp":"1686135905",
"hash":"0x93d8396110fef9eb182ec18dfc61fe4fbee014bbdc7eb48eb48ab2b11f776fb2",
"from":"0xeae23c766a1b25481025a02b2d82a1db3fc130ca",
"to":"0x8dacffa7f69ce572992132697252e16254225d38",
"value":"43644292744370202469338344522",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"135786",
"gasUsed":"36446",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"22770674",
"timeStamp":"1686135905",
"hash":"0x93d8396110fef9eb182ec18dfc61fe4fbee014bbdc7eb48eb48ab2b11f776fb2",
"from":"0x8dacffa7f69ce572992132697252e16254225d38",
"to":"0x23181f21dea5936e24163ffaba4ea3b316b57f3c",
"value":"43644292744370202469338344522",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"107154",
"gasUsed":"6746",
"traceId":"0_1_1",
"isError":"0",
"errCode":""
}
]
}
Get a list of 'BRC-20 Token Transfer Events' by Address
Returns the list of BRC-20 tokens transferred by an address, with optional filtering by token contract.
https://api.bttcscan.com/api
?module=account
&action=tokentx
&contractaddress=0x3dcaab8665906f7c3b2ffcd5dda740f40d4b11bb
&address=0xb112f16b9d513620133474851c89cbe0e1957cfb
&page=1
&offset=5
&startblock=0
&endblock=999999999
&sort=asc
&apikey=YourApiKeyToken
Usage:
BRC-20 transfers from an address, specify the address parameter
BRC-20 transfers from a contract address, specify the contract address parameter
BRC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.
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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22721968",
"timeStamp":"1686035321",
"hash":"0xa8ac1c694520fefeb2afcd0fee9e2790dcf13e8d5361607e645dc5e235feab38",
"nonce":"118",
"blockHash":"0x62aec4b7a71539bc6b0b698b47ffb64b21912b3f07c8ee5fd9c66e26dee462c7",
"from":"0x27b5d476a61bbf0a754bf690610c7a60861b4848",
"contractAddress":"0x3dcaab8665906f7c3b2ffcd5dda740f40d4b11bb",
"to":"0xb112f16b9d513620133474851c89cbe0e1957cfb",
"value":"1011018396755109046147",
"tokenName":"Agave",
"tokenSymbol":"AG",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"384223",
"gasPrice":"500000000000000",
"gasUsed":"307732",
"cumulativeGasUsed":"307732",
"input":"deprecated",
"confirmations":"59781"
},
{
"blockNumber":"22721968",
"timeStamp":"1686035321",
"hash":"0xa8ac1c694520fefeb2afcd0fee9e2790dcf13e8d5361607e645dc5e235feab38",
"nonce":"118",
"blockHash":"0x62aec4b7a71539bc6b0b698b47ffb64b21912b3f07c8ee5fd9c66e26dee462c7",
"from":"0xb112f16b9d513620133474851c89cbe0e1957cfb",
"contractAddress":"0x3dcaab8665906f7c3b2ffcd5dda740f40d4b11bb",
"to":"0x5e1655e4e6c4f7a636dc85836e3d4035b602762a",
"value":"1011018396755109046147",
"tokenName":"Agave",
"tokenSymbol":"AG",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"384223",
"gasPrice":"500000000000000",
"gasUsed":"307732",
"cumulativeGasUsed":"307732",
"input":"deprecated",
"confirmations":"59781"
}
]
}
Get a list of 'BRC-721 Token Transfer Events' by Address
Returns the list of BRC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api.bttcscan.com/api
?module=account
&action=tokennfttx
&contractaddress=0xe2be972f6fcc7b8c38c073b492b355c3009c17ac
&address=0x65d46fa545ad86a139647351786d17bf46c173dc
&page=1
&offset=100
&startblock=0
&endblock=999999999
&sort=asc
&apikey=YourApiKeyToken
Usage:
BRC-721 transfers from an address, specify the address parameter
BRC-721 transfers from a contract address, specify the contract address parameter
BRC-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.
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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22520516",
"timeStamp":"1685619813",
"hash":"0x9bc413681b431f90e5eadd6dd889e62450e31e10c15146291dfca24678ee812c",
"nonce":"10",
"blockHash":"0x582032504e322ea3533bdd8d98c389c6d94e490de03331bb713bf0fd54ffdaf6",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xe2be972f6fcc7b8c38c073b492b355c3009c17ac",
"to":"0x65d46fa545ad86a139647351786d17bf46c173dc",
"tokenID":"69",
"tokenName":"Ships",
"tokenSymbol":"SHIP",
"tokenDecimal":"0",
"transactionIndex":"6",
"gas":"1157633",
"gasPrice":"500000000000000",
"gasUsed":"1079322",
"cumulativeGasUsed":"1357308",
"input":"deprecated",
"confirmations":"261274"
},
{
"blockNumber":"22523269",
"timeStamp":"1685625491",
"hash":"0xf7d3e76e87e09feec953ba9c629a49aa6c69a471920b5968491db4ccea65386e",
"nonce":"14",
"blockHash":"0xf77bdc7bb418bb3fe1a3953c827fd5bbf0a00809a98f9fdf4cacc550f8f02aaa",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xe2be972f6fcc7b8c38c073b492b355c3009c17ac",
"to":"0x65d46fa545ad86a139647351786d17bf46c173dc",
"tokenID":"87",
"tokenName":"Ships",
"tokenSymbol":"SHIP",
"tokenDecimal":"0",
"transactionIndex":"1",
"gas":"1124548",
"gasPrice":"500000000000000",
"gasUsed":"1045122",
"cumulativeGasUsed":"1257386",
"input":"deprecated",
"confirmations":"258521"
}
]
}
Get list of Blocks Validated by Address
Returns the list of blocks validated by an address.
https://api.bttcscan.com/api
?module=account
&action=getminedblocks
&address=0xd782c11d7f8be621bd726f9241acc0278ae2a4a2
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Query Parameters
the string representing the address to check for balance
the string pre-defined block type, blocksfor canonical blocks
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22781247",
"timeStamp":"1686157711",
"blockReward":"0"
},
{
"blockNumber":"22781246",
"timeStamp":"1686157709",
"blockReward":"0"
},
{
"blockNumber":"22781245",
"timeStamp":"1686157707",
"blockReward":"0"
},
{
"blockNumber":"22781244",
"timeStamp":"1686157705",
"blockReward":"0"
},
{
"blockNumber":"22781243",
"timeStamp":"1686157703",
"blockReward":"6300000000000000000"
}
]
}
