Get transaction status

POST

https://api.trait.tech/tx/status

Submit new transaction

The endpoint allows to checks the status of a previously submitted transaction.

Request

Body Params application/json

Request params for the endpoint `/tx/status`.

tx_hash

string

Tx Hash

required

Hash of the transaction.

>= 66 characters<= 66 characters

Match pattern:

^0x[0-9abcdefABCDEF]{64}$

Example

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.trait.tech/tx/status' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200OK

application/json

Successful Response

Body

Response schema for the endpoint `/tx/status`.

metadata

object (ResponseMetadata)

required

Metadata for the generated response.

request_context

object (ResponseBlockId)

required

For the endpoints with historical data: the last block, the data from which is included in the response. For the endpoints with blockchain state data: the block whose state is provided in the response. Request context remains the same for all data pages in the series for the initial request.

blockchain_head

object (ResponseBlockId)

required

The latest blockchain block currently available.

data

object (TxStatusInfo)

required

Information about current status of the transaction.

status_code

enum<string>

required

The stage of the processing of transaction by the blockchain.

Allowed values:

IN_TRANSACTION_POOLIN_BLOCKFINALISEDUNKNOWN

status_text

string

Status Text

required

Human-readable text with description of the current status of the transaction.

Example

{
  "metadata": {
    "request_context": {
      "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
      "block_index": 29702,
      "block_timestamp": 1727581488000
    },
    "blockchain_head": {
      "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
      "block_index": 29702,
      "block_timestamp": 1727581488000
    }
  },
  "data": {
    "status_code": "FINALISED",
    "status_text": "Transaction included into the blockchain"
  }
}

🟠422Parameter Error

Modified at 2024-11-21 18:59:09

Submit transaction