查询上链交易排队状态

应用平台方可调用此接口查看 AVATA 平台的当前链交易排队情况以及待处理的交易数量，辅助业务上链时间的选择决策；也可以指定 Operation ID 来查询对应交易的排队状态。

请求参数

Query 参数

operation_id

string

可选

操作 ID，是指用户在进行具体的NFT/MT/业务接口请求时，自定义的操作ID。注意：不支持创建链账户/批量创建链账户的操作 ID 查询。

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200successful operation

application/json

Body

data

object

正确返回值

可选

queue_total

integer

必需

当前队列中待处理交易总数

queue_request_time

string

必需

当前队列即将被处理交易的请求时间（UTC 时间）

queue_cost_time

integer

必需

当前队列中所有交易处理完预估时间（秒）

tx_queue_position

integer

可选

Operation ID 对应交易所处队列中的位置；若交易存在队列中，0 则表示正在重试

tx_request_time

string

可选

Operation ID 对应交易的请求时间（UTC 时间）

tx_cost_time

integer

可选

Operation ID 对应交易预估处理所需时间（秒）

tx_message

string

可选

Operation ID 对应交易排队描述信息

示例

{
  "data": {
    "queue_total": 0,
    "queue_request_time": "string",
    "queue_cost_time": 0,
    "tx_queue_position": 0,
    "tx_request_time": "string",
    "tx_cost_time": 0,
    "tx_message": "string"
  }
}

🟠400failed operation