查询区块交易列表 - ListBesuTransactions
功能介绍
查询区块交易列表,单次最多查询500笔,只支持云端管理实例使用
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/besu/instances/{instance_id}/chain/transactions
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID |
instance_id | 是 | String | 实例ID |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
block_height | 是 | String | 区块ID |
offset | 否 | Integer | 分页查询起始位置 |
limit | 否 | Integer | 每页返回的条目数量 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
count | Integer | 交易总数量 |
txs | BesuTxInfo object | 交易列表 |
参数 | 参数类型 | 描述 |
|---|---|---|
hash | String | 交易hash |
from | String | 目标地址 |
to | String | 源地址 |
block_height | Integer | 交易所属区块高度 |
contract_address | String | 合约地址 |
data | String | 交易数据 |
create_time | String | 交易创建时间 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 状态码 |
error_code | String | 错误码 |
error_msg | String | 错误信息 |
message | String | 错误详细信息 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 状态码 |
error_code | String | 错误码 |
error_msg | String | 错误信息 |
message | String | 错误详细信息 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 状态码 |
error_code | String | 错误码 |
error_msg | String | 错误信息 |
message | String | 错误详细信息 |
请求示例
无
响应示例
状态码:200
请求成功
{
"count" : 1,
"txs" : {
"hash" : "0xa029938c2d96fa2fea6d427fc9b496d0b5b1567fcf3d482d726aeaca6928fb37",
"from" : "0x8867c17e38a8bf8cefd755e5a469b5fdfcae859d",
"to" : null,
"block_height" : 0,
"contract_address" : "string",
"data" : "string",
"create_time" : "string"
}
} 状态码
状态码 | 描述 |
|---|---|
200 | 请求成功 |
400 | 请求参数校验不通过 |
401 | 鉴权失败 |
500 | 服务内部执行错误 |

