Pending

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

get

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.

Authorizations

Query parameters

maxintegerOptional

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

formatstring · enumOptional

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

Possible values:

Responses

200

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**.

401

Invalid API Token

500

Internal Error

503

Service Temporarily Unavailable

default

Unknown Error

get

GET /v2/transactions/pending HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Accept: */*

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

Get a specific pending transaction.

get

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.

Authorizations

Path parameters

txidstringRequired

A transaction ID

Pattern: [A-Z0-9]+

Query parameters

formatstring · enumOptional

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

Possible values:

Responses

200

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.

400

Bad Request

401

Invalid API Token

404

Transaction Not Found

default

Unknown Error

get

GET /v2/transactions/pending/{txid} HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Accept: */*

{
  "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": [
        {
          "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": [
            "Ynl0ZXM="
          ],
          "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": [
        "Ynl0ZXM="
      ],
      "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": [
    "Ynl0ZXM="
  ],
  "pool-error": "text",
  "receiver-rewards": 1,
  "sender-rewards": 1,
  "txn": {}
}