Console

POSTtx

NEAR Mainnethttps://near-mainnet.nodit.io/

Returns a transaction's execution status and result, looked up by transaction hash and signer account.

tx is the method for checking the status of a transaction you have already sent. The tx_status and broadcast_tx_sync methods are not available. Specify tx_hash together with sender_account_id (the transaction signer); instead of tx_hash, you can also pass the signed transaction itself as signed_tx_base64. If wait_until is omitted, the call waits until the transaction reaches EXECUTED_OPTIMISTIC. With NONE, it returns the current status immediately without waiting. The node waits up to 10 seconds for the requested milestone and returns TIMEOUT_ERROR if it is not reached in time. If the node has no record of the transaction, it returns UNKNOWN_TRANSACTION.

Request Body
jsonrpcstringrequired
idstringrequired

Request ID. Any string; it is returned unchanged in the response.

methodstringrequired
tx_hashstringrequired

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

sender_account_idstringrequired

NEAR account ID. A human-readable name (e.g. wrap.near) or a 64-character hex implicit account ID.

wait_untilstring (enum)

The execution milestone to wait for before returning a response. Defaults to EXECUTED_OPTIMISTIC. Each value further down is a later milestone.

  • NONE: The transaction is waiting to be included in a block.
  • INCLUDED: The transaction is included in a block (the block may not be finalized yet).
  • EXECUTED_OPTIMISTIC: Included in a block, and all non-refund receipts have executed (the blocks may not be finalized yet).
  • INCLUDED_FINAL: The transaction is included in a finalized block.
  • EXECUTED: Included in a finalized block, and all non-refund receipts have executed.
  • FINAL: Included in a finalized block, and all receipts, including refunds, are finalized.
Responses
jsonrpcstring

JSON-RPC version

idstring

Request ID

final_execution_statusstring (enum)

The execution milestone the transaction has reached. Values have the same meaning as the wait_until request parameter.

statusobject

The final execution result of the transaction. On success it contains SuccessValue (the base64-encoded return value, or an empty string if nothing is returned); on failure it contains Failure (an object describing the cause). It is the string NotStarted if the transaction has not yet been converted to a receipt, and Started while execution is in progress.

transactionobject

The signed transaction as submitted.

signer_idstring

NEAR account ID. A human-readable name (e.g. wrap.near) or a 64-character hex implicit account ID.

Example: wrap.near

public_keystring

Base58-encoded public key prefixed with ed25519: or secp256k1:.

Example: ed25519:168vdqFUxij2yvsxYgAGoykJMX7tgrPKVCH484A8nHP

nonceinteger

The nonce of the access key used for signing.

receiver_idstring

NEAR account ID. A human-readable name (e.g. wrap.near) or a 64-character hex implicit account ID.

Example: wrap.near

actionsobject[]

The actions in the transaction. Each item is an object keyed by the action name, or a string such as CreateAccount. The action name is one of CreateAccount, DeployContract, FunctionCall, Transfer, Stake, AddKey, DeleteKey, DeleteAccount, Delegate, DelegateV2, DeployGlobalContract, DeployGlobalContractByAccountId, UseGlobalContract, UseGlobalContractByAccountId, DeterministicStateInit, TransferToGasKey, WithdrawFromGasKey, UniversalStateInit.

priority_feeinteger

Deprecated; retained for backward compatibility.

signaturestring

Transaction signature (base58 with an ed25519: or secp256k1: prefix)

hashstring

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

Example: 8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS

transaction_outcomeobject

The execution outcome of the transaction itself. The transaction is converted to the first receipt, and id is the transaction hash.

idstring

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

Example: 8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS

block_hashstring

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

Example: 8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS

outcomeobject

The execution outcome of the transaction.

executor_idstring

The account ID where execution took place: signer_id for a transaction, the receiver account for a receipt.

gas_burntinteger

The amount of gas burnt by the execution.

tokens_burntstring

The amount of tokens burnt for the gas used (yoctoNEAR, decimal string)

logsstring[]

Logs emitted during execution. NEP standard events are JSON strings prefixed with EVENT_JSON:.

receipt_idsstring[]

IDs of the receipts generated by this execution.

statusobject

