Links

Block

APIs to obtain block related details

1. Get latest block list

url: /v2/latest-blocks?count=10,
method: GET,
params: {
},
successResponse: {
"code":0,
"msg":"SUCCESS",
"result":[
{
"block_hash":"63355f8e80...6c8108e4e56b264d2a",
"block_height":112,
"txs_root":"472af7d21a83156...75b4c0e0b1b4576531",
"bookkeepers":"AMvXn7U9...HyqNr&AL4CDqBikrj...ZAQf2fg1AC",
"consensus_data":"12156079575032856115",
"block_size":532,
"block_time":1522205080,
"tx_count":12
}
]
}
Url RequestField
Type
Description
count
int
number of latest blocks. (limited between 1 and 50)
ResponseField
Type
Description
block_hash
String
block hash
block_height
int
block height
txs_root
String
the merkleroot of all transactions in the block
bookkeepers
String
keepers of this block, divided by &
consensus_data
String
consensus data
block_size
int
size of this block, unit:bytes
block_time
int
UNIX time of this block
tx_count
int
the number of transactions in this block

2. Get block list by page

url:/v2/blocks?page_size=1&page_number=10,
method:GET,
successResponse:{
"code":0,
"msg":"SUCCESS",
"result":{
"records":[
{
"block_hash":"63355f8e80...6c8108e4e56b264d2a",
"block_height":112,
"txs_root":"472af7d21a83156...75b4c0e0b1b4576531",
"bookkeepers":"AMvXn7U9...HyqNr&AL4CDqBikrj...ZAQf2fg1AC",
"consensus_data":"12156079575032856115",
"block_size":532,
"block_time":1522205080,
"tx_count":12
}
],
"total":23449
}
}
Url RequestField
Type
Description
page_size
int
number of records in one page (The page size is limited between 1 and 20)
page_number
int
number of the page (At least 1 or greater)
ResponseField
Type
Description
total
int
total blocks
block_hash
String
block hash
block_height
int
block height
txs_root
String
the merkleroot of all transactions in the block
bookkeepers
String
keepers of this block, divided by &
consensus_data
String
consensus data
block_size
int
size of this block, unit:bytes
block_time
int
UNIX time of this block
tx_count
int
the number of transactions in this block

3. Get block detail by height or hash

url:/v2/blocks/{param}
method:GET
successResponse:
{
"code":0,
"msg":"SUCCESS",
"result":{
"block_hash":"63355f8e80...6c8108e4e56b264d2a",
"block_height":112,
"txs_root":"472af7d21a83156...75b4c0e0b1b4576531",
"bookkeepers":"AL4CDqBikr...Qf2fg1AC&AL...g1AC",
"consensus_data":"12156079575032856115",
"block_size":532,
"block_time":1522205080,
"tx_count":12,
"txs":[
{
"tx_hash":"000062c6fe4...9a1c33721",
"tx_type":209,
"tx_time":1522205080,
"confirm_flag":1
}
]
}
}
Url Field
Type
Description
param
String
block height or block hash
ResponseField
Type
Description
block_hash
String
block hash
block_height
int
block height
txs_root
String
the merkleroot of all transactions in the block
bookkeepers
String
keepers of this block, divided by &
consensus_data
String
consensus data
block_size
int
size of this block, unit:bytes
block_time
int
UNIX time of this block
tx_count
int
the number of transactions in this block
txs.tx_hash
String
transaction hash
txs.tx_type
int
transaction type (208/209/210)
txs.confirm_flag
int
transaction state on the blockchain, 1:succees 0:failure
txs.tx_time
int
UNIX time of the transaction

4. Get latest blocks

url:/v2/blocks/generate-time?count=10,
method:GET,
successResponse:{
"code":0,
"msg":"SUCCESS",
"result":[
{
"block_height":1,
"generate_time":6
},
{
"block_height":2,
"generate_time":1
}
]
}
RequestField
Type
Description
count
int
number of the latest blocks
ResponseField
Type
Description
block_height
int
block height
generate_time
int
time of block generation,unit:seconds