Pending

PreviousParams NextSimulate

Get a list of unconfirmed transactions currently in the transaction pool.

Get the list of pending transactions, sorted by priority, in decreasing order, truncated at the end at MAX. If MAX = 0, returns all pending transactions.

get

/v2/transactions/pending

Authorizations

Query parameters

maxinteger

Truncated number of transactions to display. If max=0, returns all pending txns.

formatstring · enum

Configures whether the response object is JSON or MessagePack encoded. If not provided, defaults to JSON.

Options: json, msgpack

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://algo.nownodes.io/v2/transactions/pending' \
  --header 'X-Algo-API-Token: YOUR_API_KEY'

200

401

500

503

default

application/json

application/msgpack

{
  "top-transactions": [
    {}
  ],
  "total-transactions": 1
}

A potentially truncated list of transactions currently in the node's transaction pool. You can compute whether or not the list is truncated if the number of elements in the top-transactions array is fewer than total-transactions.

Get a specific pending transaction.

Given a transaction ID of a recently submitted transaction, it returns information about it. There are several cases when this might succeed:

transaction committed (committed round > 0)
transaction still in the pool (committed round = 0, pool error = "")
transaction removed from pool due to error (committed round = 0, pool error != "") Or the transaction may have happened sufficiently long ago that the node no longer remembers it, and this will return an error.

get

/v2/transactions/pending/{txid}

Authorizations

Path parameters

txidstringrequired

A transaction ID

Pattern: [A-Z0-9]+

Query parameters

formatstring · enum

Configures whether the response object is JSON or MessagePack encoded. If not provided, defaults to JSON.

Options: json, msgpack

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://algo.nownodes.io/v2/transactions/pending/{txid}' \
  --header 'X-Algo-API-Token: YOUR_API_KEY'

200

400

401

404

default

application/json

application/msgpack

{
  "application-index": 1,
  "asset-closing-amount": 1,
  "asset-index": 1,
  "close-rewards": 1,
  "closing-amount": 1,
  "confirmed-round": 1,
  "global-state-delta": [
    {
      "key": "text",
      "value": {
        "action": 1,
        "bytes": "text",
        "uint": 1
      }
    }
  ],
  "inner-txns": [
    {
      "application-index": 1,
      "asset-closing-amount": 1,
      "asset-index": 1,
      "close-rewards": 1,
      "closing-amount": 1,
      "confirmed-round": 1,
      "global-state-delta": [
        {
          "key": "text",
          "value": {
            "action": 1,
            "bytes": "text",
            "uint": 1
          }
        }
      ],
      "inner-txns": "[Circular Reference]",
      "local-state-delta": [
        {
          "address": "text",
          "delta": [
            {
              "key": "text",
              "value": {
                "action": 1,
                "bytes": "text",
                "uint": 1
              }
            }
          ]
        }
      ],
      "logs": [
        "text"
      ],
      "pool-error": "text",
      "receiver-rewards": 1,
      "sender-rewards": 1,
      "txn": {}
    }
  ],
  "local-state-delta": [
    {
      "address": "text",
      "delta": [
        {
          "key": "text",
          "value": {
            "action": 1,
            "bytes": "text",
            "uint": 1
          }
        }
      ]
    }
  ],
  "logs": [
    "text"
  ],
  "pool-error": "text",
  "receiver-rewards": 1,
  "sender-rewards": 1,
  "txn": {}
}

Given a transaction ID of a recently submitted transaction, it returns information about it. There are several cases when this might succeed:

transaction committed (committed round > 0)
transaction still in the pool (committed round = 0, pool error = "")
transaction removed from pool due to error (committed round = 0, pool error != "")

Or the transaction may have happened sufficiently long ago that the node no longer remembers it, and this will return an error.