Execution status. On success it contains SuccessValue (the base64-encoded return value) or SuccessReceiptId (the ID of the generated receipt); on failure it contains Failure (an object describing the cause). It is the string Unknown when the result is not known.

metadataobject

Versioned execution metadata. Contains version, gas_profile (gas used per cost item), and contracts (version 4 and later: for each action, the contract attached to the receiver account just before the action ran).

proofobject[]

The Merkle path that verifies the outcome against the block's outcome root. Each item has a hash and a direction (Left or Right).

receipts_outcomeobject[]

Execution outcomes of the receipts that followed from the transaction. Each item's id is a receipt ID, and the structure is the same as transaction_outcome.

idstring

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

Example: 8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS

block_hashstring

Base58-encoded 32-byte hash (block hash, chunk hash, transaction hash, etc.).

Example: 8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS

outcomeobject

The execution outcome of the receipt.

executor_idstring

The account ID where execution took place: signer_id for a transaction, the receiver account for a receipt.

gas_burntinteger

The amount of gas burnt by the execution.

tokens_burntstring

The amount of tokens burnt for the gas used (yoctoNEAR, decimal string)

logsstring[]

Logs emitted during execution. NEP standard events are JSON strings prefixed with EVENT_JSON:.

receipt_idsstring[]

IDs of the receipts generated by this execution.

statusobject

Execution status. On success it contains SuccessValue (the base64-encoded return value) or SuccessReceiptId (the ID of the generated receipt); on failure it contains Failure (an object describing the cause). It is the string Unknown when the result is not known.

metadataobject

Versioned execution metadata. Contains version, gas_profile (gas used per cost item), and contracts (version 4 and later: for each action, the contract attached to the receiver account just before the action ran).

proofobject[]

The Merkle path that verifies the outcome against the block's outcome root. Each item has a hash and a direction (Left or Right).

namestring (enum)

Error class. REQUEST_VALIDATION_ERROR (invalid request), HANDLER_ERROR (processing error), INTERNAL_ERROR (node internal error)

causeobject

The specific cause of the error.

namestring

Name of the error cause (e.g. UNKNOWN_BLOCK, UNKNOWN_ACCOUNT, PARSE_ERROR)

infoobject

Additional information about the error (block hash, height, account ID, etc.)

codeinteger

Legacy JSON-RPC error code (e.g. -32000 server error, -32700 parse error, -32601 method not found)

messagestring

Legacy error message

datastring

Legacy error details

X-API-KEY
RequestCU20
cURL
curl -X POST "https://near-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "dontcare",
    "method": "tx",
    "params": {
      "tx_hash": "8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS",
      "sender_account_id": "wrap.near",
      "wait_until": "EXECUTED_OPTIMISTIC"
    }
  }'
