Comment on page
Accounts
Returns the BTTC balance of a given address.
https://api.bttcscan.com/api
?module=account
&action=balance
&address=0xb4aD1dAFDAc6968B03Ff008f1c50F0d587f76922
&apikey=YourApiKeyToken
Request
Response
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":"6606958364310279627486006"
}
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
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
tag | 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"
}
]
}
%20(9)%20(1)%20(1)%20(1)%20(8).png?alt=media)
Returns the historical BTTC balance of an address at a certain block height.
Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
📝
https://api.bttcscan.com/api
?module=account
&action=balancehistory
&address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7
&blockno=2000000
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
blockno | 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"
}
]
}
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.bttcscan.com/api
?module=account
&action=txlist
&address=0xb4aD1dAFDAc6968B03Ff008f1c50F0d587f76922
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | 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":"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":""
}
]
}
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.bttcscan.com/api
?module=account
&action=txlistinternal
&address=0xd656a56be995c29013069996a237c613938d6d3e
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | 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 resultsSample 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":""
}
]
}
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.bttcscan.com/api
?module=account
&action=txlistinternal
&txhash=0x3dffd1861148f6221afcd209fc07152a49a35bced03c5895426df919dee724b9
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
txhash | 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
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.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.bttcscan.com/api
?module=account
&action=txlistinternal
&startblock=22770674
&endblock=22780674
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | 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":""
}
]
}
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.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
addressparameter - BRC-20 transfers from a contract address, specify the
contract addressparameter - BRC-20 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | 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"
}
]
}
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
addressparameter - BRC-721 transfers from a contract address, specify the
contract addressparameter - BRC-721 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | 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"
}
]
}
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
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
blocktype | the string pre-defined block type, blocksfor canonical blocks |
page | the integer page number, if pagination is enabled |
offset | 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"
}
]
}
Last modified 4mo ago