Response
Example · 200
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "result": {
    "final_execution_status": "FINAL",
    "status": {
      "SuccessValue": ""
    },
    "transaction": {
      "actions": [
        {
          "Delegate": {
            "delegate_action": {
              "actions": [
                {
                  "FunctionCall": {
                    "args": "eyJjaGFyZ2VfZ2FzX2ZlZSI6dHJ1ZSwic2lnbmF0dXJlIjoiMWY3MWMxMzk5OTFjNGUwMDRmNGNhZWJjMjM4NDIyZTk0MzMzNmQwMGNiNzlhZmNjNDg5M2UzZTE2OWI2OWE3NCIsIm1pbmluZ190aW1lIjoiNDUwMDciLCJtYXhfdHMiOiIxNzkyNDg4ODgyNzM2ODgxOTIwIn0=",
                    "deposit": "0",
                    "gas": 20000000000000,
                    "method_name": "l2_claim"
                  }
                }
              ],
              "max_block_height": 221185293,
              "nonce": 117245306001780,
              "public_key": "ed25519:GxKiWi42sV92ijqade5AoTBo9vUpEWoZKUw8i2BmuwaE",
              "receiver_id": "game.hot.tg",
              "sender_id": "6464297750.tg"
            },
            "signature": "ed25519:5Fhq2Eqa1CUeceTjFGqx1JiD13oGkp1Ag2rkbX2x2asREVbrggjGU4FLbvdziAXAeDaShZ43JV6hXJ7G5nCUT3DZ"
          }
        }
      ],
      "hash": "5VPiJGhxiKsBk8a8W3NyVPTkEG3QY9y5iZ9PsQpAyYE9",
      "nonce": 114560347115868,
      "priority_fee": 0,
      "public_key": "ed25519:68EKbqA3fcSE8upq2bU1EawvURWZJXtTsbw3eK23a2Kf",
      "receiver_id": "6464297750.tg",
      "signature": "ed25519:ncxmj7JgkcToxBxsGXgA22FYz55qSobM8SnEBUiD82pnY5WSQJcHC862S4LC3mdKavyeVVXQWUkk6eNyzQaN8Ee",
      "signer_id": "0here.tg"
    },
    "transaction_outcome": {
      "block_hash": "8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS",
      "id": "5VPiJGhxiKsBk8a8W3NyVPTkEG3QY9y5iZ9PsQpAyYE9",
      "outcome": {
        "executor_id": "0here.tg",
        "gas_burnt": 515831945545,
        "logs": [],
        "metadata": {
          "gas_profile": null,
          "version": 1
        },
        "receipt_ids": [
          "6KSFW1M6phxnbKKHFobw1VwR7tkunuwcU9jvjxfjcVUP"
        ],
        "status": {
          "SuccessReceiptId": "6KSFW1M6phxnbKKHFobw1VwR7tkunuwcU9jvjxfjcVUP"
        },
        "tokens_burnt": "51583194554500000000"
      },
      "proof": []
    },
    "receipts_outcome": [
      {
        "block_hash": "4fGjpzYtgxPsi7Whd3Vbah7kJirmZ6TfDejGnzs9NGda",
        "id": "6KSFW1M6phxnbKKHFobw1VwR7tkunuwcU9jvjxfjcVUP",
        "outcome": {
          "executor_id": "6464297750.tg",
          "gas_burnt": 515831945545,
          "logs": [],
          "metadata": {
            "contracts": [
              null
            ],
            "gas_profile": [],
            "version": 4
          },
          "receipt_ids": [
            "bHrSWTT61x6Ru2HuL3Xo4TjxUsSqXMQcjwdQUJ5uKv1",
            "Ca5j3AHwiDTdm3XP6CACfz9LzDBSBWdrKV8Vgkxm5KfY"
          ],
          "status": {
            "SuccessValue": ""
          },
          "tokens_burnt": "51583194554500000000"
        },
        "proof": []
      },
      {
        "block_hash": "H8B9qExvsic8bjkfqdAAbuYDqmxL4MGSmRqBU6RPdZLF",
        "id": "bHrSWTT61x6Ru2HuL3Xo4TjxUsSqXMQcjwdQUJ5uKv1",
        "outcome": {
          "executor_id": "game.hot.tg",
          "gas_burnt": 3056367183878,
          "logs": [
            "EVENT_JSON:{\"standard\":\"nep141\",\"version\":\"1.0.0\",\"event\":\"ft_mint\",\"data\":[{\"owner_id\":\"game.hot.tg\",\"amount\":\"22503\",\"memo\":\"Gas fee for claim\"}]}",
            "L2 claim 496938482509560, earned: 22503"
          ],
          "metadata": {
            "contracts": [
              {
                "local": "GH7Zs8zab1YHiTkdveDj18Uu2je6fpiXcHmXkqYNCuew"
              }
            ],
            "gas_profile": [
              {
                "cost": "BASE",
                "cost_category": "WASM_HOST_COST",
                "gas_used": "21181448880"
              },
              {
                "cost": "CONTRACT_LOADING_BASE",
                "cost_category": "WASM_HOST_COST",
                "gas_used": "35445963"
              }
            ],
            "version": 4
          },
          "receipt_ids": [
            "2PMoU3sXmsjgUHrh8HoBo7PZmDUJUGoD8j68CzVCR9Si"
          ],
          "status": {
            "SuccessValue": ""
          },
          "tokens_burnt": "305636718387800000000"
        },
        "proof": [
          {
            "direction": "Right",
            "hash": "4gEhQVdr1xbfcof2Ps3gwPjPFrMfD9fwdjkc2UedxJJk"
          }
        ]
      }
    ]
  }
}

Last updated